ClawClau v2.0.0 — Claude Code 任务调度系统

小八（OpenClaw）派发异步 Claude Code 任务的工具集。基于 Elvis Sun 的 Agent Swarm 架构设计。

核心文件

/clawclau/scripts/ # 安装后脚本位置
├── clawclau-lib.sh # 共享库（所有脚本 source 此文件）
├── claude-spawn.sh # 派发任务（含内嵌完成检测器和进度汇报器）
├── claude-check.sh # 查询状态（确定性，不耗 token）
├── claude-result.sh # 获取结果
├── claude-monitor.sh # 批量监控安全兜底（cron 用）
├── claude-kill.sh # 终止任务
└── claude-steer.sh # 中途纠偏

~/.clawclau/
├── active-tasks.json # 任务注册表（source of truth）
├── config # 本地配置（notify_chat 等）
├── logs/
│ ├── task-id.json # stream-json 格式日志（print 模式）
│ └── task-id.txt # 纯文本日志（steerable 模式）
└── prompts/
├── task-id.txt # prompt 备份
└── task-id-wrapper.sh # 自动生成的 wrapper 脚本

安装与配置

bash

依赖

brew install tmux jq && which claude

初始化

mkdir -p ~/.clawclau/logs ~/.clawclau/prompts

配置通知（可选）

echo notifychat = ocxxxxxxxx >> ~/.clawclau/config

shell profile（可选）

export CC_SCRIPTS=~/.openclaw/workspace/skills/clawclau/scripts

快速开始

bash
SCRIPTS=~/.openclaw/workspace/skills/clawclau/scripts

1. 派发任务

$SCRIPTS/claude-spawn.sh my-task 请整理这份文档... /path/to/workdir

2. 查看所有任务

$SCRIPTS/claude-check.sh

3. 查看单个任务详情

$SCRIPTS/claude-check.sh my-task

4. 获取完整结果

$SCRIPTS/claude-result.sh my-task

5. 终止任务

$SCRIPTS/claude-kill.sh my-task

脚本接口

claude-spawn.sh — 派发任务

bash
claude-spawn.sh [OPTIONS] [workdir]

--steerable 交互式模式（支持 claude-steer.sh 纠偏）
--timeout 超时秒数（默认 600）
--interval 进度汇报间隔，0=关闭（默认 180）
--max-retries 最大重试次数记录（默认 3）
--model Claude 模型名称
--parent 父任务 ID（重试时使用）
--retry-count 当前重试计数（内部使用）

示例：

bash

带进度汇报（每 60s 通知一次）

$SCRIPTS/claude-spawn.sh research-task 调研XXX行业趋势 ~/.openclaw/workspace \
--interval 60 --timeout 1200

交互式模式（可中途纠偏）

$SCRIPTS/claude-spawn.sh explore-task 探索代码库，找出主要问题 ~/myproject \ --steerable --interval 120

指定模型

$SCRIPTS/claude-spawn.sh heavy-task 复杂分析任务... . \ --model claude-opus-4-6 --timeout 1800

spawn 内嵌双重 fork 后台完成检测器，任务结束时自动调用 cc_notify 通知小八。

claude-check.sh — 查询状态

bash
claude-check.sh # 列出所有任务（表格）
claude-check.sh # 单任务详情（含结果预览）

以 tmux session 是否存活为 running 的最终判据，不调用 AI，不消耗 token。

claude-result.sh — 获取结果

bash
claude-result.sh # 从 stream-json 提取可读文本
claude-result.sh --raw # 输出原始 stream-json 日志

claude-monitor.sh — 批量监控（cron 用）

bash

设置 cron（每 10 分钟）

/10 * $SCRIPTS/claude-monitor.sh >> /tmp/clawclau-monitor.log 2>&1

claude-kill.sh — 终止任务

bash
claude-kill.sh # 终止 session，状态更新为 killed

claude-steer.sh — 中途纠偏

bash
claude-steer.sh 请聚焦在 X 方面 # 仅支持 --steerable 模式

参考文档

• - 注册表字段、状态流转、环境变量：references/schema.md
• 设计原则、通知机制、重试流程、运行模式：references/design.md