dsh-openclaw-acp

English

这是一个原生 DeepSeek Harness 组合包，通过官方 Agent Client Protocol（ACP）传输，让 OpenClaw 调用 Harness profile。

本集成刻意把责任拆成三层：

1. DeepSeek Harness 负责 Agent、模型、工具、工作区沙箱和会话日志。
2. OpenClaw ACPX 负责 ACP 进程生命周期、调度与对话路由。
3. OpenClaw 渠道插件负责微信或其他消息通道。

本包不嵌入微信 SDK，也不复制 Harness。它以 dsh.bundle 安装，并加载 DeepSeek 官方 @deepseek-ai/dsh-acp 插件。

前置条件

• Node.js 22 或更高版本
• DeepSeek Harness 0.1.0-rc.6
• 已安装官方 @openclaw/acpx 插件的 OpenClaw
• OpenClaw Gateway 进程可以读取 DEEPSEEK_API_KEY
• 已配置一个 OpenClaw 渠道，例如腾讯 @tencent-weixin/openclaw-weixin

1. 安装 Harness 组合包

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh plugin --profile openclaw add github:BeAChanger/dsh-openclaw-acp#v0.1.2
dsh --profile openclaw --dump-config

默认路由是 deepseek-official/deepseek-v4-flash，启用 thinking，推理强度为 max，上下文窗口为 1,000,000 token，输出上限为 384,000 token。如需覆盖模型，在 Gateway 环境中设置：

export DSH_OPENCLAW_PROVIDER=deepseek-official
export DSH_OPENCLAW_MODEL=deepseek-v4-pro

2. 在 OpenClaw 注册 Harness

安装并启用 OpenClaw 官方 ACP runtime：

openclaw plugins install @openclaw/acpx
openclaw config set plugins.entries.acpx.enabled true

把以下内容加入 OpenClaw 配置：

{
  acp: {
    enabled: true,
    backend: "acpx",
    defaultAgent: "deepseek-harness",
    allowedAgents: ["deepseek-harness"]
  },
  plugins: {
    entries: {
      acpx: {
        enabled: true,
        config: {
          agents: {
            "deepseek-harness": {
              command: "dsh",
              args: ["--profile", "openclaw"]
            }
          }
        }
      }
    }
  }
}

重启 Gateway。先验证协议边界，再测试具体渠道：

/acp doctor
/acp spawn deepseek-harness --cwd /工作区绝对路径

如果渠道支持当前对话绑定，可以加 --bind here。如果渠道没有声明 ACP 对话绑定能力，就使用不绑定的一次性任务，让 OpenClaw 把完成结果回传给父对话。

3. 从微信调用

微信渠道接入同一个 Gateway 后，消息链路是：

微信 -> OpenClaw 渠道 -> ACPX -> dsh --profile openclaw -> DeepSeek Harness