把 Codex 接入微信：用手机远程控制本机 AI Agent

前言

OpenClaw 等 AI Agent 可以在接到指令后自主规划并执行任务，但在软件开发、服务器运维和实验管理等场景中，我更习惯使用 OpenAI Codex。

腾讯为 OpenClaw 推出微信渠道插件后，我产生了一个想法：能不能直接把个人微信接入本机 Codex，让手机成为 Codex 的远程控制端？

为此，我开发了开源项目 codex-weixin。

一句话介绍：codex-weixin 是一个跨平台、本机运行的微信到 Codex 专用服务。启动后会打开 Web 管理页，用户扫码登录微信，即可通过微信私聊控制本机 Codex、管理工作目录并切换会话。

项目地址：

https://github.com/XavierJiezou/codex-weixin

为什么需要 codex-weixin

电脑不在身边时，我们经常会遇到这些需求：

• 查看服务器或实验任务是否正常运行；
• 让 Codex 修改一段代码、排查错误或生成文件；
• 继续之前的 Codex 会话；
• 给 Codex 发送图片、语音、视频或文档；
• 获取长时间任务的中间进度和最终结果。

已有的一些微信或消息网关方案往往存在局限：只支持文本、长任务没有过程反馈，或者无法同时管理多个微信账号。codex-weixin 因此聚焦于一个目标：尽可能在微信中复现本机 Codex 的完整工作流。

项目架构与边界

数据链路非常清晰：

个人微信账号 <-> codex-weixin <-> 本机 Codex <-> 允许访问的工作目录

项目强调本机优先：

• Web 管理服务默认只监听 127.0.0.1；
• 不会把管理页面主动开放到局域网或公网；
• 微信凭据不会返回管理页面；
• 未知联系人默认拒绝，需要在管理页明确授权；
• 工作目录必须从允许列表中选择；
• 多微信账号之间的会话、配置和附件相互隔离。

环境要求

安装前需要准备：

• Node.js 22 或更高版本；
• Git；
• 已安装并登录的 Codex CLI。

先安装并确认 Codex 可正常使用：

npm install -g @openai/codex
codex --version
codex

安装 codex-weixin

推荐通过 npm 全局安装：

npm install -g codex-weixin
codex-weixin

也可以从源码安装：

git clone https://github.com/XavierJiezou/codex-weixin.git
cd codex-weixin
npm install
npm run build
npm install -g .

服务启动后会自动打开本机管理页：

http://127.0.0.1:8787

第一次连接微信

1. 添加微信账号

打开管理页，点击右上角的“添加微信”，然后使用微信扫码登录。

2. 完成授权

如果微信版本过旧，页面会提示先更新。由于 codex-weixin 使用了 openclaw-weixin 的 iLink 接入实现，授权页显示 OpenClaw 属于正常现象，实际连接和执行任务的仍然是本机 Codex。

3. 从微信发送首条消息

扫码完成后，先从微信向这个账号发送一条消息。

4. 在管理页允许访问

回到 Web 管理页，找到待授权联系人并点击“允许访问”。

5. 开始使用

完成授权后，就可以直接在微信里向本机 Codex 下达指令。

核心功能

1. 多媒体输入与文件回传

微信端不仅可以发送文本，还能发送图片、音频、视频、语音和文档。Codex 分析或处理完成后，也可以把本机生成的图片、视频和文件作为微信原生消息回传。

2. 微信原生语音指令

用户可以直接发送微信语音，用自然语言描述任务。服务会完成语音转写，再把指令交给 Codex 执行。

3. Codex 原生命令与会话控制

微信端支持常用的 Codex 控制能力，包括：

• 新建、重命名和切换会话；
• 查看当前状态；
• 切换模型和推理强度；
• 停止当前任务；
• 绑定允许访问的工作目录。

4. 长任务过程反馈

软件构建、代码分析或实验任务可能持续较长时间。codex-weixin 会把 Codex 的处理中间状态持续发送到微信，最终答案仍保持完整，避免用户长时间看不到反馈。

5. 多微信账号并行接入

一个服务可以同时运行多个微信账号。每个账号拥有独立的授权关系、附件目录、受管会话和本机备注，移除账号时还可以选择是否保留历史数据。

6. Web 会话管理

管理页可以按微信账号查看历史会话，继续同一个 Codex thread，也支持新建、切换、重命名、重置和删除会话。除了微信，用户还可以直接在 Web 页面向 Codex 发送文本和附件。

7. 模型、推理强度与全局设置

Web 管理页支持设置默认模型、推理强度、Codex 后端和过程进度开关。微信端也可以通过命令查看并切换当前会话使用的模型。

典型应用场景

codex-weixin 适合以下场景：

1. 远程开发：人在外面时，让家里或实验室电脑上的 Codex 修改代码、运行测试；
2. 服务器运维：通过允许的工作目录查看日志、检查服务状态；
3. 实验管理：查询训练进度、整理实验结果和生成报告；
4. 文件处理：把微信中的图片或文档交给 Codex 分析，再把生成文件回传；
5. 移动办公：使用微信语音快速下达任务，不需要打开电脑端界面。

本地数据与安全建议

服务状态默认保存在 ~/.codex-weixin/。该目录可能包含微信账号凭据、联系人授权状态、附件和本机配置，因此不要提交到 Git 仓库，也不要与他人共享。

如果启用 danger-full-access，Codex 将绕过文件系统 sandbox。只有在明确理解整机访问风险时才应使用该模式，并建议始终限制可绑定的工作目录。

总结

codex-weixin 把个人微信变成了本机 Codex 的移动控制端。它不是通用聊天机器人网关，而是围绕 Codex 会话、工作目录、多媒体传输和过程反馈打造的专用工具。

如果你经常使用 Codex 进行开发、运维或实验，又希望在离开电脑时继续安排任务，可以尝试这个项目。

项目地址：

https://github.com/XavierJiezou/codex-weixin

欢迎提交 Issue、反馈 Bug 或贡献代码。如果项目对你有帮助，也欢迎点一个 Star。