Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ctrlnode.ai/llms.txt

Use this file to discover all available pages before exploring further.

Provider id: openclaw · CtrlNode agent type: OpenClaw OpenClaw is an open-source agent executor with its own session runtime. The Bridge forwards task intents to the OpenClaw HTTP gateway and streams session output back to CtrlNode.

​
When to use it

  • You already run OpenClaw on the Bridge machine
  • You want OpenClaw’s native multi-agent and tool orchestration
  • Other steps in the same workflow may use different providers (Claude, Codex, etc.)

​
Prerequisites

  1. Install and start OpenClaw (see OpenClaw docs)
  2. Ensure the gateway is reachable (default http://localhost:18789)
  3. Configure agents in openclaw.json

​
Environment variables

VariableRequiredDefaultDescription
OPENCLAW_GATEWAY_TOKENYes—Token from your OpenClaw instance
OPENCLAW_GATEWAY_URLNohttp://localhost:18789Gateway base URL
AGENTS_FOLDERNoHome directoryUsed for path resolution
Example .env: 
PAIRING_TOKEN=...
PROVIDERS=openclaw
OPENCLAW_GATEWAY_TOKEN=your_gateway_token
OPENCLAW_GATEWAY_URL=http://localhost:18789

​
Agent configuration

Agents are defined in openclaw.json at the workspace root: 
{
  "agents": [
    {
      "id": "my-agent",
      "name": "My Agent",
      "workspace": "/path/to/workspace"
    }
  ]
}
Register matching agents in CtrlNode Team with agent type OpenClaw. The Bridge discovers local agents from this file and merges registrations from CtrlNode sync.

​
Run the Bridge

PAIRING_TOKEN=... PROVIDERS=openclaw OPENCLAW_GATEWAY_TOKEN=... ./ctrlnode-bridge
Combine with other providers: 
PROVIDERS=openclaw,copilot

​
Troubleshooting

IssueFix
Bridge warns openclaw.json missingCreate config or remove openclaw from PROVIDERS
Gateway connection refusedStart OpenClaw before the Bridge
401 from gatewayRotate OPENCLAW_GATEWAY_TOKEN to match OpenClaw
Agent missing in UIRegister in Team; verify Bridge connected
← All providers