Skip to main content
Factual, code-grounded reference for every public surface of Clawboo: the 148-route REST API, the clawboo CLI, configuration and environment variables, the 28-table SQLite schema, the 4 MCP servers and their tools, the marketplace catalog of 304 agents and 82 teams, the orchestration event and error vocabulary, and one page per workspace package (30 in total). These pages describe what the code does, verified against source; they do not teach a workflow. For learning-oriented walkthroughs see Getting Started; for the why see Concepts.
These docs describe Clawboo v0.3.1, the current release.

At a glance

REST API

Base URL, loopback posture, the shared { error: string } envelope, and the route summary live in the REST overview. The surface is grouped by resource:
  • Settings & health, /api/settings, /api/health*
  • Agents, /api/agents* (registry, files, sessions, sync, cleanup-ghosts)
  • Teams, /api/teams*, team-onboarding, team-rules, team-chat
  • Board, /api/board* (tasks, claim, comments, executions, deps, workspace)
  • Runtimes, /api/runtimes*, /api/onboarding/seed-native-team
  • Memory, /api/memory*
  • Tools & MCP, /api/tools*, /api/mcp* (incl. SSE/WS)
  • Governance, budgets, delegation-approval, approvals
  • Capabilities, /api/capabilities*
  • Observability, /api/obs* (incl. SSE), /api/eval/smoke
  • Schedules, /api/schedules*
  • System, /api/system/* (status, install, configure, gateway, device)
  • Misc, cost-records, chat-history, graph-layout, personality, skills, exec-settings, fleet, boo-zero

CLI & configuration

  • CLI reference, the clawboo entry point, its backup / stop / restart subcommands, and the clawboo-mcp-{tasks,memory,tools,teamchat} stdio bins.
  • Configuration, settings.json, the ~/.clawboo state directory, and the file/dir locations Clawboo owns.
  • Environment variables, every CLAWBOO_*, OPENCLAW_*, and provider key Clawboo reads, sourced only from @clawboo/config, the runtime descriptor, and the secrets vault.

Data, MCP & catalog

  • Database schema, the 28 SQLite tables with column-level detail and an ERD.
  • MCP tools, the Tasks / Memory / Tools / TeamChat servers, each tool’s name, and its zod input shape.
  • Marketplace catalog, the AgentCatalogEntry and TeamTemplate schemas, the three sources (two pinned to upstream SHAs, one first-party local), and the codegen ingestion pipeline.
  • Events & errors, the orchestration event kinds and the runtime-error taxonomy (unknown class = harness bug).

Packages

Packages overview carries the dependency graph and build order. One page per @clawboo/* package documents its version, purity, public API, and consumers:

See also

Last modified on August 21, 2026