codex-hook（Codex hook 开发）

核心脚本

Worktree 管理策略

复用逻辑：

• 关联任务（同一项目）→ 复用现有 worktree
• 独立任务 → 新建 worktree

合并命令：

# 1. 在 worktree 中提交
git add .
git commit -m "feat: 描述"

# 2. 推送分支
git push -u origin <branch>

# 3. 创建 PR（需要手动或用 gh）

## 架构

OpenClaw (编排层) → codex-hook (执行层) ↓ ↓ 拆解任务 并行执行 ↓ ↓ 子任务列表 tmux 隔离 ↓ ↓ 调用 codex-hook 监控+干预 ↓ 自动合并

## 依赖

- `bash` - 执行脚本
- `jq` - JSON 处理
- `tmux` - 任务隔离（可选）
- `gh` - GitHub CLI（自动合并需要）
- `codex` - Codex CLI
- `curl` - 发送通知

## 安装

脚本已位于：`~/.openclaw/skills/codex-hook/scripts/`

建议添加 alias 到 shell 配置：

~/.zshrc 或 ~/.bashrc

alias codex-tasks='bash ~/.openclaw/skills/codex-hook/scripts/codex-tasks.sh'

## 快速开始

1. 初始化

codex-tasks init

2. 执行任务（OpenClaw 拆解后调用）

codex-tasks execute parent-login '[{"name":"后端API","description":"实现登录API"},{"name":"前端","description":"实现登录页"}]'

3. 查看状态

codex-tasks status

## 核心文件

~/.openclaw/skills/codex-hook/scripts/ ├── codex-tasks.sh # 统一入口 ├── task-registry.sh # 任务注册表 ├── task-dispatcher.sh # 任务调度器 ├── auto-merge.sh # 自动 PR 创建、CI、检查、合并 ├── task-monitor.sh # 任务监控 └── task-splitter.sh # 任务拆解（预留）

## 命令说明

| 命令 | 简写 | 说明 | 示例 |
|------|------|------|------|
| `init` | `i` | 初始化任务系统 | `codex-tasks init` |
| `execute` | `run` | 接收子任务并执行 | `execute p1 '[{"name":"API"}]'` |
| `add-subtask` | `add` | 添加单个子任务 | `add p1 "API" "实现登录"` |
| `start` | - | 开始执行所有子任务 | `start p1` |
| `status` | `list` | 查看状态 | `status` / `status task-xxx` |
| `monitor` | `watch` | 实时监控面板 | `monitor` |
| `check` | - | 单次检查任务状态 | `check` |
| `intervene` | `send` | 干预任务 | `intervene t-xxx "消息"` |
| `stop` | `kill` | 停止任务 | `stop t-xxx` |
| `logs` | `log` | 查看日志 | `logs t-xxx` |
| `auto-merge` | `merge` | 自动合并 PR | `auto-merge t-xxx` |
| `report` | - | 汇报完成 | `report t-xxx` |
| `cleanup` | `clean` | 清理已完成任务 | `cleanup 10` |

## 工作流

### 1. OpenClaw 拆解任务

OpenClaw 负责分析需求，拆分为子任务列表：

[ {"name": "后端API开发", "description": "实现用户登录API"}, {"name": "前端页面", "description": "实现登录页面"}, {"name": "单元测试", "description": "编写登录相关测试"} ]

### 2. 调用 codex-hook 执行

方式一：一次性接收所有子任务

codex-tasks execute <parent_id> '<子任务JSON>' [workspace]

方式二：逐个添加子任务

codex-tasks add-subtask <parent_id> "任务名" "描述" codex-tasks add-subtask <parent_id> "任务名2" "描述2" codex-tasks start <parent_id> [workspace]

### 3. 监控与干预

查看所有任务

codex-tasks status

实时监控

codex-tasks monitor

干预任务（发送消息到 tmux）

codex-tasks intervene <task_id> "停下，先做X"

停止任务

codex-tasks stop <task_id>

查看日志

codex-tasks logs <task_id>

### 4. 自动合并与汇报

自动合并 PR (CI检查 → 代码审查 → 合并)

codex-tasks auto-merge <task_id> [repo]

汇报完成

codex-tasks report <task_id> [telegram]

清理已完成任务

codex-tasks cleanup [保留数量]

## 任务注册表

- 位置: `/tmp/codex-tasks/active-tasks.json`
- 包含: 所有任务状态、子任务关系、日志

直接查看 JSON

codex-tasks json

清理已完成任务

codex-tasks cleanup 10

## 查看任务输出

任务目录

ls /tmp/codex-results/tasks/<task_id>/

执行日志

cat /tmp/codex-results/tasks/<task_id>/output.log

任务提示词

cat /tmp/codex-results/tasks/<task_id>/prompt.txt

## 监控设置 (可选)

方式一：加载环境变量后启动监控

export $(cat ~/.openclaw/.env | xargs) && codex-tasks monitor-start 60 &

方式二：直接指定间隔

codex-tasks monitor-start 60 &

**注意**：需要先配置通知环境变量才能收到进度/完成通知。

## OpenClaw 集成示例

在 OpenClaw 中使用：

你: 实现用户登录功能

OpenClaw (拆解): → 分析需求，拆分为子任务 → 调用 codex-hook 执行 → 监控任务状态 → 自动合并 PR → 汇报完成

## 通知配置

### 方式一：环境变量文件

推荐将配置写入 `~/.openclaw/.env`：

~/.openclaw/.env

TELEGRAM_BOT_TOKEN="your-bot-token" TELEGRAM_CHAT_ID="your-chat-id" TELEGRAM_TOPIC_ID="123456" # 可选，Forum 话题 ID DISCORD_WEBHOOK="https://discord.com/api/webhooks/xxx" WEBHOOK_URL="https://your-webhook.com/hook" DEFAULT_CHANNEL="telegram"

启动监控时加载：

export $(cat ~/.openclaw/.env | xargs) && codex-tasks monitor-start

### 方式二：环境变量

Telegram (用户/群组/话题)

export TELEGRAM_BOT_TOKEN="your-bot-token" export TELEGRAM_CHAT_ID="your-chat-id" export TELEGRAM_TOPIC_ID="123456" # 可选，Forum 话题 ID

Discord

export DISCORD_WEBHOOK="https://discord.com/api/webhooks/xxx"

通用 Webhook

export WEBHOOK_URL="https://your-webhook.com/hook"

默认渠道

export DEFAULT_CHANNEL="telegram"

### 通知类型

| 事件 | 通知内容 |
|------|----------|
| 任务开始 | 任务ID、名称、时间 |
| 进度更新 | 进度条 (0-100%)、当前状态 |
| 任务完成 | 任务ID、名称、PR链接、时间 |
| 任务失败 | 任务ID、名称、错误信息 |
| 人工干预 | 干预消息 |

### 快速测试

测试发送

bash notify.sh send telegram "Hello"

测试进度条

bash notify.sh bar 50 "处理中..."

### tmux 不可用

⚠️ tmux 不可用，使用后台执行

- 解决：安装 tmux `brew install tmux`

### codex 命令找不到
- 解决：确保 codex 已安装并在 PATH 中

### gh 命令找不到 (自动合并)
- 解决：安装 GitHub CLI `brew install gh`

### Telegram 通知不工作
- 配置环境变量：

export TELEGRAM_BOT_TOKEN="your-bot-token" export TELEGRAM_CHAT_ID="your-chat-id"