Codex Agent — 让 OpenClaw 替你操作 Codex 🧠

English | 中文

你躺在床上说一句话，OpenClaw 帮你开 Codex、写提示词、处理审批、检查质量、汇报结果。你随时可以打开终端接管。

这是一个 OpenClaw 专用 Skill。 需要 OpenClaw 作为 AI agent 运行时，通过 OpenClaw 的 agent 唤醒、消息投递、cron 等能力驱动整个工作流。

它是什么？

一句话：OpenClaw 代替用户操作 Codex CLI。

Codex 是 OpenAI 的终端编程工具，很强，但需要你坐在电脑前盯着它——写提示词、等输出、审批命令、检查结果。这个 skill 让 OpenClaw 替你做这些事。

本质就两样东西：tmux + hook。

• tmux：Codex 跑在 tmux session 里，OpenClaw 通过 tmux 读输出、发指令，和人在终端里操作一模一样
• hook：Codex 完成任务或等审批时，自动通知用户（Telegram）+ 唤醒 OpenClaw 处理

用户随时可以 tmux attach 接入，看 Codex 在干什么，甚至直接接管操作。

完全体 Codex

普通用法：你手动写提示词丢给 Codex，Codex 只知道你告诉它的东西。

OpenClaw 在发任务给 Codex 之前，会：

1. 识别本机环境：当前装了哪些 MCP server（Exa 搜索、Chrome 控制等）、哪些 Skills、哪些模型可用
2. 根据任务选模型：简单 bug 用快模型，架构设计用强模型，代码搜索用 code 专用模型
3. 设计提示词：不是转发用户原话，而是基于知识库 + 提示词模式库，针对任务类型构造最优提示词——告诉 Codex 它能用什么工具、该怎么分步骤、输出什么格式
4. 开启合适的 feature flags：比如 multi_agent、web_search、shell_snapshot 等，按需启用

这意味着 Codex 每次收到的都是一个充分利用本机全部能力的精心设计的任务，而不是用户随手写的一句话。

解决什么问题？

正常用 Codex 的流程：

你坐在电脑前 → 打开终端 → 想提示词 → 启动 Codex → 盯着输出 →
审批命令 → 不满意就重来 → 满意了收工

用了这个 skill：

你躺在床上 → 在 Telegram 里说"帮我给这个项目加个 XX 功能" →
OpenClaw 开 Codex 干活 → 中间过程自己处理 → 完事了 Telegram 通知你 →
不满意？说一句就继续改 → 想看过程？tmux attach 看直播

核心价值：用户当老板，OpenClaw 当员工，Codex 当工具。

工作流程

1. 用户下任务（Telegram / 终端 / 任何渠道）
     ↓
2. OpenClaw 理解需求，追问不清楚的地方
     ↓
3. OpenClaw 设计提示词，选择执行模式，和用户确认
     ↓
4. OpenClaw 在 tmux 里启动 Codex
     ↓
5. Codex 干活，OpenClaw 通过 hook 被唤醒：
   ├── 任务完成 → OpenClaw 检查输出质量
   │   ├── 满意 → Telegram 通知用户，汇报结果
   │   └── 不满意 → 让 Codex 继续改
   ├── 等待审批 → OpenClaw 判断批准/拒绝
   └── 方向性问题 → 立即找用户确认
     ↓
6. 用户收到最终结果
   （整个过程可以随时 tmux attach 接入）

中间过程 OpenClaw 全权处理，但每一步都会同步发送到 Telegram——任务完成、审批等待、输出内容，用户在手机上实时可见。你可以选择不管（让 OpenClaw 自主处理），也可以随时插话干预。

技术原理：tmux + hook

tmux：像人一样操作终端

OpenClaw 操作 Codex 的方式和人完全一样：

# 启动 Codex（和你在终端里敲一样）
tmux send-keys -t codex-session 'codex --full-auto' Enter

# 发送提示词（和你打字一样）
tmux send-keys -t codex-session '帮我实现 XX 功能'
sleep 1
tmux send-keys -t codex-session Enter

# 查看输出（和你看屏幕一样）
tmux capture-pane -t codex-session -p

tmux 的好处：

• 不受 OpenClaw turn 超时限制：Codex 跑多久都行，OpenClaw 被唤醒时再来看
• 用户可以随时接入：tmux attach -t codex-session 就能看到 Codex 的实时输出
• 持久化：OpenClaw 重启、网络断开，Codex 都不受影响

hook：任务完成和审批等待的自动通知

两套机制覆盖两种事件：

1. Codex notify hook（任务完成）

Codex 自带的 notify 配置，任务完成时调用脚本：

Codex 完成 turn → on_complete.py
                  ├── 📱 Telegram 通知用户（Codex 完整回复内容）
                  └── 🤖 openclaw agent 唤醒（OpenClaw 自动检查输出）

用户在 Telegram 上能看到 Codex 每次回复的完整内容，相当于实时监控。

2. tmux pane monitor（审批等待）

