codex-hook 是 OpenClaw 生态中专为 OpenAI Codex CLI 设计的异步任务调度与回调系统，解决 Codex 交互式执行的阻塞问题。核心架构采用"派发-执行-监听-回调"分离模式：dispatch-codex.sh 生成任务元数据并立即返回 task_id，不等待执行完成；runner.py 通过 sessions_spawn 启动隔离子会话；watcher.py 后台轮询检测完成状态，触发多通道通知。
显著优点：① 真异步非阻塞 — 任务提交后立即返回，适合 CI/CD 集成和批量并行处理；② 多通道回调 — 原生支持 Telegram、Webhook、AGI heartbeat 三种通知机制，可组合使用；③ Git 感知 — 自动捕获最近提交和修改文件，通知内容包含代码上下文；④ 状态持久化 — JSON/JSONL 格式存储任务全生命周期数据，支持 pending-wake.json 供外部 AGI 消费；⑤ 灵活配置 — 超时、并发、保留策略、输出截断均可调节。
潜在局限：① 生态依赖 — 紧密绑定 OpenClaw 的 sessions_spawn/sessions_list 机制，脱离该环境需大量适配；② 轮询开销 — 状态检测依赖轮询（默认5秒），非事件驱动；③ 并发控制未完全实现 — max_concurrent 配置存在但文档标注"not enforced yet"；④ 安全风险 — 任务输出可能含敏感信息，Webhook 需 HTTPS 但未强制校验；⑤ 单点故障 — watcher.py 守护进程若崩溃，任务完成事件可能丢失。
适合人群：需要批量/调度 Codex 任务的开发者、构建 AGI 工作流的架构师、追求 CI/CD 集成的工程团队。不适合单次临时使用 Codex 的用户。
常规风险：结果目录权限配置不当导致数据泄露；Webhook 未 HTTPS 传输敏感输出；任务输出截断导致关键信息丢失；长时间运行任务因超时被强制终止；AGI heartbeat 消费 pending-wake.json 时竞态条件导致重复处理。