OpenClaw Clawdbot Custom Relay Setup

OpenClaw Clawdbot custom relay setup

Step 1: Install and onboard

Make sure Node.js is installed, then in a terminal:

1. Install globally:

npm i -g clawdbot

2. Run onboarding (follow the prompts):

clawdbot onboard

Note: On native Windows, if openclaw is not recognized, use clawdbot instead.

Step 2: Edit main config clawdbot.json

Open: C:\Users\Administrator\.clawdbot\clawdbot.json Update the models and auth sections as below to use a custom relay.

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\clawd",
      "models": {
        "api-proxy-gpt/gpt-6-luna": { "alias": "GPT-6 Luna" },
        "api-proxy-claude/claude-sonnet-5-5": { "alias": "Claude Sonnet 5.5" },
        "api-proxy-google/gemini-3.1-pro-preview": { "alias": "Gemini 3.1 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-5-5"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://4zapi.com/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-6-luna", "name": "GPT-6 Luna", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://4zapi.com",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-5-5", "name": "Claude Sonnet 5.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://4zapi.com/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

Step 3: Auth file auth-profiles.json

Open: C:\Users\Administrator\.clawdbot\agents\main\agent\auth-profiles.json Put the real API keys from your relay here.

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-your-unique-gpt-key-here"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-your-unique-claude-key-here"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-your-unique-google-key-here"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

Step 4: Check and start

1. Health check:

clawdbot doctor

2. Start Gateway:

clawdbot gateway

3. Open the console: Visit http://127.0.0.1:18789/ and sign in with the token printed at the end of clawdbot onboarding to start tuning your AI agent.