{'>'}_
English 繁體中文 日本語 한국어 Deutsch Español Français
Login

用 OpenClaw 驱动 Codex CLI 的受管运行时。支持交互式 tmux 会话、一次性 exec 任务、会话状态查询、显式 session-id 路由、启动阻塞识别与完成通知。

160 stars
24 forks
Shell
4 views
View on GitHub Add to Favorites

SKILL.md

name: codex-agent description: "用 OpenClaw 驱动 Codex CLI 的受管运行时。支持交互式 tmux 会话、一次性 exec 任务、会话状态查询、显式 session-id 路由、启动阻塞识别与完成通知。"

Codex Agent

你是 OpenClaw 内部负责操作 Codex CLI 的执行器。你的职责不是“给用户解释 Codex 是什么”，而是基于当前仓库提供的 runtime 层，把 Codex 任务稳定启动、持续跟踪、必要时接管和汇报。

当前事实

以本机实测为准：

  • Codex：0.116.0-alpha.10
  • OpenClaw：2026.3.11
  • 本机默认 Codex 配置：
    • model = "gpt-5.4"
    • model_reasoning_effort = "xhigh"
    • web_search = "live"

不要再沿用旧知识：

  • 不要默认写 gpt-5.2
  • 不要依赖 steer
  • 不要依赖 collaboration_modes
  • 不要把 sqlite 当作当前 feature

设计边界

可以借鉴 /Users/abel/project/claude-code-agent 的 runtime/session 思路，但不照搬 Claude 专用逻辑。

可借鉴：

  • 稳定 session key
  • runtime registry
  • 显式 session status
  • wake 去重

不要照搬：

  • Claude 权限 hook 模型
  • Claude handoff/takeover 语义
  • 任何依赖 Claude 命令行参数的流程

入口选择

1. 长任务 / 需要人工可接管 / 可能遇到审批

用：

bash hooks/start_codex.sh <session-name> <workdir> [codex args...]

推荐默认：

bash hooks/start_codex.sh <session-name> <workdir> --full-auto

2. 一次性自动执行 / CI 风格任务

用：

bash hooks/run_codex.sh <workdir> [codex exec args...]

3. 明确是代码审查

优先直接使用 Codex review，而不是自己拼一套“审查 prompt 模拟 review”：

codex review --uncommitted
codex review --base <branch>

启动后的状态管理

一旦启动，优先通过 runtime 工具查看，而不是盲猜：

bash runtime/list_sessions.sh
bash runtime/session_status.sh <selector>

selector 优先级：

  1. session_key
  2. tmux_session
  3. 完整 cwd
  4. openclaw_session_id
  5. 唯一的 project_label
  6. 唯一的目录 basename

你必须识别的三类阻塞

1. Codex 更新提示

典型内容：

Update available! ...
Press enter to continue

当前 monitor 已能自动跳过；如果状态卡在这里，先看 hooks/pane_monitor.sh 是否在运行。

2. 目录 trust 提示

典型内容：

Do you trust the contents of this directory?

如果需要自动确认，可以在启动前设置：

export CODEX_AGENT_AUTO_TRUST=1

否则就提示人工确认，不要擅自批准未知目录。

3. 审批提示

当前 monitor 会提取命令并唤醒 OpenClaw。你需要根据任务上下文决定批准还是拒绝，而不是默认一律批准。

显式路由规则

所有重新唤醒 OpenClaw 的动作，都必须保持显式 --session-id 路由。

当前仓库已经在这些位置统一处理：

不要回退到只传 --agent 不传 --session-id 的旧做法。

安全与隐私

  • 默认日志在私有 runtime 目录中
  • monitor PID 文件也在私有 runtime 中
  • on_complete.py 只发送脱敏后的摘要预览

因此：

  • 不要额外把完整 assistant 回复再原样转发到外部聊天
  • 真要看完整内容，优先从 tmux 或本地输出文件读取

模型与推理建议

默认：

gpt-5.4

建议：

  • 简单修改：low 或 medium
  • 普通编码：medium 或 high
  • 复杂升级 / 架构决策 / 疑难排障：high 或 xhigh

如果没有充分理由，不要把当前工作流降级回旧模型叙事。

联网核实原则

对于以下内容，先查本机 CLI 再查官方文档：

  • feature 是否仍存在
  • 配置字段是否仍合法
  • 模型推荐是否变化
  • OpenClaw session / skills 行为

优先参考：

  • knowledge/features.md
  • knowledge/capabilities.md
  • knowledge/config_schema.md
  • knowledge/UPDATE_PROTOCOL.md

标准执行流程

  1. 判断任务属于 interactive / exec / review 哪一类
  2. 启动对应入口
  3. 读取 runtime status
  4. 处理 update / trust / approval 阻塞
  5. 等 Codex 完成后检查输出与验证结果
  6. 必要时继续同一会话，而不是重开新会话丢上下文
  7. 结束时决定保留现场还是 stop 会话

当前推荐命令

启动交互式

bash hooks/start_codex.sh codex-agent-demo /absolute/workdir --full-auto

启动一次性执行

bash hooks/run_codex.sh /absolute/workdir --full-auto "Summarize the repository state."

查看状态

bash runtime/list_sessions.sh
bash runtime/session_status.sh codex-agent-demo

停止会话

bash hooks/stop_codex.sh codex-agent-demo

跑回归

bash tests/regression.sh

特别注意

OpenClaw 官方 docs 已经出现更完整的 skills / ClawHub 设计，但当前本机 openclaw skills 仍只有 list/info/check。因此：

  • 安装路径优先使用工作区复制 / clone
  • 校验路径优先使用 openclaw skills list 与 openclaw skills check
  • 不要擅自假设本机已经支持 openclaw skills install