微信 ↔ Codex CLI 桥接
用微信连接本机运行的 codex CLI。桥接服务基于 codex exec --json,支持:
- 文字消息转发给 Codex
- 图片作为
--image输入传给 Codex - 文件、语音、视频落盘后把本地路径交给 Codex
- 使用
thread_id自动续接上下文 - 微信端控制
/model、/sandbox、/stop、/clear、/send
如果需要修改和微信桥接相关的底层协议,可以参考 wechat_agent_bridge_skills/openclaw-weixin 原版 SDK。
目录说明
| 路径 | 作用 |
|---|---|
templates/ |
可独立运行的 Node 桥接服务 |
templates/src/ilink.ts |
微信 ilink(ClawBot)HTTP API:收发消息、媒体加解密 |
templates/src/bridge.ts |
主循环:getupdates + codex exec --json |
templates/bridge.config.example.json |
配置模板,复制为 bridge.config.json |
前置条件
- Node.js >= 18
- 已安装并登录
codexCLI(先执行codex login) - 微信侧已完成 ClawBot / ilink 机器人绑定
安装与启动
cd wechat-codex_agent_bridge-skill/templates
cp bridge.config.example.json bridge.config.json
# 编辑 bridge.config.json:至少设置 cwd 为项目根目录
npm install
npm run setup
npm start
微信端指令
/help- 查看帮助/status- 查看当前 bridge 状态/clear- 清除会话、终止任务、清空队列和追问/stop- 终止当前任务/stopall- 终止当前任务并清空队列和追问/send <路径>- 发送服务器上的文件到微信/model- 查看当前模型/model <名称>- 设置下一轮执行使用的模型/model clear- 恢复 Codex 默认模型/sandbox- 查看当前 sandbox/sandbox read-only|workspace-write|danger-full-access- 切换 sandbox
重要限制
Codex 版桥接使用的是非交互式 codex exec。因此:
- 支持稳定的消息桥接、会话续接、图片输入和文件回传
- 不支持像 Cursor 版那样对每一次工具调用做微信侧逐条审批
- 需要通过
/sandbox控制整体执行范围,而不是在工具执行中途弹微信确认
发送文件给微信
如果希望 Codex 把本机文件主动发回微信,在回复中输出:
[SEND_FILE:/绝对路径/文件.ext]
桥接层会自动识别并上传该文件。