OpenClaw

OpenClaw is an open-source AI assistant gateway. It speaks the Streamable HTTP MCP transport natively, so it connects to Orbismo directly — no bridge process required.

OpenClaw authenticates MCP servers with static headers (it has no sign-in flow), so you connect it with the API-key method: a single world’s URL plus a key. The connector (which requires sign-in) doesn’t apply here.

Before you start

You’ll need:

• OpenClaw installed — see the OpenClaw docs (typically npm install -g openclaw@latest).
• Your world’s ID — the UUID in the portal URL when you’re inside a world (https://app.orbismo.com/worlds/{world_id}/...).
• An API key for the world — see Generate an API key. Use a read-only key for your first connection so OpenClaw can’t change anything while you test.

Connect

1. Register the server with openclaw mcp set and a single JSON config:

   openclaw mcp set orbismo '{"url":"https://app.orbismo.com/api/v1/worlds/<world_id>/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer oc_live_<your_key>"}}'

   Replace <world_id> with your world’s UUID and oc_live_<your_key> with your full key.

2. Confirm the entry was saved:

   openclaw mcp list
   openclaw mcp show orbismo --json

3. Use OpenClaw normally. The next time it starts a session, the orbismo server is available and Orbismo’s tools appear in the agent’s tool list.

`set` doesn't validate the connection

openclaw mcp set only writes to OpenClaw’s local config — it doesn’t contact the server or check that the URL, key, or transport are correct. The first real connection happens when OpenClaw uses the server; if something’s wrong, you’ll see the error there. See Troubleshooting.

Multiple worlds

Register one entry per world, with distinct names and each world’s own key (keys are scoped to a single world):

openclaw mcp set orbismo-realm-a '{"url":"https://app.orbismo.com/api/v1/worlds/<realm_a_id>/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer oc_live_<key_for_realm_a>"}}'
openclaw mcp set orbismo-realm-b '{"url":"https://app.orbismo.com/api/v1/worlds/<realm_b_id>/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer oc_live_<key_for_realm_b>"}}'

Update or remove

openclaw mcp set <name> replaces an existing entry — rerun it with a new key to rotate. To remove a connection:

openclaw mcp unset orbismo

Reference

• OpenClaw MCP CLI: docs.openclaw.ai/cli/mcp
• Orbismo connection model: How AI integration works