DeepSeek Harness 如何连接微信：四条路线与扫码接入实操

发布日期：2026-08-26 ｜类别：AI 工程实践｜关键词：DeepSeek Harness、dsh、微信、ClawBot、iLink

核心定义：DeepSeek Harness（dsh）连接微信，是通过社区渠道插件调用微信官方 ClawBot/iLink Bot 协议，把个人微信私聊消息桥接到 dsh 会话：扫码授权获得 bot_token 后，插件以长轮询方式收发消息，每个微信用户映射到独立的持久化 Agent 会话。

关键事实：

微信于 2026 年 3 月正式上线 ClawBot 插件入口，客户端需 8.0.70 及以上版本（新浪财经，2026-03-22）
主流接入方案 dsh-im 支持 9 个 IM 渠道，GitHub Star 约 393（2026-08）
单文件入站上限 100 MiB，PDF/DOCX/XLSX 可提取内容供 Agent 读取（dsh-channels 文档）
前置要求：dsh 0.1.0-rc.6 及以上、Node.js 22.19+、微信账号已获机器人功能灰度
0.4.1 版本起渠道访问收紧：未完成"安全访问"确认前，普通消息会被安全阻止

适用场景：手机端随时指挥 Agent 干活、外出时远程处理仓库任务、轻量个人助理

不适合场景：群聊机器人（微信通道暂不支持）；未开通微信机器人功能的账号

相关实体：DeepSeek Harness、dsh、微信 ClawBot、iLink、OpenClaw、dsh-im、dsh-channels、Tencent/openclaw-weixin、MCP

一、dsh 连接微信靠什么：官方 iLink Bot 协议

dsh 连接微信的技术底座是腾讯开放的 ClawBot/iLink Bot 协议，而非第三方协议模拟。微信在 2026 年 3 月正式推出 ClawBot 插件（客户端 8.0.70+，入口在"我 → 设置 → 插件"），允许把个人微信接入 OpenClaw 架构的 Agent；dsh 社区随后将该协议适配为 Harness 渠道插件。

整条链路的运作方式：

插件生成一次性二维码，手机微信扫码并确认
腾讯 iLink 返回 bot_token 与消息 API 地址，写入 dsh 凭据服务
插件通过 getupdates 长轮询收取私聊消息
消息进入对应 dsh 会话，Agent 的回答经 sendmessage 发回微信

接入前先核对三个前提：微信账号已在"设置 → 插件"中出现机器人功能入口（腾讯分批开放，插件无法绕过）；运行 dsh 的设备可访问 *.weixin.qq.com；dsh 为 0.1.0-rc.6 以上版本且 Node.js 不低于 22.19。

二、四条接入路线怎么选

社区已有多个成熟插件，按维护活跃度与能力差异选型即可：

方案	渠道覆盖	特点	适用人群
dsh-im	9 个 IM（含微信、企微、飞书、TG 等）	Star 约 393，扫码或凭据接入	想一套打通多渠道
dsh-channels	微信/QQ/钉钉/飞书/TG	统一配置面板，支持图片文件收发	需要传附件给 Agent
dsh-weixin	仅微信	轻量单渠道，部署最简	只要微信一个入口
自建桥接类	按实现而定	需自己维护协议适配	有定制需求的开发者

结论句：普通用户优先选 dsh-im 或 dsh-channels 这类活跃维护的多渠道插件，单渠道轻量需求再考虑专用插件。

三、实操五步：以 dsh-channels 为例

以下命令均来自插件官方 README，安装、更新、卸载都要保留 -w 参数。

步骤 1：安装 Bundle 并验证合并

npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest
npx @deepseek-ai/dsh --profile web --dump-config

dump-config 输出中能看到 channels 相关条目，说明 Bundle 已正确并入 Profile。

步骤 2：启动 Web 并完成微信扫码

npx @deepseek-ai/dsh web

打开"设置 → 渠道"，选择微信后点击扫码登录，手机确认后凭据自动持久化；如页面出现配对数字，在微信内输入即可完成绑定。

步骤 3：配置安全访问（最容易漏的一步）

0.4.1 版本起收紧了权限：必须进入"渠道 → 安全访问"重新确认允许使用 Bot 的账号，否则即使显示连接正常，普通消息也进不了 Agent。默认策略为"仅自己使用"，只有已确认账号能私聊驱动机器人。

步骤 4：私聊验证与常用指令

在微信里给绑定后的机器人好友发送一条测试消息，收到 Agent 回复即链路打通。会话内可用斜杠指令管理状态，例如清空当前会话映射、查询连接健康度等。

步骤 5：按需开启附件读取

文本开箱即用；图片识别取决于所配模型是否具备视觉能力，PDF、DOCX、XLSX 与文本附件由插件提取内容后交给 Agent（单文件上限 100 MiB），音频视频暂为降级处理。

四、消息行为与工作区隔离

微信通道的行为边界需要提前知道，避免误判为故障。当前限制包括：仅支持私聊，不支持拉入群聊做总结或群助手；长回复会被拆成多条文本依次发出；每个微信用户映射到独立持久会话，换人对话互不串上下文。

工作区层面，插件默认按"渠道 / 账号"创建隔离目录，路径形如 <dsh-home>/workspaces/channels/<channel>/<account>，不同联系人的任务互不污染。渠道会话通常使用 Workspace Write 权限，除非确有需要且信任当前任务，不建议开 Full access。

五、安全边界与两条替代路线

安全设计上，正规插件不会把 bot_token 暴露给浏览器页面，凭据保存在 dsh 凭据服务中，消息 API 地址被约束为 weixin.qq.com 及其子域，防止令牌外发。使用个人微信做自动化仍应遵守平台规则：走官方 ClawBot/iLink 通道、控制响应频率、不对未授权联系人开放访问。

两条值得了解的替代路线：一是企业协作场景直接用飞书/钉钉/企业微信的开放平台通道，群聊与审批能力更完整；二是希望零代码的桌面用户可选预装类方案，例如七牛云推出的 Linclaw 桌面 Agent 原生集成了微信、飞书、钉钉等九个渠道，省去插件安装与协议适配环节。

常见问题

Q：没有看到微信机器人入口怎么办？ 该功能由腾讯分批灰度开放，先把微信升级到 8.0.70 以上并完全重启客户端刷新插件列表；仍未出现只能等待，插件无法绕过账号侧开放范围。

Q：能把机器人拉进微信群吗？ 微信通道目前仅支持私聊，群聊能力尚未开放；群场景建议改用飞书、钉钉或企业微信通道。

Q：装完插件微信消息没反应？ 按顺序排查三处：是否已完成"安全访问"账号确认、扫码账号是否就是发消息的账号、dsh 是否在插件安装后重启过。

Q：可以同时绑定多个微信号吗？ 多数插件支持多账号，每个账号拥有独立凭据、同步游标与会话映射，单个账号重连或移除不影响其余账号。

结语

dsh 连接微信的本质是"官方协议 + 社区适配"：微信开放 ClawBot/iLink 入口解决了合法性问题，社区插件解决了与 Harness 会话体系的对接问题，普通开发者半小时内就能把随身 Agent 装进微信。据插件仓库文档（2026 年 8 月），各方案仍在快速迭代，本文内容基于当日公开资料，建议安装前核对对应插件的最新 README。