Codex 的 notify 不覆盖审批场景，所以用 pane_monitor.sh 监控 tmux 输出：

Codex 弹出审批提示 → pane_monitor.sh 检测到关键词
                     ├── 📱 Telegram 通知用户（待审批的具体命令）
                     └── 🤖 openclaw agent 唤醒（OpenClaw 自主判断批准/拒绝）

两套机制都是双通道同时触发：用户和 OpenClaw 同时收到消息。用户看到后可以不管（OpenClaw 会处理），也可以直接回复干预。

用户随时可接管

这不是黑箱。任何时候：

• tmux attach -t codex-session：直接看 Codex 在干什么
• 在 tmux 里直接打字：接管操作
• tmux detach：看完了，还给 OpenClaw 继续

两种审批模式

启动前由用户选择：

模式	谁审批	适用场景
Codex 自动 (--full-auto)	Codex 自己判断	常规开发，省心
OpenClaw 审批 (默认)	OpenClaw 判断批准/拒绝	敏感操作，需要把关

两种模式下 pane monitor 都会启动（--full-auto 偶尔也会弹审批）。

知识库：OpenClaw 真正理解 Codex

OpenClaw 不是盲目转发命令。它维护一套 Codex 知识库：

文件	内容
features.md	30+ feature flags、斜杠命令、CLI 子命令
config_schema.md	config.toml 完整字段定义
capabilities.md	本机 MCP/Skills/模型能力
prompting_patterns.md	提示词模式库（按任务类型）
UPDATE_PROTOCOL.md	5 级数据源更新协议
changelog.md	版本变更 + 实测发现

知识库会过时，所以有更新协议：版本变更 / 超 7 天 / 手动触发时，按 CLI 自省 → Schema → GitHub → 官方文档 → 社区的优先级更新。

文件结构

codex-agent/
├── SKILL.md                    # OpenClaw 工作流指令（给 OpenClaw 读的）
├── README.md                   # 本文件（给人读的）
│
├── hooks/
│   ├── on_complete.py          # Codex 完成 → Telegram + OpenClaw 唤醒
│   ├── pane_monitor.sh         # 审批检测 → Telegram + OpenClaw 唤醒
│   ├── start_codex.sh          # 一键启动（Codex + monitor）
│   └── stop_codex.sh           # 一键清理
│
├── knowledge/                  # Codex 知识库（6 文件）
│   ├── features.md
│   ├── config_schema.md
│   ├── capabilities.md
│   ├── prompting_patterns.md
│   ├── UPDATE_PROTOCOL.md
│   └── changelog.md
│
├── workflows/
│   ├── standard_task.md        # 标准任务流程
│   └── knowledge_update.md     # 知识库更新流程
│
├── references/
│   └── codex-cli-reference.md  # CLI 命令参考
│
└── state/
    ├── version.txt             # 当前 Codex 版本
    └── last_updated.txt        # 知识库最后更新日期

快速开始

详细的安装步骤见 INSTALL.md（7 步，约 5 分钟）。

或者，把下面这段话直接发给你的 OpenClaw，它会自动帮你完成配置：

请帮我安装和配置 codex-agent skill。 先读一遍完整的安装指南 ~/.openclaw/workspace/skills/codex-agent/INSTALL.md，然后按照步骤帮我完成配置。 如果还没有这个文件，先从 https://github.com/dztabel-happy/codex-agent 克隆到 ~/.openclaw/workspace/skills/codex-agent/，再读 INSTALL.md 执行。

配置完成后，在 Telegram 里对 OpenClaw 说一句话就能用：

"用 Codex 帮我在 /path/to/project 实现 XX 功能"

更新

已安装的用户更新到最新版本：

cd ~/.openclaw/workspace/skills/codex-agent
git pull

更新日志见 CHANGELOG.md。

前置条件

• OpenClaw 已安装并运行
• Codex CLI 已安装
• tmux 已安装
• Telegram 已配置为 OpenClaw 消息通道
• ⚠️ OpenClaw session 自动重置必须关闭或调大（默认每天重置会丢失 Codex 任务上下文，详见 INSTALL.md）

踩过的坑

问题	解决
OpenClaw 默认每天重置 session，长任务上下文丢失	关闭自动重置（见前置配置）
tmux send-keys 文本 + Enter 一起发，Codex 不响应	分两次发，中间 sleep 1s
--full-auto 与 shell alias 冲突报错	检查 ~/.bashrc / ~/.zshrc 是否有 codex alias，确保 tmux 里用的是原生命令
Codex notify 不覆盖审批等待	pane_monitor.sh 补齐
--full-auto 偶尔也弹审批	pane monitor 所有模式都启
Codex memories 不工作	disable_response_storage = true + custom provider 不兼容，不启用
notify payload 缺少字段文档	turn-id 和 cwd 是实测发现的

未来计划

• 复制模式到 Claude Code / OpenCode agent
• 补充更多提示词模式（代码审查、架构设计）
• pane monitor 支持更多审批模式检测