dsh-plugin-wechat

把 DeepSeek Harness（DSH）变成你的个人微信机器人：微信扫码接入，每条消息由 DSH 的 AI（带工具和记忆）回复。

快速开始（一条命令 + 扫码）

准备：一台电脑（macOS / Linux；Windows 请用 Git Bash 或 WSL）、Node.js ≥ 22、一个微信账号。

# 一条命令：自动安装 DSH、本插件、OpenClaw、微信通道，并启动全部
npx -y dsh-plugin-wechat

不想用 npx 也可以：npm i -g dsh-plugin-wechat 后运行 dsh-wechat-setup； 或从 GitHub 仓库运行：git clone https://github.com/gnulife/dsh-plugin-wechat.git && cd dsh-plugin-wechat && bash scripts/setup.sh

脚本运行过程中只需你做两件事（都只有第一次需要）：

1. 扫码：终端里会出现二维码 → 用手机微信扫码确认。
2. 填 API Key：脚本会提示你打开 http://127.0.0.1:3080 → 「设置 → 模型」填入 DeepSeek API Key。

完成后：直接用微信给机器人发消息，几秒内收到回复即成功。

日常使用：重跑 bash scripts/setup.sh 即可（幂等，只会把没跑起来的服务拉起来）。 停止：pkill -f "dsh web"; pkill -f "openclaw gateway" 日志：~/.dsh-plugin-wechat/logs/

常见问题（FAQ）

扫码报「网络错误，请稍后重试」？ 大概率是你电脑上开了代理工具（Clash / Surge 等），把微信域名劫持走了。给微信域名加直连规则即可（Clash 系：订阅 → 全局扩展配置（Merge） 里加，然后保存重载）：

prepend-rules:
  - DOMAIN-SUFFIX,weixin.qq.com,DIRECT
  - DOMAIN-SUFFIX,liteapp.weixin.qq.com,DIRECT

加完重跑 bash scripts/setup.sh。

问题	处理
微信收到「Something went wrong...」	① DSH 里模型没配好：打开 3080 网页确认能正常对话；② 刚改过配置：重跑 setup.sh（会自动重启网关）
微信不回消息	重跑 bash scripts/setup.sh；再 openclaw channels status --probe 看通道；掉线就重跑 setup.sh（会重新引导扫码）
桥端点没就绪（自检警告）	看日志 ~/.dsh-plugin-wechat/logs/dsh-web.log；确认 3080 网页能打开、模型已配置
回复超时	模型请求慢或 API Key 未填。先在 http://127.0.0.1:3080 正常聊一句确认
回复带 #、* 等符号	正常现象：AI 输出是 Markdown，微信按纯文本显示
发图片/语音	目前只支持文字消息，其他类型会收到"暂不支持"提示

可选项（一般不用动）

环境变量	默认值	说明