一个异步 AI 代理编排技能，可在后台执行耗时较长的编码、研究和自动化任务，并将结果发送至移动消息应用。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install codex-cli-task
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 codex-cli-task。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Codex CLI Task (Async)？
Codex CLI Task 是专为 Openclaw Skills 生态系统设计的复杂后台编排工具。它允许开发人员将复杂的、多步骤的任务（如代码库重构、深度研究和自动化文件生成）卸载到分离的 OpenAI Codex 进程中。通过 shell 异步运行，它确保主代理在执行阶段以零活跃 token 成本执行繁重工作时保持响应。
该技能专为可靠性和开发者友好的可见性而设计。它具有强大的通知管道，可将心跳、任务中期进度更新和最终结果直接传送到 Telegram 线程或 WhatsApp 群组。它将 AI 视为具有完整文件系统访问权限和 shell 执行能力的通用代理，非常适合简单聊天界面不足以满足技术深度要求的场景。
Codex CLI Task (Async) 应用场景
- 自主研究：执行网络搜索、竞品分析和 UX 报告综合。
- 代码库工程：执行大规模重构、脚本创建和 API 开发。
- 技术分析：深入研究日志、源代码和数据文件以提取可行见解。
- 复杂自动化：管理涉及文件系统访问和外部工具执行的多阶段工作流。
- 耗时任务：卸载超出标准 API 超时限制或需要持久状态的进程。
Codex CLI Task (Async) 工作原理
- 启动前规划：代理在聊天中发布简短策略，明确假设和预期结果。
- 安全提示：任务提示保存到本地临时文件，以防止 shell 参数解析错误。
- 分离执行：该技能使用
nohup启动run-task.py，将进程从当前 OpenClaw 会话中分离。 - 实时监控：心跳系统每 60 秒向交付渠道发送一次 ping，而 Codex 可以通过注入的通知脚本发送任务中期更新。
- 完成与唤醒：完成后，该技能将最终结果交付至配置的渠道，并触发代理唤醒事件以汇总调查结果。
Codex CLI Task (Async) 配置指南
确保您的系统上安装了 codex 和 python3。配置需要在 Openclaw Skills 框架中设置您的网关身份验证 token 和会话可见性。
# Standard Telegram thread-safe launch
nohup python3 run-task.py \
--task "$(cat /tmp/prompt.txt)" \
--project ~/my-project \
--session "agent:main:main:thread:THREAD_ID" \
--timeout 900 \
> /tmp/codex-run.log 2>&1 &
Codex CLI Task (Async) 数据架构与分类体系
该技能管理持久数据和元数据以确保会话连续性和崩溃恢复：
| File Path | Description |
|---|---|
~/.openclaw/codex_sessions.json |
所有 Codex 线程 ID、标签和状态的注册表。 |
skills/codex-cli-task/pids/ |
跟踪用于生命周期管理的活跃进程 ID 的目录。 |
/tmp/codex-orchestrator-state-<hash>.json |
每个项目的状态文件，用于防止重复的唤醒事件。 |
/tmp/codex-notify-{pid}.py |
生成的临时脚本，允许 Codex 发送任务中期更新。 |
/tmp/codex-YYYYMMDD-HHMMSS.txt |
捕获的 Codex 执行的最终输出。 |
Codex CLI Task (Async) 高级特性
- 会话恢复：通过
--resume标志传递特定的 Codex thread_id 来继续之前的 AI 对话。 - 线程安全路由：严格的 Telegram 路由确保通知始终落在正确的论坛主题或 DM 线程中。
- 迭代延续：支持
iterate模式，代理会自动评估差距并启动后续阶段。 - E2E 验证：内置
--validate-only模式，在提交长时间运行之前验证路由和会话元数据。 - 快速失败逻辑：自动检测无效路由或未解析的会话 UUID，以防止静默路由错误。
SKILL.md
加载中
Openclaw 相关技能
Git Commit Helper
一个 AI 驱动的工具，用于按照 Conventional Commits 格式生成标准化、专业的 git 提交信息。
精选*
