核心用法
codex-runner 是 OpenClaw 平台的异步代码执行 Skill，专为解决主会话阻塞和长时任务中断问题设计。它通过 sessions_spawn 创建独立子会话，在后台运行 OpenAI Codex CLI，让用户可以继续与主助手对话，同时 Codex 在后台持续编码。
关键命令：
start：启动后台任务（异步执行，需通过background=true或sessions_spawn调用）status：检查 Codex 进程状态log：查看实时日志输出stop：终止运行中的任务
执行模式：必须使用 --dangerously-bypass-approvals-and-sandbox 参数才能写入文件系统，这绕过了 Codex 的安全沙箱。
显著优点
1. 会话零阻塞：主会话立即返回，用户可继续提问或发新指令
2. 突破时长限制：适合整夜运行的大型项目开发
3. TDD 自动化支持：内置开发流程模板，支持"先写测试→写代码→自动修复→构建验证"的完整闭环
4. 日志可观测：标准日志路径 ~/.codex-logs/，支持 tail -f 实时监控
5. 进程可管控：独立的 start/stop/status 生命周期管理
潜在缺点与局限性
1. 安全风险极高：--dangerously-bypass-approvals-and-sandbox 完全禁用安全沙箱，代码可任意读写文件系统、执行命令
2. 网络依赖：需配置代理（翻墙）才能连接 OpenAI API
3. Git 仓库强制要求：目标目录必须是 git 仓库，增加前置成本
4. 调试困难：异步执行导致错误难以及时感知，需主动查日志
5. 资源占用：长时间运行消耗 API 配额和本地计算资源
6. 版本锁定：依赖特定版本 Codex CLI，未来 API 变更可能失效
适合人群
- 需要 Agent 自动化编码整夜运行 的开发者
- 追求 TDD + CI 自动化 的工程师团队
- 熟悉 Codex CLI、能自主评估安全风险的技术用户
- 有 海外网络环境 和 OpenAI API 配额的付费用户
不适合：安全敏感环境、生产服务器、无法监控日志的无人值守场景、对 AI 生成代码无审查能力的初学者。
常规风险
| 风险类型 | 说明 |
|---------|------|
| **代码注入** | 沙箱绕过使恶意提示可直接执行系统命令 |
| **数据泄露** | 代码上传至 OpenAI 服务器，敏感代码存在泄露风险 |
| **资源耗尽** | 无限循环或过度迭代导致 API 费用激增 |
| **文件损坏** | AI 错误操作可能覆盖或删除工作目录文件 |
| **合规问题** | `--dangerously-bypass...` 参数可能违反企业安全策略 |