Skip to main content
Use this section if you run the Clawboo server: on your own computer, on a shared machine or home server, or behind a reverse proxy so a small team can reach it. If you only use the dashboard on the computer where you installed it, the defaults below already keep it on that machine, and you can go straight to Use Clawboo.

What you are running

Clawboo is one Node.js program. It serves the dashboard and the REST API on one port, hosts Clawboo’s MCP servers, and keeps its data in a SQLite file in ~/.clawboo. Clawboo Native agents run inside that program. Claude Code and Codex run as programs it starts on the same machine, Hermes agents run in one Hermes gateway it starts and watches there, and OpenClaw agents run in the OpenClaw Gateway.

In this section

The default posture

  • Only this machine can connect. The server listens on 127.0.0.1 until you set HOST.
  • The dashboard is locked with an access token. The first start makes a per-install token in ~/.clawboo/access-token, readable only by you, unless you set STUDIO_ACCESS_TOKEN yourself. STUDIO_ACCESS_TOKEN= set blank turns it off; then anyone who can reach the server can use it, and with HOST set to anything but a loopback address the server refuses to start, but a reverse proxy on the same machine does not trip that check.
  • Browsers must use a local address. The same-origin guard rejects API calls that arrive under another name, such as your proxy’s domain, until you list it in CLAWBOO_ALLOWED_HOSTS and CLAWBOO_ALLOWED_ORIGINS.
  • State lives in ~/.clawboo, and agents’ work in ~/clawboo-work. Clawboo also writes provider keys and OpenClaw settings in OpenClaw’s ~/.openclaw folder.
  • Spend is tracked, not capped. Budgets warn by default. A hard cap is something you turn on.
Prompts go only to the providers and apps you connect. No Clawboo account, and Clawboo itself sends no telemetry. The server also fetches the Marketplace catalog from GitHub, OpenRouter’s public model list and the latest version from npm, and the dashboard loads its font from Google Fonts and its GitHub star count; Production defaults lists each one. Claude Code and Codex run with their own sandboxes and approval prompts turned off, and Hermes asks only before the commands its own policy flags, so all three can read and change any file your user account can. For work you do not trust, run Clawboo under a separate user account or in a virtual machine. See What agents can do.
Last modified on November 14, 2026