clawclau

# ClawClau v2.0.0 — Claude Code 任务调度系统 小八（OpenClaw）派发异步 Claude Code 任务的工具集。基于 Elvis Sun 的 Agent Swarm 架构设计。 ## 核心文件 ``` <skills-dir>/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 "notify_chat = oc_xxxxxxxx" >> ~/.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] <task-id> "<prompt>" [workdir] --steerable 交互式模式（支持 claude-steer.sh 纠偏） --timeout <sec> 超时秒数（默认 600） --interval <sec> 进度汇报间隔，0=关闭（默认 180） --max-retries <n> 最大重试次数记录（默认 3） --model <name> Claude 模型名称 --parent <id> 父任务 ID（重试时使用） --retry-count <n> 当前重试计数（内部使用） ``` 示例： ```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 <task-id> # 单任务详情（含结果预览） ``` 以 tmux session 是否存活为 running 的最终判据，不调用 AI，不消耗 token。 ### claude-result.sh — 获取结果 ```bash claude-result.sh <task-id> # 从 stream-json 提取可读文本 claude-result.sh <task-id> --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 <task-id> # 终止 session，状态更新为 killed ``` ### claude-steer.sh — 中途纠偏 ```bash claude-steer.sh <task-id> "请聚焦在 X 方面" # 仅支持 --steerable 模式 ``` ## 参考文档 - 注册表字段、状态流转、环境变量：[references/schema.md](references/schema.md) - 设计原则、通知机制、重试流程、运行模式：[references/design.md](references/design.md)