OpenClaw ACP - Bridge CLI giúp Claude Code và Codex (app + CLI) kết nối mượt mà với AI Agent siêu nhẹ và mạnh

Hello anh em

Gần đây mình chuyển sang dùng OpenClaw làm gateway chính và phát hiện ra OpenClaw ACP là một “vũ khí bí mật” cực kỳ tiện lợi. Không phải full runtime nặng nề, mà chỉ là một bridge nhẹ giữa Agent Client Protocol (ACP) và OpenClaw Gateway.

Mình share bài này để anh em nào đang build agent, dùng Claude Code với Antigravity, Codex app hay Codex CLI thì dễ dàng triển khai. Toàn bộ thông tin lấy trực tiếp từ docs chính thức , mình đã test trên cả local và remote gateway rồi.

OpenClaw ACP thực chất làm gì?

Nói đơn giản: khi Claude Code hoặc Codex (app/CLI) nói chuyện bằng ngôn ngữ ACP (qua stdio), thì OpenClaw ACP sẽ nhận lệnh đó, map session rồi forward prompt qua WebSocket đến Gateway. Gateway mới là nơi xử lý thật sự (tool calls, memory, MCP servers, routing…).

Ưu điểm lớn nhất:

• Siêu nhẹ, không cần chạy full editor native
• Hỗ trợ cả local gateway lẫn remote (qua URL + token)
• Session mapping 1:1, dễ quản lý
• Không hỗ trợ per-session MCP servers (đây là điểm quan trọng, mình sẽ nói sau)

Cách cài đặt chỉ mất 30 giây

Anh em chỉ cần chạy một lệnh duy nhất (cho ae nào chưa cài OpenClaw):

curl -fsSL https://openclaw.ai/install.sh | bash

Sau đó onboard gateway:

openclaw onboard --install-daemon

Kiểm tra nhanh:

openclaw --version
openclaw gateway status

Nếu đã có npm thì đơn giản hơn:

npm install -g openclaw@latest

Xong. Gateway chạy ngầm như service (systemd hoặc launchd).

Lệnh chính: openclaw acp và các tham số hay dùng

Lệnh cốt lõi:

openclaw acp

Các flag mình hay dùng nhất (copy-paste luôn cho tiện):

• Kết nối gateway:

openclaw acp --url wss://localhost:18789 --token-file ~/.openclaw/gateway.token

• Gắn vào session cụ thể:

openclaw acp --session agent:main:main
openclaw acp --session-label "claude-main"

• Reset transcript nhưng giữ session key:

openclaw acp --session agent:main:main --reset-session

• Debug mode (test nhanh không cần app):

openclaw acp client

Mình khuyên anh em luôn dùng --token-file hoặc biến môi trường OPENCLAW_GATEWAY_TOKEN để tránh lộ token trong process list. Đừng dùng --token trực tiếp trên command line.

Tích hợp với Claude Code & Codex

Cách chuẩn nhất: Dùng acpx làm cầu nối

Đầu tiên tạo session:

acpx openclaw sessions ensure --name claude-bridge

Sau đó chạy Claude Code / Codex CLI qua acpx:

acpx openclaw -s claude-bridge "Hỏi agent OpenClaw về context repo này"

Config vĩnh viễn trong ~/.acpx/config.json:

{
  "agents": {
    "openclaw": {
      "command": "env OPENCLAW_HIDE_BANNER=1 openclaw acp --url wss://localhost:18789 --token-file ~/.openclaw/gateway.token --session agent:main:main"
    }
  }
}

Sau đó chỉ cần:

acpx openclaw "Làm giúp mình task XYZ"

Claude Code (với Antigravity qua CCS) và Codex app/CLI đều chạy mượt qua acpx + OpenClaw ACP. Không còn proxy thủ công, session map 1:1, MCP tập trung. Mình port từ ClaudeKit qua chỉ mất 2 phút là xong.

Lưu ý quan trọng về MCP servers

Đây là điểm nhiều anh em hay gặp lỗi: OpenClaw ACP không hỗ trợ per-session mcpServers. Nếu gửi thì sẽ báo lỗi rõ ràng.

Cách đúng là cấu hình MCP tập trung ở mức Gateway hoặc Agent (qua config hoặc lệnh openclaw config). Làm vậy thì Claude Code, Codex app và CLI đều dùng chung một bộ tool, permission và scaling dễ quản lý hơn nhiều.

Mẹo nhỏ mình hay dùng

• --require-existing để tránh tạo session mới vô ý
• OPENCLAW_HIDE_BANNER=1 cho output sạch
• --verbose khi debug
• Dùng --reset-session khi muốn “làm mới” transcript nhưng giữ session label

Mình đang dùng OpenClaw ACP + Claude Code + Codex app/CLI làm workflow chính: agent tự edit code, chạy test, commit, thậm chí kết nối multi-session (dev + qa + support). Tốc độ nhanh, bảo mật cao, và đặc biệt là không còn phải lo proxy thủ công nữa.

Anh em nào đang build agentic system với Claude Code hoặc Codex thì nên thử ngay. Chỉ mất 5 phút cài đặt là thấy khác biệt.