tangwenhao616-netizen/dsh-clawbot

dsh-clawbot

License: MIT
GitHub release
GitHub issues
GitHub stars
dsh plugin

把你的微信变成 AI 智能体指挥中心。 扫一个二维码，直接在微信里与 DeepSeek Harness 对话——无需额外应用，无需服务器，无需桥接。

demo

什么是 dsh-clawbot？

dsh-clawbot 是 DeepSeek Harness（dsh）的一个微信渠道插件。它通过腾讯官方的 ClawBot（iLink）协议，将你的个人微信连接到正在运行的 dsh 智能体。

它解决的问题： 你想在手机上跟你的 AI 智能体对话，但又不想部署一个公开的 Web UI、开放端口或安装另一个应用。有了 dsh-clawbot，你只需在微信里扫一个二维码就能开始聊天——你的智能体在本地运行，回复通过微信返回。

为什么不用原版 dsh-weixin？

这是 caoyilearnai/dsh-weixin v0.2.1 的社区增强分支，带有生产级改进：

| 痛点 | 原版 | dsh-clawbot |
|---|---|---|
| 一条消息阻塞一切 | ❌ 单线程 | ✅ 每用户队列，并行轮次 |
| 一个用户 = 一个会话 | ❌ 1:1 映射 | ✅ 每用户多个命名会话 |
| 切换模型 | ❌ 仅全局 | ✅ 每会话模型，实时切换 |
| 管理会话 | ❌ 删除状态文件 | ✅ /new /list /use /del 命令 |
| 图片处理 | ⚠️ 污染历史记录 | ✅ 视觉感知注入 |

快速开始（5 分钟）

前置条件

- 已安装 DeepSeek Harness（dsh 命令可用）
- 微信 ≥ 8.0.70（iOS）并已启用 ClawBot：设置 → 插件 → ClawBot

1. 安装插件

dsh plugin --profile web add github:tangwenhao616-netizen/dsh-clawbot

2. 启动 dsh web

dsh web --port 3080

3. 扫描二维码

打开 http://127.0.0.1:3080/weixin → 点击 "扫码登录" → 用微信扫描。

4. 聊天

在微信中向机器人发送任意消息。每个微信用户都会获得一个独立的 Harness 会话。

You: /new work
Bot: ✨ 已新建并切换到「work」，直接发消息开始对话吧

You: 帮我写一份周报
Bot: [AI reply...]

功能特性
- 多会话：一个微信用户可以拥有多个独立会话。使用 /2 或 #work 帮我写周报 进行切换
- 斜杠命令：/new /list /use /model /rename /del /tag /help —— 无需 Web UI
- 按会话设置模型：每个会话记住自己的 provider/model。使用 /model 3 更改，下一轮即时生效
- 并发安全：按用户入站队列，按消息收集器 —— 无串扰，无阻塞
- 富媒体：文本、语音（由腾讯自动转录）、图片（视觉模型感知注入）
- 输入指示器：在智能体思考时显示“正在输入…”
- 主动推送：ctx.weixin.push() + /weixin/send HTTP 端点 + push_weixin 工具，用于主动发送消息
- 默认安全：凭据以 0600 权限存储，原子写入，速率限制退避

文档

- 配置
- 斜杠命令
- 主动推送
- 状态目录
- 安全说明
- 消息类型支持

配置

在你的 profile 的 cordis.patch.yml 中覆盖默认值：

- insert:
- id: weixin
name: dsh-clawbot
config:
replyMode: last       # full | last
maxChunk: 1200
sendIntervalMs: 2000

| 键 | 默认值 | 描述 |
|---|---|---|
| cwd | stateDir/workspace | 新会话的工作目录 |
| stateDir | $DSH_HOME/dsh-weixin | 凭据 / 会话映射 / 游标目录 |
| replyMode | full | full = 整轮文本 / last = 仅最后一条消息 |
| replyTimeoutMs | 900000 | 单轮回复超时（毫秒） |
| maxChunk | 1500 | 每条微信消息的最大字符数（自动拆分） |
| sendIntervalMs | 2000 | 发送之间的最小间隔（iLink 速率限制） |

斜杠命令

| 命令 | 描述 |
|---|---|
| /new [name] | 创建新会话并切换到该会话 |
| /list | 列出你的所有会话 |
| /2 | 快速切换到会话 #2 |
| #name content | 直接与特定会话对话 |
| /model | 列出可用模型 |
| /model  | 将当前会话切换到模型 #n |
| /rename  | 重命名当前会话 |
| /del  | 删除会话 #n |
| /tag on\|off | 在回复中切换会话标签 |
| /help | 显示帮助 |

中文关键词也可用：列表 帮助 模型 换模型

