把微信变成 Codex 的聊天入口。
你在微信里发消息（文字、图片、语音、音视频、文件），wechat-codex 会把内容转给本机 Codex，再把结果回传到微信。实现基于ClawBot。
- 微信和终端都能给同一个 Codex 会话发消息
- 忙碌时自动排队，不会丢消息
- 支持多媒体输入
- 支持把 Codex 生成的本地文件/图片/语音/视频发回微信
- 支持会话控制命令（切目录、切模型、清空会话等）
- 文字：直接转给 Codex
- 图片：下载并解密后，作为图片上下文传给 Codex
- 微信语音消息：优先使用微信侧已有转写文本
- 音频文件：自动提取音轨并转写（需要
ffmpeg+ffprobe+whisper） - 视频：自动抽关键帧 + 语音转写（同样依赖上面 3 个工具）
- 普通文件（如
.txt.json.geojson）：先暂存，等你发“处理需求”后和需求一起交给 Codex
- Node.js
>= 22 - npm（随 Node.js 一起安装）
codex命令可直接使用openclaw命令可直接使用clawbot命令可直接使用- 能正常访问微信桥接相关网络
如果你还没安装 Node.js，推荐用 nvm：
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22安装 Codex CLI：
npm install -g @openai/codex@latest安装后检查：
node -v
npm -v
codex --help安装并检查：
ffmpeg -version
ffprobe -version
whisper --help在项目目录执行：
npm install
npm run setupnpm run setup 会做 3 件事：
- 弹出或打印微信二维码，让你扫码绑定
- 让你输入默认工作目录（Codex 在哪里工作）
- 写入配置文件
~/.wechat-codex-bridge/config.env
npm start直接在微信里发一句话，比如：
- “帮我写一个 Python 读取 CSV 的脚本”
- “解释这段报错是什么意思”
系统会自动把消息转给 Codex，并把中间思考内容和回复发回微信。
普通文件（例如 .txt / .json / .geojson）不是“发完立刻处理”，而是两步：
- 先把文件发给微信机器人（可连续发多个）
- 再发一条文字需求（例如“把这几个文件合并成一个 CSV 并统计条数”）
如果你希望 Codex 回传图片/文件/语音/视频，需要把下面的指令放入 ~/.codex/AGENTS.md 中。
# WeChat Bridge Attachment Convention
You may be running inside a `wechat-codex` bridge session, which mirrors your
replies to a WeChat user. By default only your visible text is forwarded. To
deliver a file to the WeChat user, append
a fenced block at the very end of your final answer:
```wechat-attachments
image /abs/or/rel/path/to/picture.png
file /abs/or/rel/path/to/report.pdf
voice /abs/or/rel/path/to/clip.mp3
video /abs/or/rel/path/to/movie.mp4
```
## Rules
- Place the block at the **very end** of the final answer, with a blank line
before it. No prose may follow the closing ``` fence.
- One attachment per line. The first token is the `kind`; the rest is the path.
- Valid kinds: `image`, `file`, `voice`, `video`.
- `image`: png, jpg/jpeg, gif, webp, bmp, svg
- `file`: everything else — pdf, docx, xlsx, csv, txt, zip, json, logs, …
- `voice`: mp3, wav, m4a, ogg, aac
- `video`: mp4, mov, mkv, avi, webm
- Use absolute paths when possible. Relative paths are resolved against the
current working directory.
- Briefly mention in the visible prose what you are sending so the user has
context (e.g. "Here is the loss curve you asked for.").
- The file must already exist on disk at the time you emit the block — the
bridge only forwards, it does not wait for files to appear. If you intend to
save then send, save first, then emit the block.
- Include the block **only** when the user actually wants the artifact
delivered. Do not attach files by default.
- **Never** include the fence inside a code example or inside prose — it is
parsed structurally and false positives will cause misdelivery. If you need
to discuss the convention itself, use inline code or indented blocks, not a
fenced block with the `wechat-attachments` info string.
## Examples
Single image:
```
Here is the requested chart.
```wechat-attachments
image /tmp/loss_curve.png
```
```
Multiple files in one reply:
```
Attached: the training report and the raw metrics.
```wechat-attachments
file /home/user/proj/report.pdf
file /home/user/proj/metrics.csv
```
```
No attachment (normal reply — do not emit the block):
```
The experiment is still running; nothing to send yet.
```
```/help：查看帮助/status：查看当前会话状态（工作目录、模型、模式、线程、剩余额度等）/cwd <路径>：切换工作目录（会重启 Codex 会话）/model <模型名>：切换模型/mode <plan|workspace|danger>：切换运行模式（重启服务后生效）/now <内容>：中断当前处理并立刻执行这条内容/allow：向 Codex TUI 发送 Enter，用于权限确认/deny：向 Codex TUI 发送 Esc，用于取消权限确认/key <enter|esc|up|down|left|right|tab|space|y|p|n|1|2|3>：向 Codex TUI 发送指定按键/screen：查看当前 Codex TUI 界面和可选项/clear：清空当前会话/skills：列出可用 skills
wechat-codex 运行的是原生 Codex TUI。遇到需要权限确认的命令时，Codex 会在 TUI 里显示选项，wechat-codex 会把当前界面同步到微信。常用操作：
/screen 查看当前 Codex TUI 界面
/allow 发送 Enter，执行当前选中的选项
/deny 发送 Esc，取消/返回
/key down 向下移动选项
/key up 向上移动选项
/key enter 确认当前选项
典型流程是：先用 /screen 看当前选项；如果默认选项就是要执行的操作，发送 /allow；如果需要选择“本次允许 / 以后不再询问 / 取消”等其他选项，用 /key up、/key down 调整后再 /key enter。
默认配置文件路径：
~/.wechat-codex-bridge/config.env
示例：
workingDirectory=/home/you/project
model=gpt-5.4
mode=workspace字段说明：
workingDirectory：默认工作目录（必填，必须存在）model：默认模型（可选）mode：运行模式（默认workspace）plan：只读分析workspace：可写工作区（推荐）danger：无沙箱（高风险）
codexProxyMode：Codex 子进程的代理环境处理方式（可选）inherit：继承当前终端的代理环境变量（默认）clear：启动 Codex 时清除HTTP_PROXY/HTTPS_PROXY/ALL_PROXY/NO_PROXY等代理变量
wechatProxyUrl：wechat-codex 访问微信 API/CDN 时使用的代理（可选）- 例如
http://127.0.0.1:7890 - 开学校 VPN 后如果微信消息收不到，可以让微信 API 走 Clash/外网代理，同时 SSH 校内服务器继续走学校 VPN
- 例如
可通过环境变量修改数据目录：
export WCB_DATA_DIR=/your/path推荐链路是：
微信 <-> 本机 wechat-codex <-> 本机 Codex/OpenAI
<-> 校园网 VPN/内网通道 <-> 内网服务器
也就是说，本机同时负责外网 Codex 和内网服务器访问；内网服务器只执行操作，不需要访问 OpenAI。
如果开启校园网 VPN 后 Codex 连接失败，先让 Codex 子进程不要继承终端代理环境。编辑 ~/.wechat-codex-bridge/config.env：
workingDirectory=/你的项目路径
mode=workspace
codexProxyMode=clear然后重启：
npm start这只能解决“VPN/代理工具给终端注入代理变量”导致的冲突。如果 VPN 是系统级全局接管路由，还需要在 VPN 或代理工具里做分流：
OpenAI/Codex 相关域名 -> 走可访问外网的线路
内网服务器 IP / 学校网段 -> 走校园网 VPN
常见内网网段：
10.0.0.0/8
172.16.0.0/12
192.168.0.0/16
目录内会自动创建：
config.envlogs/tmp/
先执行：
npm run setup完成扫码绑定后再 npm start。
- 检查
config.env的workingDirectory - 或在微信发送
/cwd <正确路径>
检查这 3 个工具是否可用：
ffmpeg -version
ffprobe -version
whisper --help/mode 会写入会话设置，但要重启服务后才会按新模式启动 Codex：
npm start- 除非你非常确定环境可信，否则不要用
danger模式 - 建议使用最小权限账号运行服务
- 定期清理
~/.wechat-codex-bridge/tmp和日志文件