WeChat OpenCode
中文 | English
将微信私聊消息桥接到 OpenCode Server（HTTP API），支持文本、图片、文件、音视频的双向传输。
功能
- 文本消息 — 微信与 OpenCode 之间的双向文本传输
- 图片传输 — 支持发送/接收图片，支持微信 CDN 下载
- 文件传输 — 支持任意类型文件收发
- 音视频传输 — 完整的音频和视频消息支持
- 二维码登录 — 终端渲染二维码，扫码登录微信
- OpenCode Server — 基于 HTTP API，不再需要 ACP 子进程
- 后台模式 — 使用
--daemon 参数后台运行
- send-wechat 工具 — Agent 可直接发送文字、文件、图片到微信
安装
方式一：一键运行（推荐）
无需安装，npx 会自动下载并运行：
npx wechat-bridge-opencode
方式二：全局安装
npm install -g wechat-bridge-opencode
安装完成后，可使用简写命令：
使用
cd /path/to/your/project
wbo
首次运行会：
- 自动启动
opencode serve（HTTP Server）
- 终端显示二维码
- 扫码登录微信
- 保存登录令牌到
~/.wechat-bridge-opencode
- 开始轮询微信私信
选项
| 参数 |
说明 |
--cwd <目录> |
工作目录 |
--server-url <url> |
连接外部 OpenCode Server，跳过自动启动 |
--login |
强制重新登录 |
--daemon |
后台运行 |
--config <文件> |
JSON 配置文件 |
--idle-timeout <分钟> |
会话空闲超时（默认 0 = 无限） |
微信命令
工作区（/workspace 或 /ws）
| 命令 |
说明 |
/workspace list |
列出所有工作区，按最近活跃度排序，带序号 |
/workspace status |
显示当前工作区 |
/workspace switch <路径|编号> |
切换到指定目录（/workspace list 中的编号也可） |
/workspace add <路径> |
添加并切换到目录 |
会话（/session 或 /s）
| 命令 |
说明 |
/session list |
列出最近 20 个会话，显示工作路径 |
/session list current |
列出当前工作区的最近 20 个会话 |
/session switch <n> |
按编号切换到指定会话（自动切换到对应工作区） |
/session new |
新会话（清除上下文） |
/session status |
显示当前会话信息 |
Agent（/agent 或 /a）
| 命令 |
说明 |
/agent list |
列出可用 Agent 模式，带序号和当前标记（仅显示 primary 非内置 agent） |
/agent switch <名称|n> |
按名称或序号切换 Agent 模式 |
/agent status |
显示当前 Agent 模式 |
Model（/model）
| 命令 |
说明 |
/model list |
列出模型提供商及其数量 |
/model list <provider> |
列出指定提供商下的所有模型 |
/model switch <provider/model> |
切换模型（如 anthropic/claude-sonnet-4-5） |
/model status |
显示当前模型 |
Reasoning（/reasoning）
| 命令 |
说明 |
/reasoning list |
列出当前模型支持的实际推理等级（从模型 variants 获取） |
/reasoning switch <level> |
切换推理级别 |
/reasoning status |
显示当前推理级别 |
状态（/status）
| 命令 |
说明 |
/status |
显示当前会话（含标题）、工作区、Agent、Model、推理级别、上下文用量，以及当前工作区配置的 MCP servers 状态（含失败原因）。Agent/Model/Reasoning/MCP 从当前工作区获取，无历史消息时取配置默认值 |
停止（/stop）
| 命令 |
说明 |
/stop |
停止正在运行的 Agent |
/restart |
新会话（清除上下文） |
思考（/thought）
| 命令 |
说明 |
/thought on |
开启思考与工具显示 |
/thought off |
关闭思考与工具显示 |
/thought status |
查看当前显示设置 |
系统（/version、/upgrade）
| 命令 |
说明 |
/version |
查询 Bridge、OpenCode Server 与 npm 上最新版本；如有新版会提示 /upgrade |
/upgrade |
运行 opencode upgrade 升级 OpenCode 并自动重启 server（外部 server 模式不可用，npx 模式下重启即升级） |
消息计数（/next）
| 命令 |
说明 |
/next |
微信限制连续发送 10 条消息，超出后需用户回复才能继续。发送 /next 重置计数，不转发给 Agent |
环境要求
- Node.js 20+
- 微信 iLink 机器人 API 访问权限
- OpenCode（需支持
opencode serve 命令）
- Bridge 会自动启动
opencode serve；通过 --server-url <url> 可改连外部实例
数据存储
运行时数据存储在 ~/.wechat-bridge-opencode：
- 登录令牌
- 认证令牌
- 临时文件（下载的媒体）
- 守护进程 PID / 日志
- 桥接状态（
.wechat-bridge-state.json）
注意事项
- 仅支持私信（群聊会被忽略）
- 权限请求自动批准
send-wechat 工具自动安装到 ~/.config/opencode/tools/send-wechat.ts
致谢
本项目基于 wechat-acp（作者 formulahendry）二次开发，感谢原作者的贡献！
许可证
MIT