主动推送

Cordis 服务（其他插件）：

export const inject = ['weixin']
export function apply(ctx) {
ctx.weixin.push('user@im.wechat', 'hello')
ctx.weixin.sendAll('broadcast')
ctx.weixin.status()
ctx.weixin.sessions()
}

HTTP 路由（脚本 / 调度器）：

curl -X POST http://127.0.0.1:3080/weixin/send \
-H 'content-type: application/json' \
-d '{"to":"user@im.wechat","text":"hello"}'
Broadcast: {"to":"all", "text":"..."}

智能体工具：push_weixin 会自动注册，用于定时任务 / 警报。

状态目录

stateDir/
├── credentials.json    # bot_token / baseurl / ilink_bot_id / ilink_user_id / loggedInAt
├── session-map.json    # 微信用户 → 多会话映射（自动迁移）
└── updates-buf.json    # getupdates 长轮询游标

安全说明

⚠️ /weixin 面板没有身份验证。请仅在可信网络上运行 dsh web。

- 绑定到 127.0.0.1，或在远程暴露时使用带身份验证的反向代理
- 凭据以 0600 权限存储，并采用原子写入
- 图片注入具备视觉模型感知能力：若当前模型不支持图片，则跳过该图片以避免污染历史记录

消息类型支持

| 类型 | 状态 |
|---|---|
| 文本 | ✅ 完全支持 |
| 语音 | ✅ 腾讯服务端 ASR → 文本注入 |
| 图片 | ✅ CDN 下载 → AES 解密 → 附件（视觉模型感知） |
| 文件 / 视频 / 其他 | ❌ 不支持（友好回退） |

贡献

我们欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

- 通过 GitHub Issues 报告 bug
- 针对 main 分支提交 PR
- 提交前请运行测试：pnpm test

License

MIT © dsh-clawbot contributors

中文

把你的微信变成 AI 代理指挥中心。 扫码即用，在微信里直接和 DeepSeek Harness 对话——无需额外 App、无需公网服务器、无需桥接进程。

dsh-clawbot 是 DeepSeek Harness 的微信通道插件，基于腾讯官方 ClawBot（iLink）协议，把个人微信接入本地运行的 dsh 代理。

与原版 dsh-weixin 的区别

这是 caoyilearnai/dsh-weixin v0.2.1 的社区增强版，解决生产环境痛点：

| 痛点 | 原版 | dsh-clawbot |
|---|---|---|
| 一条消息阻塞全部 | ❌ 单线程 | ✅ 按用户排队，多会话并行 |
| 一个用户一个会话 | ❌ 1:1 映射 | ✅ 多命名会话 |
| 切换模型 | ❌ 只能全局 | ✅ 每会话独立模型，在线切换 |
| 管理会话 | ❌ 删状态文件 | ✅ /new /list /use /del 命令 |
| 图片处理 | ⚠️ 污染会话历史 | ✅ 视觉模型感知注入 |

快速开始（5 分钟）

前提：
- 已安装 DeepSeek Harness（dsh 命令可用）
- 微信 iOS ≥ 8.0.70，已开通 ClawBot：设置 → 插件 → ClawBot

1. 安装插件
sh
dsh plugin --profile web add github:tangwenhao616-netizen/dsh-clawbot

2. 启动 dsh web
sh
dsh web --port 3080

3. 扫码登录

打开 http://127.0.0.1:3080/weixin → 点「扫码登录」→ 微信扫码。

4. 开始对话

微信里给机器人发消息即可。每个微信用户自动对应独立会话。

你：/new 工作
机器人：✨ 已新建并切换到「工作」，直接发消息开始对话吧

你：帮我写一份周报
机器人：[AI 回复...]

功能特性

- 多会话：一个微信用户可拥有多个独立会话，/2 或 #工作 帮我写周报 快速切换
- 斜杠命令：/new /list /use /model /rename /del /tag /help，无需打开网页
- 每会话模型：每个会话记忆自己的 provider/model，/model 3 切换，下一条生效
- 并发安全：按用户入站排队，按消息 ID 收集回复，多用户多会话互不干扰
- 富媒体：文字、语音（腾讯服务端转写）、图片（视觉模型感知注入）
- 打字指示：AI 思考时显示「正在输入…」
- 主动推送：ctx.weixin.push() + /weixin/send HTTP 路由 + push_weixin 工具
- 安全默认：凭据 0600 权限存储，原子写入，限流指数退避

贡献

欢迎贡献！请阅读 CONTRIBUTING.md。

- 通过 GitHub Issues 报告 bug
- PR 请提交到 main 分支
- 提交前请运行测试：pnpm test

License

MIT © dsh-clawbot contributors