dsh-plugin-wechat

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-plugin-wechat

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

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

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

```bash
# 一条命令：自动安装 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）** 里加，然后保存重载）：

```yaml
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，微信按纯文本显示 |
| 发图片/语音 | 目前只支持文字消息，其他类型会收到"暂不支持"提示 |

## 可选项（一般不用动）

| 环境变量 | 默认值 | 说明 |
|----------|--------|------|
| `WECHAT_API_KEY` | 空 | 桥的共享密钥；与他人共用机器时设置 |
| `WECHAT_SESSION_MODE` | `per-user` | `single`=所有微信好友共用一个会话 |
| `WECHAT_WORKSPACE` | dsh 启动目录 | 微信会话的工作目录（agent 的工具操作范围） |
| `DSH_BRIDGE_PORT` | `8787` | 桥端口；改动后重跑 setup.sh（OpenClaw 侧自动同步） |
| `DSH_WEB_PORT` / `OPENCLAW_GATEWAY_PORT` | `3080` / `18789` | 启动端口 |

## 注意事项

- 本方案使用**腾讯官方 ClawBot（iLink）通道**，官方支持、协议合规。遵守《微信ClawBot功能使用条款》即可。
- 机器人收到消息会进入 DSH 会话与模型请求，注意内容；保持 DSH 权限为 `workspace-write`（勿开 `danger-full-access`），桥默认只监听本机。
- 建议只做被动回复，不群发、不营销。

## 许可

MIT