claw-orchestrator

name: claw-orchestrator description: Manage persistent coding sessions across Claude Code, Codex, Gemini, 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, or exposing the orchestrator's 55 tools as an MCP server to Hermes Agent / Claude Desktop / Cursor / Cline / Continue / Zed / Windsurf / Goose. 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". metadata: { "openclaw": { "emoji": "🤖", "requires": { "anyBins": ["claude", "codex", "gemini", "agent"] }, "install": [ { "id": "npm-plugin", "kind": "node", "package": "@enderfga/claw-orchestrator", "label": "Install plugin (npm)" }, { "id": "node-claude", "kind": "node", "package": "@anthropic-ai/claude-code", "bins": ["claude"], "label": "Install Claude Code CLI" }, { "id": "node-codex", "kind": "node", "package": "@openai/codex", "bins": ["codex"], "label": "Install Codex CLI" }, { "id": "node-gemini", "kind": "node", "package": "@google/gemini-cli", "bins": ["gemini"], "label": "Install Gemini CLI" } ] }

}

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, Gemini, Cursor Agent, OpenCode, and custom CLIs into headless agentic engines with 55 tools.

Engine Quick Reference

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: "gemini-task", cwd: "/path/to/project", engine: "gemini" })
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

CLI 2.1.111 options

CLI 2.1.121 options

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)

Given a git workspace, a plan.md (intent + scope), and a goal.json (success criteria — scalar metric and/or structural gates), runs BOOTSTRAP → propose → execute → measure → ratchet → repeat until the goal is met or caps fire.

autoloop_start({
  workspace: '/path/to/repo',
  plan_path: '/path/to/repo/plan.md',
  goal_path: '/path/to/repo/goal.json',
  // optional: propose_engine, propose_model, ratchet_engine, ratchet_model
});
autoloop_status({ id });
autoloop_inject({ id, text: 'try lr warmup 500' });   // hint into next PROPOSE
autoloop_resume({ workspace, task_id });              // resume after process death
autoloop_stop({ id });

Asymmetric ratchet reviewer runs in a sandbox tmpdir (no source access), only writes a single decision bit to state.json. Non-blocking pushes via openclaw message send on new-best / plateau / aspirational gate proposals / termination. SSE event stream at GET /autoloop/<id>/events.

For details and worked examples (Karpathy-style scalar improvement + paper-review style gates): see references/autoloop.md.

27 Tools Overview

For full parameter reference: see references/tools.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
• Gemini: gemini login or GEMINI_API_KEY
• Cursor: agent login or CURSOR_API_KEY
• OpenCode: opencode auth login (provider-agnostic; use provider/model form for model)