前言¶

在 DSH 生態裏，插件可以擴展 DeepSeek Harness 的能力，但有些場景需要把一個已有的 Harness profile 接到外部 ACP 運行時。dsh-openclaw-acp 面向這種場景：它不重複實現 Harness，也不嵌入 WeChat SDK，而是通過官方 Agent Client Protocol (ACP) transport，把 Harness profile 暴露給 OpenClaw，再由 OpenClaw channel 插件承接 WeChat 等消息 transport。

下面介紹它的定位、核心能力、安裝啓用步驟、模型覆蓋方式、安全默認和已知限制。

這是什麼¶

dsh-openclaw-acp 是一個 DeepSeek Harness bundle，用於把一個 Harness profile 暴露爲 OpenClaw-compatible ACP agent。

• 名稱：dsh-openclaw-acp
• 維護者：BeAChanger
• 許可證：MIT
• 安裝形態：以 dsh.bundle 安裝，並掛載官方 @deepseek-ai/dsh-acp 插件
• 集成方式：通過官方 Agent Client Protocol (ACP) transport 向 OpenClaw 暴露 Harness profile
• 邊界：不嵌入 WeChat SDK，也不重複 Harness

核心能力¶

下面列出已覈實的能力點：

• 原生 DeepSeek Harness bundle，通過官方 ACP transport 向 OpenClaw 暴露 Harness profile。
• 以 dsh.bundle 安裝，並掛載官方 @deepseek-ai/dsh-acp 插件。
• 不嵌入 WeChat SDK，也不重複 Harness。
• 默認路由爲 deepseek-official/deepseek-v4-flash，thinking enabled、max reasoning effort、1,000,000-token context window、384,000-token output cap。
• 可通過 OpenClaw ACPX 註冊爲 agent，並經由 OpenClaw channel 支持 WeChat 等消息 transport。
• 支持多個已登錄 WeChat 賬號下，按 account、channel、sender 隔離 direct-message sessions。

前置條件¶

安裝前需要滿足以下條件：

• pnpm 10 和 OpenClaw 支持的 Node.js 版本；stable OpenClaw 2026.7.1-2 要求 Node.js 22.22.3+、24.15.0+ 或 25.9.0+。
• DeepSeek Harness 0.1.0-rc.6。
• OpenClaw 2026.7.1-2 或更新版本，並使用官方 @openclaw/acpx 插件。
• OpenClaw Gateway 進程可以讀取 DEEPSEEK_API_KEY。
• 已配置可用的 OpenClaw channel，例如 Tencent 的 @tencent-weixin/openclaw-weixin。

安裝與啓用¶

1. 安裝 DSH 與 bundle¶

先安裝 DeepSeek Harness，再添加 dsh-openclaw-acp bundle，最後查看 openclaw profile 配置。

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh plugin --profile openclaw add https://github.com/BeAChanger/dsh-openclaw-acp/releases/download/v0.1.3/dsh-openclaw-acp-0.1.3.tgz
dsh --profile openclaw --dump-config

安裝命令使用預構建 release artifact，安裝過程不執行 repository build。release 頁面發佈 SHA-256 checksum asset。

2. 註冊 OpenClaw ACPX¶

啓用 OpenClaw 的 ACPX 運行時。

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

3. 接入 WeChat channel¶

以 Tencent 的 openclaw-weixin 插件爲例，安裝、啓用並完成 channel 登錄。

openclaw plugins install @tencent-weixin/openclaw-weixin@2.4.6
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw channels login --channel openclaw-weixin

4. 重啓 Gateway 並驗證 ACP 邊界¶

完成 channel 接入後，先驗證 ACP 邊界，再測試消息 channel。

/acp doctor
/acp spawn deepseek-harness --cwd /absolute/path/to/workspace

/acp spawn 需要顯式指定 workspace 路徑；這裏使用絕對路徑佔位。

5. 多 WeChat 賬號會話隔離¶

如果同時登錄多個 WeChat 賬號，可按 account、channel、sender 隔離 direct-message sessions。

openclaw config set session.dmScope per-account-channel-peer

覆蓋默認模型¶

默認路由爲 deepseek-official/deepseek-v4-flash，thinking enabled、max reasoning effort、1,000,000-token context window、384,000-token output cap。

如果需要在 Gateway 環境中覆蓋 provider 或 model，可以設置：

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

安全默認¶

部署時建議保持最小權限，並顯式檢查邊界：

• OpenClaw 的 sandbox 不包裹外部 ACP 進程；Harness 通過 DSH_PERMISSION_MODE 執行自己的邊界控制。
• 保持 Harness 默認 workspace-write 模式，除非部署明確需要更高權限。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證（MIT），並限制允許的 workspace roots。
• 不要爲該目標啓用 OpenClaw 的 ACPX MCP tool bridges。Harness ACP 0.1.0-rc.6 會拒絕非空 mcpServers。
• 將 Gateway 和 Harness 運行在專用 OS account 下，並限制允許的 workspace roots。
• danger-full-access 只能作爲 break-glass 模式，不應作爲生產默認。
• OpenClaw plugin tools 不會被注入 Harness，因爲當前 Harness ACP transport 拒絕非空 mcpServers。

已知限制¶

當前版本有以下限制：

• Harness ACP 目前只支持 new sessions；不 advertise load、resume、fork 或 session listing。
• 返回的是 committed assistant text，不包含 live reasoning 或 tool events。
• Channel-level persistent binding 依賴 OpenClaw channel adapter；在 channel 不支持 binding 時，使用 one-shot parent relay。

驗證命令¶

可以在本地執行以下命令做基礎驗證：

npm install
npm test
npm run test:acp
npm run pack:check

結尾¶

dsh-openclaw-acp 的價值在於保持分工：DeepSeek Harness 負責 profile、模型、工具與邊界；OpenClaw ACPX 負責 ACP 運行時與路由；OpenClaw channel 負責 WeChat 等消息 transport。插件本身不嵌入 WeChat SDK，也不重複 Harness。

GitHub 倉庫：https://github.com/BeAChanger/dsh-openclaw-acp。

目錄頁線索：插件名爲 dsh-openclaw-acp，倉庫路徑爲 BeAChanger/dsh-openclaw-acp；本文不引用未覈實的目錄 URL。