Claw Orchestrator Skill
Claw Orchestrator — persistent multi-engine coding session manager for claw-style agent systems. Runs as a standalone CLI/server, with first-class OpenClaw plugin support. Wraps Claude Code, Codex, Antigravity, Cursor Agent, OpenCode, and custom CLIs into headless agentic engines with 69 tools.
Engine Quick Reference
| Engine |
CLI |
Session Type |
Best For |
claude |
claude |
Persistent subprocess |
Multi-turn, complex tasks |
codex |
codex exec |
Per-message spawn |
One-shot execution |
agy |
agy -p |
Per-message spawn |
Google Antigravity; plain-text, auto conversation resume |
cursor |
agent -p |
Per-message spawn |
One-shot execution |
opencode |
opencode run |
Per-message spawn |
Provider-agnostic (provider/model) |
Core Workflow
// 1. Start session (any engine)
session_start({ name: "myproject", cwd: "/path/to/project", engine: "claude" })
session_start({ name: "codex-task", cwd: "/path/to/project", engine: "codex" })
session_start({ name: "agy-task", cwd: "/path/to/project", engine: "agy" })
session_start({ name: "cursor-task", cwd: "/path/to/project", engine: "cursor" })
session_start({ name: "opencode-task", cwd: "/path/to/project", engine: "opencode", model: "anthropic/claude-sonnet-4" })
// 2. Send messages
session_send({ name: "myproject", message: "Fix the auth bug" })
// 3. Check status / search history
coding_session_status({ name: "myproject" })
session_grep({ name: "myproject", pattern: "error" })
// 4. Stop when done
session_stop({ name: "myproject" })
Session Options
| Parameter |
Description |
engine |
claude (default), codex, agy, cursor, opencode |
model |
Model name or alias (fable, opus, sonnet, haiku, gpt-5.5, agy-pro, composer-2) |
permissionMode |
acceptEdits, auto, plan, bypassPermissions, manual, dontAsk (default = legacy alias for manual) |
effort |
low, medium, high, xhigh, max, auto (xhigh is Opus 4.7-only, between high and max) |
maxBudgetUsd |
Cost limit in USD |
allowedTools |
List of allowed tool names |
CLI 2.1.111 options
| Parameter |
Description |
bare |
Minimal mode — no CLAUDE.md, hooks, LSP, auto-memory. Auto-enables prompt cache optimizations (see below). |
includeHookEvents |
Stream hook lifecycle events (PreToolUse/PostToolUse). |
forwardSubagentText |
Forward subagent text and thinking into the output stream, so sessions that fan out surface intermediate output instead of going quiet. |
permissionPromptTool |
Delegate permission prompts to an MCP tool for non-interactive use. |
excludeDynamicSystemPromptSections |
Move cwd/env/git from system prompt to user message for better prompt cache hits. Auto-enabled with bare: true. |
enablePromptCaching1H |
Enable 1-hour prompt cache TTL (vs default 5-min). Auto-enabled with bare: true. |
debug / debugFile |
Targeted debug output by category (e.g. "api,mcp") and optional file path. |
fromPr |
Resume a session linked to a GitHub PR number or URL. |
channels / dangerouslyLoadDevelopmentChannels |
MCP channel subscriptions (research preview). |
CLI 2.1.121 options
| Parameter |
Description |
forkSubagent |
Fork subagent for non-interactive sessions (sets CLAUDE_CODE_FORK_SUBAGENT=1). |
enableToolSearch |
Enable Vertex AI tool search (sets ENABLE_TOOL_SEARCH=1). |
otelLogUserPrompts |
OpenTelemetry: include user prompts in logs (sets OTEL_LOG_USER_PROMPTS=1). |
otelLogRawApiBodies |
OpenTelemetry: include raw API bodies in logs (sets OTEL_LOG_RAW_API_BODIES=1). Debug only. |
stats.pluginErrors is now populated from the system/init event when CLI plugins fail to load due to unmet dependencies.
TRACEPARENT / TRACESTATE (W3C distributed tracing) are automatically forwarded from parent process env — set them before starting the session and they propagate to the child Claude CLI.
Smart defaults: When bare: true, the plugin auto-enables --exclude-dynamic-system-prompt-sections and ENABLE_PROMPT_CACHING_1H=1 unless explicitly set to false.
Multi-Agent Council
Parallel agent collaboration with git worktree isolation and consensus voting. Agents can use different engines.
// Start a council
council_start({
task: 'Build a REST API',
agents: [
{ name: 'Architect', emoji: '🏗️', persona: 'System design', engine: 'claude' },
{ name: 'Engineer', emoji: '⚙️', persona: 'Implementation', engine: 'codex' },
],
maxRounds: 5,
projectDir: '/path/to/project',
});
Council lifecycle: council_start → poll council_status → council_review → council_accept or council_reject.
For details: see references/council.md
Cross-Session Messaging
Sessions can communicate. Idle sessions receive immediately; busy sessions queue.
session_send_to({ from: "sender", to: "receiver", message: "Auth module needs rate limiting" })
session_send_to({ from: "monitor", to: "*", message: "Build failed!" }) // broadcast
session_inbox({ name: "receiver" })
session_deliver_inbox({ name: "receiver" })
Team Tools (All Engines)
All engines use the same virtual-team layer: cross-session inbox routing across active SessionManager sessions. (Claude Code's native experimental Agent Teams is in-process TUI only and not reachable from a subprocess wrapper.)
team_list({ name: "myproject" })
team_send({ name: "myproject", teammate: "teammate", message: "Review this" })
Ultraplan & Ultrareview
- Ultraplan: Opus deep planning session (up to 30 min), produces detailed implementation plan
- Ultrareview: Fleet of 5-20 bug-hunting agents reviewing in parallel (security, logic, perf, types, etc.)
Both are async — start then poll status.
Autoloop (autonomous workspace iteration)
Autoloop uses three persistent roles. You chat with the Planner to define plan.md and goal.json; after explicit approval it starts a Coder/Reviewer iteration loop. Each role may use a different engine.
autoloop_start({
run_id: 'fix-parser',
workspace: '/path/to/repo',
planner_engine: 'claude',
coder_engine: 'codex',
reviewer_engine: 'agy',
});
autoloop_chat({ run_id: 'fix-parser', text: 'Read the repo and design a plan to fix the parser.' });
autoloop_chat({ run_id: 'fix-parser', text: 'Plan approved; start the loop.' });
autoloop_status({ run_id: 'fix-parser' });
autoloop_stop({ run_id: 'fix-parser', reason: 'done' });
Claude roles default to Planner opus and Coder/Reviewer sonnet. A non-Claude role with no model uses that engine's own default. Custom engine configs are supplied only at start (or HTTP resume), never by Planner output. The Reviewer runs in a restaged sandbox and returns advance/hold/rollback verdicts; push policy and SSE keep long runs observable.
For the full control protocol, registry/resume behavior, and ledger layout, see references/autoloop.md.
Tools Overview
| Category |
Tools |
| Session Lifecycle |
session_start, session_send, session_stop, session_list, sessions_overview |
| Session Ops |
coding_session_status, session_grep, session_compact, session_update_tools, session_switch_model |
| Inbox |
session_send_to, session_inbox, session_deliver_inbox |
| Teams |
coding_agents_list, team_list, team_send |
| Codex |
codex_resume, codex_review, codex_goal_*, codex_interrupt, codex_steer, codex_fork, codex_rollback, codex_models, codex_threads |
| Claude CLI |
claude_goal_*, claude_agents_list, plugin_details |
| Fan-out |
fanout_start, fanout_status, fanout_abort |
| Council |
council_start, council_status, council_abort, council_inject, council_review, council_accept, council_reject |
| Ultra |
ultraplan_start, ultraplan_status, ultrareview_start, ultrareview_status |
ultracode (Claude dynamic workflows) is a session_start option, not a separate tool: set
ultracode: true to have Claude orchestrate a JS workflow and fan out to subagents per task.
For full parameter reference: see references/tools.md
Run as an ACP agent
clawo acp (or the clawo-acp binary) serves Agent Client Protocol over stdio, so any ACP
client — Zed, JetBrains, Neovim, Emacs, the VS Code ACP extension, or dsh through its
subagent-acp provider — drives the orchestrator as its coding agent. The model selector is
grouped by engine, so one dropdown spans Claude, Codex and Cursor and switching it switches
engine mid-session.
For setup, the dsh YAML block, and the cancellation/permission limits: see references/acp.md
Authentication Prerequisites
Each engine requires its own auth before use:
- Claude:
claude /login or ANTHROPIC_API_KEY
- Codex:
codex login or OPENAI_API_KEY
- Antigravity: run
agy once and complete the Google OAuth login
- Cursor:
agent login or CURSOR_API_KEY
- OpenCode:
opencode auth login (provider-agnostic; use provider/model form for model)
1---2name: claw-orchestrator3description: Manage persistent coding sessions across Claude Code, Codex, Antigravity (agy), Cursor, and OpenCode engines. Use when orchestrating multi-engine coding agents, starting/sending/stopping sessions, running multi-agent council collaborations, cross-session messaging, ultraplan deep planning, ultrareview parallel code review, autoloop autonomous workspace iteration, ultraapp building deployable web apps from a structured Q&A interview, switching models/tools at runtime, exposing the orchestrator's 69 tools as an MCP server to Hermes Agent / Claude Desktop / Cursor / Cline / Continue / Zed / Windsurf / Goose, or running as an Agent Client Protocol (ACP) agent that Zed / JetBrains / Neovim / Emacs / VS Code / dsh can drive directly. Triggers on "start a session", "send to session", "run council", "ultraplan", "ultrareview", "autoloop", "ultraapp", "Forge tab", "build a web app", "one-click app", "AppSpec", "autonomous iteration", "iterate until goal", "deep paper review", "auto research", "switch model", "multi-agent", "coding session", "session inbox", "cursor agent", "opencode", "mcp server", "clawo-mcp", "hermes mcp", "model context protocol", "ultracode", "dynamic workflow", "fanout", "fan-out", "best-of-N", "steer turn", "interrupt turn", "fork thread", "rollback turns", "acp", "agent client protocol", "clawo acp", "zed agent", "jetbrains agent", "external agent", "dsh subagent", "deepseek harness".4metadata:5 source: https://skillmd.com/skills/enderfga/claw-orchestrator6 openclaw:7 emoji: 🤖8 requires:9 anyBins:10 - claude11 - codex12 - agy13 - agent14 install:15 - id: npm-plugin16 kind: node17 package: "@enderfga/claw-orchestrator"18 label: Install plugin (npm)19 - id: node-claude20 kind: node21 package: "@anthropic-ai/claude-code"22 bins:23 - claude24 label: Install Claude Code CLI25 - id: node-codex26 kind: node27 package: "@openai/codex"28 bins:29 - codex30 label: Install Codex CLI31---3233# Claw Orchestrator Skill3435Claw Orchestrator — persistent multi-engine coding session manager for claw-style agent systems. Runs as a standalone CLI/server, with first-class OpenClaw plugin support. Wraps Claude Code, Codex, Antigravity, Cursor Agent, OpenCode, and custom CLIs into headless agentic engines with 69 tools.3637## Engine Quick Reference3839| Engine | CLI | Session Type | Best For |40|--------|-----|-------------|----------|41| `claude` | `claude` | Persistent subprocess | Multi-turn, complex tasks |42| `codex` | `codex exec` | Per-message spawn | One-shot execution |43| `agy` | `agy -p` | Per-message spawn | Google Antigravity; plain-text, auto conversation resume |44| `cursor` | `agent -p` | Per-message spawn | One-shot execution |45| `opencode` | `opencode run` | Per-message spawn | Provider-agnostic (`provider/model`) |4647## Core Workflow4849```javascript50// 1. Start session (any engine)51session_start({ name: "myproject", cwd: "/path/to/project", engine: "claude" })52session_start({ name: "codex-task", cwd: "/path/to/project", engine: "codex" })53session_start({ name: "agy-task", cwd: "/path/to/project", engine: "agy" })54session_start({ name: "cursor-task", cwd: "/path/to/project", engine: "cursor" })55session_start({ name: "opencode-task", cwd: "/path/to/project", engine: "opencode", model: "anthropic/claude-sonnet-4" })5657// 2. Send messages58session_send({ name: "myproject", message: "Fix the auth bug" })5960// 3. Check status / search history61coding_session_status({ name: "myproject" })62session_grep({ name: "myproject", pattern: "error" })6364// 4. Stop when done65session_stop({ name: "myproject" })66```6768## Session Options6970| Parameter | Description |71|-----------|-------------|72| `engine` | `claude` (default), `codex`, `agy`, `cursor`, `opencode` |73| `model` | Model name or alias (`fable`, `opus`, `sonnet`, `haiku`, `gpt-5.5`, `agy-pro`, `composer-2`) |74| `permissionMode` | `acceptEdits`, `auto`, `plan`, `bypassPermissions`, `manual`, `dontAsk` (`default` = legacy alias for `manual`) |75| `effort` | `low`, `medium`, `high`, `xhigh`, `max`, `auto` (`xhigh` is Opus 4.7-only, between `high` and `max`) |76| `maxBudgetUsd` | Cost limit in USD |77| `allowedTools` | List of allowed tool names |7879### CLI 2.1.111 options8081| Parameter | Description |82|-----------|-------------|83| `bare` | Minimal mode — no CLAUDE.md, hooks, LSP, auto-memory. Auto-enables prompt cache optimizations (see below). |84| `includeHookEvents` | Stream hook lifecycle events (PreToolUse/PostToolUse). |85| `forwardSubagentText` | Forward subagent text and thinking into the output stream, so sessions that fan out surface intermediate output instead of going quiet. |86| `permissionPromptTool` | Delegate permission prompts to an MCP tool for non-interactive use. |87| `excludeDynamicSystemPromptSections` | Move cwd/env/git from system prompt to user message for better prompt cache hits. Auto-enabled with `bare: true`. |88| `enablePromptCaching1H` | Enable 1-hour prompt cache TTL (vs default 5-min). Auto-enabled with `bare: true`. |89| `debug` / `debugFile` | Targeted debug output by category (e.g. `"api,mcp"`) and optional file path. |90| `fromPr` | Resume a session linked to a GitHub PR number or URL. |91| `channels` / `dangerouslyLoadDevelopmentChannels` | MCP channel subscriptions (research preview). |9293### CLI 2.1.121 options9495| Parameter | Description |96|-----------|-------------|97| `forkSubagent` | Fork subagent for non-interactive sessions (sets `CLAUDE_CODE_FORK_SUBAGENT=1`). |98| `enableToolSearch` | Enable Vertex AI tool search (sets `ENABLE_TOOL_SEARCH=1`). |99| `otelLogUserPrompts` | OpenTelemetry: include user prompts in logs (sets `OTEL_LOG_USER_PROMPTS=1`). |100| `otelLogRawApiBodies` | OpenTelemetry: include raw API bodies in logs (sets `OTEL_LOG_RAW_API_BODIES=1`). Debug only. |101102`stats.pluginErrors` is now populated from the `system/init` event when CLI plugins fail to load due to unmet dependencies.103104`TRACEPARENT` / `TRACESTATE` (W3C distributed tracing) are automatically forwarded from parent process env — set them before starting the session and they propagate to the child Claude CLI.105106**Smart defaults:** When `bare: true`, the plugin auto-enables `--exclude-dynamic-system-prompt-sections` and `ENABLE_PROMPT_CACHING_1H=1` unless explicitly set to `false`.107108## Multi-Agent Council109110Parallel agent collaboration with git worktree isolation and consensus voting. Agents can use different engines.111112```javascript113// Start a council114council_start({115 task: 'Build a REST API',116 agents: [117 { name: 'Architect', emoji: '🏗️', persona: 'System design', engine: 'claude' },118 { name: 'Engineer', emoji: '⚙️', persona: 'Implementation', engine: 'codex' },119 ],120 maxRounds: 5,121 projectDir: '/path/to/project',122});123```124125Council lifecycle: `council_start` → poll `council_status` → `council_review` → `council_accept` or `council_reject`.126127For details: see [references/council.md](references/council.md)128129## Cross-Session Messaging130131Sessions can communicate. Idle sessions receive immediately; busy sessions queue.132133```javascript134session_send_to({ from: "sender", to: "receiver", message: "Auth module needs rate limiting" })135session_send_to({ from: "monitor", to: "*", message: "Build failed!" }) // broadcast136session_inbox({ name: "receiver" })137session_deliver_inbox({ name: "receiver" })138```139140## Team Tools (All Engines)141142All engines use the same virtual-team layer: cross-session inbox routing across active SessionManager sessions. (Claude Code's native experimental Agent Teams is in-process TUI only and not reachable from a subprocess wrapper.)143144```javascript145team_list({ name: "myproject" })146team_send({ name: "myproject", teammate: "teammate", message: "Review this" })147```148149## Ultraplan & Ultrareview150151- **Ultraplan**: Opus deep planning session (up to 30 min), produces detailed implementation plan152- **Ultrareview**: Fleet of 5-20 bug-hunting agents reviewing in parallel (security, logic, perf, types, etc.)153154Both are async — start then poll status.155156## Autoloop (autonomous workspace iteration)157158Autoloop uses three persistent roles. You chat with the Planner to define `plan.md` and `goal.json`; after explicit approval it starts a Coder/Reviewer iteration loop. Each role may use a different engine.159160```javascript161autoloop_start({162 run_id: 'fix-parser',163 workspace: '/path/to/repo',164 planner_engine: 'claude',165 coder_engine: 'codex',166 reviewer_engine: 'agy',167});168autoloop_chat({ run_id: 'fix-parser', text: 'Read the repo and design a plan to fix the parser.' });169autoloop_chat({ run_id: 'fix-parser', text: 'Plan approved; start the loop.' });170autoloop_status({ run_id: 'fix-parser' });171autoloop_stop({ run_id: 'fix-parser', reason: 'done' });172```173174Claude roles default to Planner `opus` and Coder/Reviewer `sonnet`. A non-Claude role with no model uses that engine's own default. Custom engine configs are supplied only at start (or HTTP resume), never by Planner output. The Reviewer runs in a restaged sandbox and returns advance/hold/rollback verdicts; push policy and SSE keep long runs observable.175176For the full control protocol, registry/resume behavior, and ledger layout, see [references/autoloop.md](references/autoloop.md).177178## Tools Overview179180| Category | Tools |181|----------|-------|182| Session Lifecycle | `session_start`, `session_send`, `session_stop`, `session_list`, `sessions_overview` |183| Session Ops | `coding_session_status`, `session_grep`, `session_compact`, `session_update_tools`, `session_switch_model` |184| Inbox | `session_send_to`, `session_inbox`, `session_deliver_inbox` |185| Teams | `coding_agents_list`, `team_list`, `team_send` |186| Codex | `codex_resume`, `codex_review`, `codex_goal_*`, `codex_interrupt`, `codex_steer`, `codex_fork`, `codex_rollback`, `codex_models`, `codex_threads` |187| Claude CLI | `claude_goal_*`, `claude_agents_list`, `plugin_details` |188| Fan-out | `fanout_start`, `fanout_status`, `fanout_abort` |189| Council | `council_start`, `council_status`, `council_abort`, `council_inject`, `council_review`, `council_accept`, `council_reject` |190| Ultra | `ultraplan_start`, `ultraplan_status`, `ultrareview_start`, `ultrareview_status` |191192`ultracode` (Claude dynamic workflows) is a `session_start` option, not a separate tool: set193`ultracode: true` to have Claude orchestrate a JS workflow and fan out to subagents per task.194195For full parameter reference: see [references/tools.md](references/tools.md)196197## Run as an ACP agent198199`clawo acp` (or the `clawo-acp` binary) serves Agent Client Protocol over stdio, so any ACP200client — Zed, JetBrains, Neovim, Emacs, the VS Code ACP extension, or `dsh` through its201`subagent-acp` provider — drives the orchestrator as its coding agent. The model selector is202grouped by engine, so one dropdown spans Claude, Codex and Cursor and switching it switches203engine mid-session.204205For setup, the dsh YAML block, and the cancellation/permission limits: see [references/acp.md](references/acp.md)206207## Authentication Prerequisites208209Each engine requires its own auth before use:210211- **Claude**: `claude /login` or `ANTHROPIC_API_KEY`212- **Codex**: `codex login` or `OPENAI_API_KEY`213- **Antigravity**: run `agy` once and complete the Google OAuth login214- **Cursor**: `agent login` or `CURSOR_API_KEY`215- **OpenCode**: `opencode auth login` (provider-agnostic; use `provider/model` form for `model`)