claw-orchestrator

name claw-orchestrator description Manage persistent coding sessions across Claude Code, Codex, Antigravity (agy), Grok Build, 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 77 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", "grok", "grok build", "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", "clawo runs", "run ledger", "how much did it cost", "token usage", "spend cap", "budget limit", "maxBudgetUsd", "workflow", "durable workflow", "resume a run", "verify", "verification", "acceptance contract", "evidence", "evidence bundle", "did the tests actually pass", "prove it works", "human gate", "repair loop", "clawo workflow", "clawo verify". metadata {"openclaw":{"emoji":"🤖","requires":{"anyBins":"[Truncated]"},"install":["[Truncated]","[Truncated]","[Truncated]"]}} 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, Grok Build, OpenCode, and custom CLIs into headless agentic engines with 77 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 grok grok -p Per-message spawn xAI Grok Build; engine-reported cost, resumable session 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 : 'grok-task' , cwd : '/path/to/project' , engine : 'grok' }); 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 , ultra , auto (each engine clamps to its own ceiling) 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_thread_list