codex-wechat-mcp

把微信直接接到本机 Codex。

codex-wechat 复用了微信插件背后的微信 HTTP 协议，把链路简化成：

微信 App -> codex-wechat -> 本地 codex mcp-server -> 微信 App

不依赖 OpenClaw 作为运行时宿主，只借用 @tencent-weixin/openclaw-weixin 所使用的登录和消息协议。

适合这类场景：

• 在微信里直接问问题、查资料、做项目研究
• 在手机上远程驱动本机 Codex
• 不想额外搭一个重型 agent runtime

• 直接。微信消息直接进本机 Codex，不走 OpenClaw 运行时。
• 轻量。只有一个桥接进程和 codex mcp-server。
• 稳定。渠道层采用无状态设计，不依赖远端会话续聊。
• 实用。支持项目绑定、模型切换、文件回传、typing 提示。
• 易部署。扫码登录后，tmux 挂后台就能长期跑。

• 微信扫码登录，保存本地 bot_token
• getupdates 长轮询收消息
• 本地启动或连接 codex mcp-server
• 按微信用户维度维护工作区与本地会话上下文
• 渠道层默认按“无状态”方式运行，每条消息都会新开一次 Codex MCP run
• /codex new 会清空当前微信侧上下文
• 支持微信内 /codex ... 控制命令

npm install
cp .env.example .env
npm run login
npm run start

微信里：

/codex bind /绝对路径
/codex where

然后直接发普通消息即可。

npm install

复制 .env.example 到 .env，常用项：

• CODEX_WECHAT_DEFAULT_WORKSPACE
• 设置后，微信里可以直接发自然语言，不必先 /codex bind
• CODEX_WECHAT_ALLOWED_USER_IDS
• 只允许指定微信用户控制本机 Codex
• CODEX_WECHAT_DEFAULT_CODEX_ACCESS_MODE
• default：默认映射为 workspace-write + on-request
• full-access：默认映射为 danger-full-access + never
• CODEX_WECHAT_MCP_CONFIG_JSON
• 透传给 codex MCP tool 的 config 字段，适合塞高级配置
• CODEX_WECHAT_MCP_PROFILE
• 指定 Codex profile
• CODEX_WECHAT_MCP_REQUEST_TIMEOUT_MS
• MCP 请求超时时间，默认 600000（10 分钟）

npm run login

终端会打印二维码。扫码确认后，会把账号信息保存在：

~/.codex-wechat/accounts/<account-id>.json

如果你登录了多个微信账号，可以通过 CODEX_WECHAT_ACCOUNT_ID 指定启动哪一个。

也可以查看已保存账号：

npm run accounts

npm run start

或：

node ./bin/codex-wechat.js start

推荐后台运行：

tmux new-session -d -s codex-wechat 'cd /path/to/codex-wechat && npm run start'
tmux attach -t codex-wechat

• codex-wechat login
• 发起微信扫码登录，保存当前微信账号的 bot_token
• codex-wechat start
• 启动微信长轮询和本地 Codex MCP 桥接服务
• codex-wechat accounts
• 查看本地已经保存的微信账号
• codex-wechat help
• 查看