Aitishiku.com1. 📌 Skill 基础信息
Skill 名称: octoclaw
简称: OctoClaw
来源: 社区第三方 (guanbear)
运行宿主: OpenClaw Agent
核心定位: 作为 TypeScript 优先的策略调度、委派管理和状态操作层，专门用于处理任务路由决策、工作委派合约管理及运行时状态监控。
2. 🧩 内部核心组成
子Agent集合
- 无独立子Agent，作为OpenClaw的策略调度层运行
MCP工具集
| 工具名称 | 功能简述 |
|---|---|
octoclaw_route_hint | 提供路由决策前的运行时指导 |
octoclaw_policy_decide | 策略决策和路由事实解析 |
octoclaw_dispatch | 创建基于WorkContract的委派计划和原生生成意图 |
octoclaw_dispatch_confirm | 将接受的运行证据绑定到OctoClaw元数据 |
octoclaw_task_action | 读取任务详情、队列、工件或执行任务操作 |
octoclaw_status | 从投影中呈现状态/详情/队列/时间线 |
斜杠命令集
| 命令名称 | 功能简述 |
|---|---|
octoclawctl router wizard | 创建或更新本地路由配置 |
octoclawctl router promotion review | 评估本地影子样本并追加升级决策 |
octoclawctl router decisions | 检查影子到生产的升级决策 |
octoclawctl router cost report | 查看按模型和复杂度分组的成本报告 |
octoclawctl router cost budget set | 设置本地月度路由预算 |
octoclawctl router score override | 覆盖特定复杂度层级的模型评分 |
octoclawctl router model mark | 对特定层级软性避免某模型 |
octoclawctl router model ban | 对特定层级硬性排除某模型 |
目录结构
docs/: 架构文档和设计文档docs/archive/: 历史资料存档- SQLite运行时账本存储元数据
3. 🛠 安装与启用方式
安装命令:
skills install --user guanbear/OctoClaw前置依赖:
- OpenClaw Agent 运行环境
- SQLite 数据库支持
启动方式:
- 安装后自动集成到OpenClaw运行时
- 通过工具调用和命令行指令使用
4. 📋 标准工作流
- 用户输入指令到OpenClaw主Agent
- 路由决策: 通过
octoclaw_route_hint获取路由指导 - 策略解析: 使用
octoclaw_policy_decide确定回复或委派策略 - 委派执行: 如需委派，调用
octoclaw_dispatch创建WorkContract - 确认绑定: 原生任务生成后，通过
octoclaw_dispatch_confirm绑定运行证据 - 状态监控: 使用
octoclaw_status或octoclaw_task_action查询任务状态 - 结果返回: 通过状态投影呈现最终结果
5. ⚠️ 关键限制、缺陷、注意事项
平台限制:
- 仅支持OpenClaw Agent环境
- 不支持其他Agent工具（Claude、Cursor、MCP等）
数据可靠性:
task-state.json为可重建的读取模型缓存，非持久化事实- 缺失或损坏的任务状态需要重建或报告降级状态
生产环境适用性:
- 当前版本标记为不稳定（stable: false）
- 不建议直接用于生产环境关键任务
已知限制:
- 不支持历史兼容路径（octoclaw_spawn.py、完成文件终结器等）
- 禁止将原始子会话记录注入父上下文
6. ✅ 适用场景 & ❌ 不适合场景
✅ 适用场景
- OpenClaw环境中的复杂任务路由和委派管理
- 需要工作合约支持的规范化任务委派
- 多模型路由决策和成本预算管理
- 运行时状态监控和任务生命周期管理
❌ 不适合场景
- 非OpenClaw Agent环境
- 简单的直接问答任务（应使用原生回复功能）
- 需要历史兼容性路径的项目
- 生产环境关键任务（当前版本不稳定）
如何安装
skills install --user guanbear/OctoClaw通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。