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

把 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 可正常使用npminstall-gopenai/codex codex--versioncodex安装 codex-weixin推荐通过 npm 全局安装npminstall-gcodex-weixin codex-weixin也可以从源码安装gitclone https://github.com/XavierJiezou/codex-weixin.gitcdcodex-weixinnpminstallnpmrun buildnpminstall-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适合以下场景远程开发人在外面时让家里或实验室电脑上的 Codex 修改代码、运行测试服务器运维通过允许的工作目录查看日志、检查服务状态实验管理查询训练进度、整理实验结果和生成报告文件处理把微信中的图片或文档交给 Codex 分析再把生成文件回传移动办公使用微信语音快速下达任务不需要打开电脑端界面。本地数据与安全建议服务状态默认保存在~/.codex-weixin/。该目录可能包含微信账号凭据、联系人授权状态、附件和本机配置因此不要提交到 Git 仓库也不要与他人共享。如果启用danger-full-accessCodex 将绕过文件系统 sandbox。只有在明确理解整机访问风险时才应使用该模式并建议始终限制可绑定的工作目录。总结codex-weixin把个人微信变成了本机 Codex 的移动控制端。它不是通用聊天机器人网关而是围绕 Codex 会话、工作目录、多媒体传输和过程反馈打造的专用工具。如果你经常使用 Codex 进行开发、运维或实验又希望在离开电脑时继续安排任务可以尝试这个项目。项目地址https://github.com/XavierJiezou/codex-weixin欢迎提交 Issue、反馈 Bug 或贡献代码。如果项目对你有帮助也欢迎点一个 Star。