openclaw acp

ACP（Agent Client Protocol）桥接命令，将 IDE 或 ACP 客户端的请求转发到 OpenClaw Gateway。

核心概念

openclaw acp 让 OpenClaw 作为 ACP 服务端，接受 IDE 连接，并将工作路由到 Gateway session。

与 cli-clawbot 不同，这是 IDE 驱动 OpenClaw 的入口，而非 OpenClaw 驱动外部 Agent。

区分两种场景：

IDE/客户端想通过 ACP 连接 OpenClaw → 用 openclaw acp
OpenClaw 要启动 Codex/Claude 作为 ACP harness → 用 /acp spawn

基本用法

# 本地 Gateway
openclaw acp
 
# 远程 Gateway
openclaw acp --url wss://gateway-host:18789 --token <token>
 
# 从文件读取 token（推荐，避免进程列表泄露）
openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token
 
# 绑定到已有 session
openclaw acp --session agent:main:main
 
# 按 label 绑定
openclaw acp --session-label "support inbox"

主要选项

选项	说明
`--url <url>`	Gateway WebSocket URL
`--token <token>`	Gateway auth token（不推荐，可见于进程列表）
`--token-file <path>`	从文件读取 token（推荐）
`--session <key>`	默认 session key
`--session-label <label>`	按 label 解析 session
`--reset-session`	重置 session（同 key，新 transcript）
`--verbose, -v`	详细日志输出到 stderr

Session 映射

默认每个 ACP session 获得独立的 acp:<uuid> Gateway session key。

# 指向特定 agent
openclaw acp --session agent:main:main
openclaw acp --session agent:design:main

Zed 编辑器配置

{
  "agent_servers": {
    "OpenClaw ACP": {
      "type": "custom",
      "command": "openclaw",
      "args": ["acp"],
      "env": {}
    }
  }
}

调试客户端

# 内置 ACP 客户端，用于验证桥接
openclaw acp client
 
# 指向远程 Gateway
openclaw acp client --server-args --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

兼容性矩阵（关键项）

功能	状态
`initialize`, `newSession`, `prompt`, `cancel`	已实现
`resumeSession`, `closeSession`	已实现
`loadSession`	部分支持
每 session MCP servers	不支持
客户端文件系统方法	不支持

安全注意

优先使用 --token-file 或环境变量 OPENCLAW_GATEWAY_TOKEN，避免 token 出现在进程列表
本地模式：env → gateway.auth.* → gateway.remote.* 回退

Wiki AI

目录

CLI - acp（ACP 桥接）