acp

运行与 Moltbot 网关通信的 ACP（Agent Client Protocol）桥接。该命令通过 stdio 使用 ACP 协议，并通过 WebSocket 将提示转发到网关。它将 ACP 会话映射到网关会话键。

用法


moltbot acp

# 远程网关
moltbot acp --url wss://gateway-host:18789 --token <token>

# 附加到现有会话键
moltbot acp --session agent:main:main

# 按标签附加（必须已存在）
moltbot acp --session-label "support inbox"

# 首次提示前重置会话键
moltbot acp --session agent:main:main --reset-session

ACP 客户端（调试）

使用内置 ACP 客户端在无 IDE 的情况下检查桥接。它会生成 ACP 桥接并让你交互式输入提示。


moltbot acp client

# 将生成的桥接指向远程网关
moltbot acp client --server-args --url wss://gateway-host:18789 --token <token>

# 覆盖服务器命令（默认：moltbot）
moltbot acp client --server "node" --server-args moltbot.mjs acp --url ws://127.0.0.1:19001

如何使用

当 IDE（或其他客户端）使用 Agent Client Protocol 且你希望它驱动 Moltbot 网关会话时使用 ACP。

确保网关正在运行（本地或远程）。
配置网关目标（配置或标志）。
将 IDE 指向通过 stdio 运行 moltbot acp。

示例配置（持久化）：


moltbot config set gateway.remote.url wss://gateway-host:18789
moltbot config set gateway.remote.token <token>

示例直接运行（不写入配置）：


moltbot acp --url wss://gateway-host:18789 --token <token>

选择代理

ACP 不直接选择代理，而是通过网关会话键路由。使用代理作用域会话键指定特定代理：


moltbot acp --session agent:main:main
moltbot acp --session agent:design:main
moltbot acp --session agent:qa:bug-123

每个 ACP 会话映射到单一网关会话键。一个代理可有多个会话；除非覆盖键或标签，否则 ACP 默认使用隔离的 acp:<uuid> 会话。

Zed 编辑器设置

在 ~/.config/zed/settings.json 中添加自定义 ACP 代理（或使用 Zed 的 Settings UI）：


{
  "agent_servers": {
    "Moltbot ACP": {
      "type": "custom",
      "command": "moltbot",
      "args": ["acp"],
      "env": {}
    }
  }
}

要指定特定网关或代理：


{
  "agent_servers": {
    "Moltbot ACP": {
      "type": "custom",
      "command": "moltbot",
      "args": [
        "acp",
        "--url", "wss://gateway-host:18789",
        "--token", "<token>",
        "--session", "agent:design:main"
      ],
      "env": {}
    }
  }
}

在 Zed 中打开 Agent 面板并选择”Moltbot ACP”以启动线程。

会话映射

默认 ACP 会话获得带 acp: 前缀的隔离网关会话键。要复用已知会话，传入会话键或标签：

--session <key>：使用特定网关会话键。
--session-label <label>：按标签解析现有会话。
--reset-session：为该键生成新会话 id（同键，新转录）。

若 ACP 客户端支持元数据，可按会话覆盖：


{
  "_meta": {
    "sessionKey": "agent:main:main",
    "sessionLabel": "support inbox",
    "resetSession": true
  }
}

会话键详见会话概念。

选项

--url <url>：网关 WebSocket URL（配置时默认为 gateway.remote.url）。
--token <token>：网关认证 token。
--password <password>：网关认证密码。
--session <key>：默认会话键。
--session-label <label>：要解析的默认会话标签。
--require-existing：若会话键/标签不存在则失败。
--reset-session：首次使用前重置会话键。
--no-prefix-cwd：不在提示前加工作目录前缀。
--verbose, -v：详细日志到 stderr。

`acp client` 选项

--cwd <dir>：ACP 会话的工作目录。
--server <command>：ACP 服务器命令（默认：moltbot）。
--server-args <args...>：传给 ACP 服务器的额外参数。
--server-verbose：在 ACP 服务器上启用详细日志。
--verbose, -v：详细客户端日志。

acp

用法