WeChat OpenCode

中文 | English

将微信私聊消息桥接到 OpenCode，支持文本、图片、文件、音视频的双向传输。

功能

• 文本消息 — 微信与 OpenCode 之间的双向文本传输
• 图片传输 — 支持发送/接收图片，支持微信 CDN 下载
• 文件传输 — 支持任意类型文件收发
• 音视频传输 — 完整的音频和视频消息支持
• 二维码登录 — 终端渲染二维码，扫码登录微信
• 独立会话 — 每个微信用户拥有独立 ACP 会话
• 后台模式 — 使用 --daemon 参数后台运行
• send-wechat 工具 — Agent 可直接发送文件/图片到微信

安装

方式一：一键运行（推荐）

无需安装，npx 会自动下载并运行：

npx wechat-bridge-opencode --agent opencode

方式二：全局安装

npm install -g wechat-bridge-opencode

安装完成后，可使用简写命令：

wbo --agent opencode

使用

cd /path/to/your/project
wbo --agent opencode
# 或直接使用 npx：
# npx wechat-bridge-opencode --agent opencode

首次运行会：

1. 终端显示二维码
2. 扫码登录微信
3. 保存登录令牌到 ~/.wechat-bridge-opencode
4. 开始轮询微信私信

选项

参数	说明
--agent <预设|命令>	内置预设或自定义命令
--cwd <目录>	工作目录
--login	强制重新登录
--daemon	后台运行
--config <文件>	JSON 配置文件
--idle-timeout <分钟>	会话空闲超时（默认 0 = 无限）

微信命令

工作区（/workspace 或 /ws）

命令	说明
/workspace list	列出所有目录
/workspace switch <n|路径>	按序号或路径切换（自动加载最近会话）
/workspace add /路径 [名称]	添加目录
/workspace status	显示当前目录

会话（/session 或 /s）

命令	说明
/session list	列出最近 10 个会话
/session list --cwd	列出当前工作区下的会话
/session list <路径|n>	按工作区路径或索引筛选会话
/session switch <n|slug>	按序号或 slug/标题切换
/session new	新会话（清除上下文）
/session status	显示当前会话

Agent（/agent 或 /a）

命令	说明
/agent list	列出可用 Agent 模式，带序号和当前标记
/agent switch <名称|n>	按名称或序号切换 Agent 模式
/agent status	显示当前 Agent 模式

Model（/model）

命令	说明
/model list	列出所有模型提供商及其模型数量
/model list <provider>	列出指定提供商下的模型（带序号）
/model switch <provider/model|n>	按完整模型名或序号切换模型（最后查询的提供商）
/model status	显示当前模型

Reasoning（/reasoning）

命令	说明
/reasoning list	列出可用推理级别
/reasoning switch <level>	切换推理级别
/reasoning status	显示当前推理级别

状态（/status）

命令	说明
/status	查看当前会话，工作区、Agent、模型、推理级别和上下文使用情况

停止（/stop）

命令	说明
/stop	停止正在运行的 Agent（相当于按 ESC）
/restart	重启 Agent（保留当前状态）
/upgrade	更新 OpenCode 后重启

版本（/version）

命令	说明
/version	查看当前版本和最新版本

思考（/thinking）

命令	说明
/thinking on	开启思考与工具调用显示（暂时禁用）
/thinking off	关闭思考与工具调用显示
/thinking status	查看当前显示设置

环境要求

• Node.js 20+
• 微信 iLink 机器人 API 访问权限
• OpenCode 本地安装或通过 npx 运行

数据存储

运行时数据存储在 ~/.wechat-bridge-opencode：

• 登录令牌
• 认证令牌
• 临时文件（下载的媒体）
• 守护进程 PID / 日志
• 桥接状态（.wechat-bridge-state.json）

注意事项

• 仅支持私信（群聊会被忽略）
• 权限请求自动批准
• send-wechat 工具自动安装到 ~/.config/opencode/tools/send-wechat.ts

致谢

本项目基于 wechat-acp（作者 formulahendry）二次开发，感谢原作者的贡献！

许可证

MIT