無料GitHub で公開
octoclaw
OctoClaw is the TypeScript-first policy, delegation, status, and operator layer for OpenClaw. Use it when a turn should be routed through reply/delegate policy, WorkContract-backed delegation, runtime status, IM delivery, or feedback-loop tooling.
含まれるファイル（200）
- SKILL.md5.4 KB
- .github/GITHUB_SETUP.md926 B
- .github/ISSUE_TEMPLATE/bug_report.md572 B
- .github/ISSUE_TEMPLATE/config.yml413 B
- .github/ISSUE_TEMPLATE/feature_request.md402 B
- .github/PULL_REQUEST_TEMPLATE.md515 B
- .github/workflows/publish-capability-snapshot.yml2.3 KB
- .github/workflows/release.yml3.8 KB
- .github/workflows/test.yml705 B
- .gitignore435 B
- .npmrc55 B
- banner.png283.5 KB
- bin/update-openclaw-macmini.sh3.3 KB
- CHANGELOG.md2.5 KB
- CODE_OF_CONDUCT.md4.1 KB
- CONTRIBUTING.md2.9 KB
- docs/archive/design-notes/clawteam-integration-analysis-2026-03-25.md6.1 KB
- docs/archive/design-notes/deerflow-clawteam-open-source-analysis-2026-03-26.md17.2 KB
- docs/archive/design-notes/octoclaw-anthropic-agent-engineering-notes-v1-2026-03-30.md13.0 KB
- docs/archive/design-notes/octoclaw-anthropic-agent-engineering-notes-v1-2026-03-30.zh-CN.md13.0 KB
- docs/archive/design-notes/octoclaw-auto-router-design.md36.4 KB
- docs/archive/design-notes/octoclaw-auto-router-lite-cost-model-design-2026-05-08.md37.2 KB
- docs/archive/design-notes/octoclaw-auto-router-v3-algorithms.md28.3 KB
- docs/archive/design-notes/octoclaw-auto-router-v3-bdd.md26.5 KB
- docs/archive/design-notes/octoclaw-auto-router-v3-design-2026-05-13.md42.5 KB
- docs/archive/design-notes/octoclaw-auto-router-v3-handoff.md9.3 KB
- docs/archive/design-notes/octoclaw-clawteam-deerflow-source-notes-v1-2026-03-29.md16.1 KB
- docs/archive/design-notes/octoclaw-clawteam-unified-runtime-v1-2026-03-25.md10.6 KB
- docs/archive/design-notes/octoclaw-direction-analysis-2026-03-19.md45.7 KB
- docs/archive/design-notes/octoclaw-display-layer-productization-plan-v1-2026-03-29.md11.9 KB
- docs/archive/design-notes/octoclaw-feedback-loop-contracts.md7.2 KB
- docs/archive/design-notes/octoclaw-grayzone-routing-design-v1-2026-03-27.md10.3 KB
- docs/archive/design-notes/octoclaw-legacy-core-removal-roadmap-v1-2026-03-29.md9.6 KB
- docs/archive/design-notes/octoclaw-model-health-cooldown-design-v1-2026-03-29.md7.2 KB
- docs/archive/design-notes/octoclaw-n1-runtime-ledger-implementation-plan-2026-05-01.md29.8 KB
- docs/archive/design-notes/octoclaw-openclaw-task-flow-analysis-v1-2026-04-01.md3.6 KB
- docs/archive/design-notes/octoclaw-openclaw-task-flow-migration-plan-v1-2026-04-01.md3.6 KB
- docs/archive/design-notes/octoclaw-phase5-auto-router-design-2026-04-30.md27.1 KB
- docs/archive/design-notes/octoclaw-product-design-v2-2026-03-27.md59.6 KB
- docs/archive/design-notes/octoclaw-repo-debt-cleanup-plan-2026-05-09.md6.6 KB
- docs/archive/design-notes/octoclaw-review-and-action-plan-v1-2026-04-02.md19.0 KB
- docs/archive/design-notes/octoclaw-roadmap-multi-agent-cost-speed-2026-03-20.md43.8 KB
- docs/archive/design-notes/octoclaw-runtime-borrowings-execution-v1-2026-03-30.md4.7 KB
- docs/archive/design-notes/octoclaw-runtime-convergence-cleanup-plan-2026-05-07.md44.5 KB
- docs/archive/design-notes/octoclaw-state-convergence-4-4-design.md7.1 KB
- docs/archive/design-notes/octoclaw-state-machine-remediation-v1-2026-03-29.md13.7 KB
- docs/archive/design-notes/octoclaw-strategy-summary-2026-03-26.md11.0 KB
- docs/archive/design-notes/octoclaw-task-display-schema-v1-2026-03-29.md8.6 KB
- docs/archive/design-notes/octoclaw-v0.6.0-handoff.md8.4 KB
- docs/archive/design-notes/octoclaw-work-contract-centered-delegation-design-2026-04-25.md32.7 KB
- docs/archive/design-notes/octoclaw-worker-taxonomy-migration-v1-2026-03-28.md5.4 KB
- docs/archive/design-notes/README.md7.7 KB
- docs/archive/engineering-log/eval/reports/eval-report-20260320-235341.json2.3 KB
- docs/archive/engineering-log/eval/reports/eval-report-20260320-235341.md1.1 KB
- docs/archive/engineering-log/omx/plans/prd-octoclaw-p1-runtime-mind.md14.0 KB
- docs/archive/engineering-log/omx/plans/prd-octoclaw-p2-feedback-loop.md1.8 KB
- docs/archive/engineering-log/omx/plans/test-spec-octoclaw-p1-runtime-mind.md4.3 KB
- docs/archive/engineering-log/omx/plans/test-spec-octoclaw-p2-feedback-loop.md962 B
- docs/archive/engineering-log/planning/config.json2.8 KB
- docs/archive/engineering-log/planning/phases/01-rebuild-baseline-alignment/01-01-PLAN.md4.0 KB
- docs/archive/engineering-log/planning/phases/01-rebuild-baseline-alignment/01-01-SUMMARY.md4.2 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-01-PLAN.md7.8 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-01-SUMMARY.md5.0 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-02-PLAN.md8.7 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-02-SUMMARY.md6.1 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-03-PLAN.md9.4 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-03-SUMMARY.md6.0 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-04-PLAN.md12.4 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-04-SUMMARY.md9.1 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-CONTEXT.md4.2 KB
- docs/archive/engineering-log/planning/phases/02-runtime-core-and-safe-delegation/02-VERIFICATION.md13.0 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-01-PLAN.md12.4 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-01-SUMMARY.md8.4 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-02-PLAN.md10.4 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-02-SUMMARY.md5.6 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-03-PLAN.md10.2 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-03-SUMMARY.md8.0 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-04-PLAN.md15.1 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-04-SUMMARY.md6.2 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-CONTEXT.md5.4 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-RESEARCH.md10.3 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-VALIDATION.md3.7 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/03-VERIFICATION.md15.3 KB
- docs/archive/engineering-log/planning/phases/03-native-substrate-and-operator-surfaces/deferred-items.md2.1 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-01-PLAN.md9.4 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-01-SUMMARY.md5.9 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-02-PLAN.md10.4 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-02-SUMMARY.md9.3 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-03-PLAN.md10.3 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-03-SUMMARY.md4.6 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-PATTERNS.md2.3 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-RESEARCH.md8.0 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/04-VALIDATION.md3.7 KB
- docs/archive/engineering-log/planning/phases/04-eval-gates-and-advanced-routing/deferred-items.md749 B
- docs/archive/engineering-log/planning/phases/05-execution-substrate-refactor/05-01-PLAN.md10.1 KB
- docs/archive/engineering-log/planning/phases/05-execution-substrate-refactor/05-01-SUMMARY.md7.5 KB
- docs/archive/engineering-log/planning/phases/05-execution-substrate-refactor/05-02-PLAN.md14.0 KB
- docs/archive/engineering-log/planning/phases/05-execution-substrate-refactor/05-02-SUMMARY.md7.7 KB
- docs/archive/engineering-log/planning/phases/05-execution-substrate-refactor/05-CONTEXT.md6.3 KB
- docs/archive/engineering-log/planning/phases/05-execution-substrate-refactor/05-PLAN.md9.6 KB
- docs/archive/engineering-log/planning/phases/05-execution-substrate-refactor/05-SUMMARY.md6.8 KB
- docs/archive/engineering-log/planning/REQUIREMENTS.md3.8 KB
- docs/archive/engineering-log/planning/ROADMAP.md7.7 KB
- docs/archive/engineering-log/planning/STATE.md9.4 KB
- docs/archive/engineering-log/README.md584 B
- docs/archive/engineering-log/reports/reply-review-validation/2026-04-02.md5.3 KB
- docs/archive/engineering-log/reports/reply-review-validation/2026-04-03-macmini-replay-validation.md4.3 KB
- docs/archive/engineering-log/reports/reply-review-validation/2026-04-05.md522 B
- docs/archive/engineering-log/reports/reply-review-validation/2026-04-08.md4.4 KB
- docs/archive/engineering-log/reports/reply-review-validation/packets/2026-04-02.json96.0 KB
- docs/archive/engineering-log/reports/reply-review-validation/packets/2026-04-05.json2 B
- docs/archive/engineering-log/reports/reply-review-validation/packets/2026-04-08.json88.4 KB
- docs/archive/engineering-log/reports/reply-review/2026-04-02.md6.1 KB
- docs/archive/engineering-log/reports/reply-review/2026-04-04.md2.1 KB
- docs/archive/engineering-log/reports/reply-review/packets/2026-04-02.prompt.md18.2 KB
- docs/archive/engineering-log/reports/reply-review/packets/2026-04-04.prompt.md922 B
- docs/archive/engineering-log/reports/slack-acceptance/2026-05-02-planner-native-harnessfix.md1.8 KB
- docs/archive/engineering-log/sisyphus/evidence/task-0-cli-validation.txt1.7 KB
- docs/archive/engineering-log/sisyphus/notepads/ack-fix-wechat-feishu-adapters/decisions.md396 B
- docs/archive/engineering-log/sisyphus/notepads/ack-fix-wechat-feishu-adapters/issues.md11 B
- docs/archive/engineering-log/sisyphus/notepads/ack-fix-wechat-feishu-adapters/learnings.md663 B
- docs/archive/engineering-log/sisyphus/notepads/ack-fix-wechat-feishu-adapters/problems.md13 B
- docs/archive/engineering-log/sisyphus/plans/ack-fix-wechat-feishu-adapters.md43.2 KB
- docs/archive/engineering-log/sisyphus/plans/judge-fast-implementation-plan.md16.2 KB
- docs/archive/judge-fast-implementation-plan.md19.6 KB
- docs/archive/octoclaw-ack-decision-truth-table-2026-04-21.md5.6 KB
- docs/archive/octoclaw-ack-delegation-evaluation-harness-plan-2026-04-26.md12.6 KB
- docs/archive/octoclaw-ack-state-source-matrix-2026-04-21.md6.0 KB
- docs/archive/octoclaw-ack-thread-delivery-spec-2026-04-21.md3.7 KB
- docs/archive/octoclaw-architecture-diagnosis-and-refactor-plan-2026-04-29.md74.5 KB
- docs/archive/octoclaw-auto-router-boundary-map.md4.4 KB
- docs/archive/octoclaw-auto-router-implementation-checklist.md19.3 KB
- docs/archive/octoclaw-auto-router-package-layout.md4.9 KB
- docs/archive/octoclaw-calibration-gate-2026-04-26.md4.0 KB
- docs/archive/octoclaw-code-audit-2026-04-12.md4.7 KB
- docs/archive/octoclaw-codebase-assessment-2026-04-08.md9.6 KB
- docs/archive/octoclaw-codex-handoff-prompt.md30.0 KB
- docs/archive/octoclaw-delegate-runtime-gap-closure-2026-04-22.md12.8 KB
- docs/archive/octoclaw-design-refresh-2026-04-12.md20.7 KB
- docs/archive/octoclaw-detached-runtime-integration-2026-04-22.md2.7 KB
- docs/archive/octoclaw-dispatch-latency-preload-design-2026-05-03.md40.9 KB
- docs/archive/octoclaw-execution-plan.md38.7 KB
- docs/archive/octoclaw-fast-delegate-before-dispatch-design-2026-05-02.md42.1 KB
- docs/archive/octoclaw-harness-contract-inventory.md5.1 KB
- docs/archive/octoclaw-harness-ownership-map.md4.5 KB
- docs/archive/octoclaw-judge-ack-implementation-handoff-2026-04-21.md6.0 KB
- docs/archive/octoclaw-judge-dispatch-complexity-improvement-2026-05-01.md36.0 KB
- docs/archive/octoclaw-n1-runtime-ledger-repair-packet-2026-05-01.md16.9 KB
- docs/archive/octoclaw-native-slimming-implementation-plan-2026-05-01.md102.1 KB
- docs/archive/octoclaw-native-taskflow-and-agent-runtime-borrowings-2026-04-20.md29.6 KB
- docs/archive/octoclaw-next-phase-roadmap-2026-04-30.md14.8 KB
- docs/archive/octoclaw-next-stage-roadmap-and-execution-design-2026-04-25.md46.3 KB
- docs/archive/octoclaw-nightly-eval-scheduler-2026-04-26.md5.9 KB
- docs/archive/octoclaw-openclaw-native-slimming-review-2026-05-01.md61.1 KB
- docs/archive/octoclaw-p3-p4-post-signoff-handoff.md2.4 KB
- docs/archive/octoclaw-phase1-stabilization-design-2026-04-29.md16.3 KB
- docs/archive/octoclaw-phase2-lightweight-install-design-2026-04-30.md4.2 KB
- docs/archive/octoclaw-receipt-projection-followup-fix-2026-04-28.md2.4 KB
- docs/archive/octoclaw-refactor-acceptance-audit-2026-04-11.md8.6 KB
- docs/archive/octoclaw-refactor-impl-guide-2026-04-29.md77.2 KB
- docs/archive/octoclaw-reflection-and-recovery-plan-2026-04-10.md15.7 KB
- docs/archive/octoclaw-router-model-intel-deepening-design.md10.6 KB
- docs/archive/octoclaw-router-policy-refactor-2026-04-10.md38.3 KB
- docs/archive/octoclaw-router-policy-refactor-plan-2026-04-10.md29.7 KB
- docs/archive/octoclaw-runtime-slimming-plan-2026-04-12.md10.2 KB
- docs/archive/octoclaw-slack-acceptance-harness-2026-04-26.md5.8 KB
- docs/archive/octoclaw-slack-acceptance-results-2026-04-12.md16.9 KB
- docs/archive/octoclaw-slack-production-acceptance-2026-04-11.md9.8 KB
- docs/archive/octoclaw-transition-cleanup-design.md9.9 KB
- docs/archive/octoclaw-ts-rebuild-design-draft-2026-04-15.md55.6 KB
- docs/archive/octoclaw-ts-rebuild-design-v1.md219.7 KB
- docs/archive/octoclaw-ts-rebuild-gap-closure-implementation-plan-2026-04-24.md40.5 KB
- docs/archive/octoclaw-ts-rebuild-implementation-plan-2026-04-15.md41.3 KB
- docs/archive/octoclaw-work-contract-implementation-plan-2026-04-25.md21.5 KB
- docs/archive/openclaw-prep-performance-upstream-design-2026-05-06.md45.2 KB
- docs/archive/README.md2.3 KB
- docs/evals/judge-model-eval-2026-05-20.md13.1 KB
- docs/octoclaw-ai-install-runbook.md7.7 KB
- docs/octoclaw-architecture-map-2026-05-09.md14.6 KB
- docs/octoclaw-auto-router-v3-supplement-2026-05-15.md24.3 KB
- docs/octoclaw-auto-router-v3.2-health-loop-2026-05-16.md19.9 KB
- docs/octoclaw-design-foundation.md41.5 KB
- docs/octoclaw-im-display-contract.md6.7 KB
- docs/octoclaw-improvement-plan-2026-05-12.md23.8 KB
- docs/octoclaw-judge-ack-policy-spec-2026-04-21.md20.0 KB
- docs/octoclaw-local-deploy-guide.md4.7 KB
- docs/octoclaw-migration-onboarding-feishu-guide.md9.4 KB
- docs/octoclaw-release-checklist.md5.0 KB
- docs/octoclaw-role-terminology.md6.6 KB
- docs/octoclaw-router-user-guide.md7.2 KB
- docs/octoclaw-runtime-gate-convergence-design-2026-05-12.md27.0 KB
- docs/octoclaw-timeout-watchdog-evidence-design-2026-05-12.md11.4 KB
- docs/octoclaw-ts-rebuild-design-v2.md37.6 KB
- docs/octoclaw-v0.6.0-roadmap-2026-05-13.md8.1 KB
- docs/release-checklist.md4.4 KB
- docs/release-notes-v0.6.0.md5.5 KB
- docs/stability-smoke-v2-scheduling.md6.1 KB
- docs/superpowers/plans/2026-05-16-autorouter-v3-2-health-loop.md5.5 KB
- docs/superpowers/plans/2026-05-20-stability-smoke-case-completion.md3.7 KB
- docs/superpowers/plans/2026-05-22-migration-release-readiness.md5.8 KB
SKILL.md（原文）
インストールする前に、エージェントに与えられる指示の中身を確認できます。
OctoClaw Runtime Skill
This skill describes the current v0.6.0 runtime line. It intentionally does
not describe the old Python octoclaw_spawn.py, completion-file finalizer, or
JSON delivery-outbox runtime. Those were historical mechanisms and must not be
reintroduced as compatibility paths.
Current Authority
| Layer | Authority |
|---|---|
| live route | `reply |
| execution lifecycle | OpenClaw native TaskFlow / sessions_spawn / native announce |
| OctoClaw metadata | SQLite runtime ledger: WorkContract, route seal, native refs, spawn intent, audit events |
| status display | generated projection from metadata + native lifecycle |
task-state.json | rebuildable read-model cache, not truth |
| replay log | observability and evaluation evidence, not runtime truth |
Main-Agent Rules
- For direct answers, use
reply; do not create work. - For delegated work, call
octoclaw_dispatch; do not hand-write spawn args. - After native spawn is accepted, confirm with
octoclaw_dispatch_confirm. - For status/provenance/follow-up questions, use
octoclaw_statusoroctoclaw_task_action; do not dispatch new work just to explain old work. - Do not call or recreate
octoclaw_spawn. - Do not use completion files, child-finalizer recovery, or JSON delivery outbox as the normal final-delivery mechanism.
- Do not treat
task-state.jsonas durable truth. Missing or corrupt task-state must be rebuilt or reported degraded. - Do not inject raw child transcripts into the parent context.
Tool Use
| Tool | Use |
|---|---|
octoclaw_route_hint | Ask the runtime for route guidance before model/tool escalation. |
octoclaw_policy_decide / octoclaw_route | Resolve policy and route facts. |
octoclaw_dispatch | Create a WorkContract-backed delegation plan and native spawn intent. |
octoclaw_dispatch_confirm | Bind accepted native runId / childSessionKey evidence back to OctoClaw metadata. |
octoclaw_task_action | Read task details, queue, artifacts, or supported task operations. |
octoclaw_status | Render status/details/queue/timeline from projection. |
Auto Router Commands
| Command | Use |
|---|---|
octoclawctl router wizard [--incremental] [--config answers.json] | Create or update local router plan/budget/privacy/language/restricted/same-provider config. |
octoclawctl router promotion review [--input shadow.jsonl] | Evaluate local shadow samples and append promotion decisions. |
octoclawctl router decisions [--since 7d] | Inspect shadow-to-live promotion decisions. |
octoclawctl router cost report [--period 7d] | Review local cost grouped by model, complexity, and route, including prediction and budget status. |
octoclawctl router cost budget set --monthly <usd> | Store the local monthly router budget. |
octoclawctl router score override <model> <tier>=<score> | Override a model score for a complexity tier. |
octoclawctl router model mark <model> --dispreferred-for <tier> | Soft-avoid a model for a tier. |
octoclawctl router model ban <model> --for <tier> | Hard-exclude a model for a tier. |
Delegation Contract
Delegated work must carry:
- WorkContract id and route seal.
- scope and allowed tools.
- role / worker-pool / model profile metadata.
- native spawn intent id.
- accepted native refs after confirm.
- status projection derived from native lifecycle and OctoClaw metadata.
spawnExecuted=true requires accepted native run evidence. A child session key by
itself is only a reference; it is not execution proof.
Status Questions
These are status-surface requests, not new work:
- "OctoClaw status"
- "task status"
- "which task is running?"
- "why did it not dispatch?"
- "who handled the previous task?"
- "show queue/details/timeline"
Answer through octoclaw_status or octoclaw_task_action. If no verifiable
record exists, say that clearly and do not invent a task.
Current Docs
README.md/README.zh-CN.md: operator-facing overview.docs/octoclaw-architecture-map-2026-05-09.md: detailed module graph.docs/octoclaw-ts-rebuild-design-v2.md: architecture baseline.docs/octoclaw-runtime-convergence-cleanup-plan-2026-05-07.md: runtime cleanup handoff.docs/octoclaw-repo-debt-cleanup-plan-2026-05-09.md: archive/version/terminology cleanup.docs/archive/: historical material only.
Forbidden Legacy Paths
Do not reintroduce these as product runtime behavior:
octoclaw_spawnas a public tool or alias.- plugin
runtime.subagent.run()fallback. - fake detached runtime capability registration.
- child completion files as normal final protocol.
- child-finalizer recovery loop.
- JSON delivery outbox for new planner/native runtime tasks.
- resident runner / tmux / ClawTeam as required substrate.
レビュー
まだレビューはありません。使ってみた感想をお寄せください。