Octop v0.9.20不直接管理ACP专家,而是通过MCP Connector间接协同OpenClaw等支持ACP的后端服务;需手动部署OpenClaw+acpx网关桥接,再由Octop Agent调用其工具能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop 本身不直接实现 ACP(Agent Client Protocol)协议栈,也不内置 ACP 服务端;它通过 Connector 架构 和 可插拔运行时 支持与符合 ACP 规范的外部 Agent(如 Hermes、OpenClaw ACP 桥接器)协同工作。所谓“ACP 双向集成”,实际是指在 Octop 中建立一条双向通信链路:一端接入 ACP 客户端(如 Zed/VS Code 插件或 CLI 工具),另一端由 Octop 的 harness-agent 或 gateway 层完成协议适配与会话路由。
确认 ACP 兼容代理已就绪
Octop 不提供 ACP server 功能,需先部署一个支持 ACP 的网关或桥接器(例如 OpenClaw Gateway + openclaw acp 子命令)。该组件必须:
- 监听 WebSocket 或 stdio 通道,接受 ACP 标准 JSON-RPC 请求(如
session/new、session/prompt) - 能将 ACP 会话映射为可被 Octop 识别的上下文(通常通过
sessionId或session-label关联) - 支持流式响应(
delta、done等事件)并维持长连接
配置 Octop Connector 接入 ACP 流量
Octop 使用 harness-gateway 统一归一化输入源。要让 ACP 流量进入 Octop 处理管线,需添加自定义 Connector:
适配 HKUDS CLI-Anything 至 OpenClaw 工作流,用于为 GUI 应用构建、优化、测试或验证智能体原生 CLI 封装。
- 在
/opt/octop/config/connectors.yaml中新增一项,类型设为custom - 指定入口命令(例如:
bash -c "openclaw acp --token-file /etc/octop/acp.token") - 设置环境变量
OPENCLAW_GATEWAY_URL=wss://your-gateway:18789,指向运行中的 OpenClaw ACP 网关 - 启用
auto_session_bind: true,使 Octop 自动将传入的 ACPsessionId绑定到本地harness-agent实例
打通会话生命周期与权限隔离
Octop 的多用户模型要求 ACP 会话不能全局共享。关键配置点包括:
- 在
auth.yaml中启用isolation_mode: user_context,确保每个用户的 ACP 会话仅访问其专属工作区和记忆 - 为 ACP 调用方(如 IDE 插件)注入用户标识,方式有二:
– 通过 HTTP Header(若经网关转发)传递X-Octop-User-ID
– 或在 ACP 初始化参数中显式携带"user_id": "alice" - 在
agent.yaml中配置session_timeout: 300,与 ACP 心跳(如heartbeatInterval=25)协同,避免因超时导致会话错位
验证双向能力是否生效
完成配置后,可通过以下方式验证:
- 启动 Octop 并观察日志中是否出现
connector.acp: connected和session bound to user=alice - 使用 Zed 编辑器加载 ACP 插件,执行
agent:design:main会话,检查能否收到 Octop 返回的工具调用建议(如“读取腾讯文档”) - 在 Octop Web 控制台的「会话监控」页,确认该 ACP 会话显示为 active,并关联正确 memory workspace 和 connector ID

















