Wechat Agent Channel

wechat-agent-channel

[简体中文](#zh-cn) | [English](#en)

---

简体中文

把微信消息接到本地 AI 编码助手里用。支持 `Codex`、`OpenCode`、`Claude Code`。

先准备好

• Python 3.11+
• Node.js 18+
• 微信端已接入 ClawBot
• 你要用的 CLI 已安装，并且终端里能直接运行

常见安装：

npm install -g @openai/codex
npm install -g opencode-ai
npm install -g @anthropic-ai/claude-code

安装项目依赖：

npm install

用 Codex / OpenCode

1. 先确认命令能跑：

codex
opencode

1. 选择默认 provider：

npm run setup

1. 启动：

npm start

如果你想重新选择默认 provider：

npm run setup:reset

用 Claude Code

1. 微信扫码登录：

npm run claude:setup

1. 生成或更新 .mcp.json：

npm run claude:install

1. 启动 Claude Code：

claude --dangerously-load-development-channels server:wechat

微信里怎么用

启动后，直接给 ClawBot 发消息就行。

示例：

• 帮我写个 Python 脚本
• 解释一下这个项目怎么启动
• 帮我看看这个报错是什么意思

也可以直接发附件：

• 图片
• 文件
• 语音
• 视频

附件会先保存到当前项目下的 `.wechat-agent/attachments/`，再交给 agent 读取。

如果你已经选了默认 provider，就不用再写前缀。

会话命令

• /new 或 新任务
• /new 重构支付
• /list 或 会话列表
• /current 或 当前会话
• /switch 2 或 切换会话 2
• /delete 2 或 删除会话 2
• /clear 或 清空会话

OpenCode 模型命令

• /models 或 模型列表
• /model
• /model m2.5
• /model clear

常用环境变量

• BOT_TOKEN
• WECHAT_BASE_URL
• WECHAT_CDN_BASE_URL
• WECHAT_AGENT_PROVIDER
• WECHAT_OUTBOUND_MEDIA_MAX_BYTES
• CODEX_MODEL
• CODEX_TURN_TIMEOUT_MS
• CODEX_BIN
• OPENCODE_MODEL
• OPENCODE_TURN_TIMEOUT_MS
• OPENCODE_THINKING
• OPENCODE_BIN

说明

• Codex 和 OpenCode 走本地 CLI
• Claude Code 走独立 MCP 插件模式
• 当前项目调用 Codex 时默认使用 --dangerously-bypass-approvals-and-sandbox，这样本地 CLI 才能真正拿到完整执行权限；请只在你信任的本机环境里使用
• 当前项目支持把微信图片、文件、语音、视频保存到本地并交给 agent 使用
• Codex / OpenCode 如需回传本地文件，可在最终回复末尾输出 wechat-reply JSON 代码块，桥会按其中的 media_paths 回传到微信
• 为避免大文件在微信侧出现“下载中断”，回传文件默认限制为 50MB；可用 WECHAT_OUTBOUND_MEDIA_MAX_BYTES 覆盖，例如 52428800
• 微信登录凭据默认保存在用户目录下

致谢

部分附件处理和接入思路参考了 `cc-connect`：