acp

这个 acp 命令是一个小帮手，它负责在你的编程软件（我们叫它“客户端”）和 OpenClaw Gateway（我们叫它“网关”，就像一个聪明的大脑）之间传递消息。它就像一个翻译官，确保两边能听懂对方的话。

怎么使用它呢？ 当你的编程软件支持一种叫 ACP 的对话方式，并且你想让它和网关大脑聊天时，就可以用它。

1. 第一步：确保网关大脑在运行。 它可以在你自己的电脑上，也可以在另一台电脑上。
2. 第二步：告诉 acp 小帮手去哪里找网关大脑。 你可以用两种方法告诉它地址和密码。
   • 方法一（记下来）： 用 openclaw config set 命令把地址和密码存起来，以后就不用每次都输入了。
   • 方法二（直接说）： 在启动 acp 时直接告诉它。比如 openclaw acp --url wss://gateway-host:18789 --token <你的密码>。这里要小心，直接把密码写在命令里可能会被别人看到，更安全的方法是把密码写在一个文件里，然后用 --token-file ~/.openclaw/gateway.token 来告诉它密码文件在哪。
3. 第三步：告诉你的编程软件去运行 openclaw acp 这个命令。 这样它们就能连接上了。

怎么选择不同的“小助手”（Agent）？ acp 自己不直接选择小助手，它通过一个叫“会话密钥”的东西来找到对应的小助手。你可以用 --session 选项来指定要找哪个小助手，比如 agent:main:main 就是找名叫“main”的小助手。

怎么在 Zed 编辑器里设置？ 如果你用 Zed 编辑器，可以这样设置：

1. 打开 Zed 的设置文件（~/.config/zed/settings.json）或者用设置界面。
2. 添加一段像下面这样的配置，告诉 Zed 去运行 openclaw acp 这个命令。
3. 如果你想指定远程的网关或特定小助手，可以在 args 里加上 --url、--token 和 --session 这些选项。 设置好后，在 Zed 里打开“助手”面板，选择“OpenClaw ACP”就可以开始聊天了。

关于会话的小知识 默认情况下，每次通过 acp 聊天都会创建一个新的、独立的会话。如果你想继续之前的某次聊天，可以用这些方法：

• --session <密钥>：使用一个特定的会话密钥。
• --session-label <标签>：用一个好记的标签（比如“支持收件箱”）来找到之前的会话。
• --reset-session：用同一个密钥，但是开始一次全新的聊天记录。

一些重要的选项和提醒 启动 acp 时可以用很多选项：

• --url：网关大脑的地址。
• --token / --token-file：密码。要小心，用 --token 把密码直接写在命令里可能不安全，更推荐用 --token-file 从文件读取。
• --session：指定会话密钥。
• --session-label：指定会话标签。
• --reset-session：重置会话。

用来测试的“客户端”模式 还有一个 openclaw acp client 命令，它就像一个测试模式。你不用打开编程软件，直接在你的电脑终端里输入，就能测试 acp 小帮手和网关大脑能不能正常工作。你可以用它来试试连接和发送消息。