OpenClaw

Prerequisites

OpenClaw supports both protocols. Select the same protocol for the base URL, onboarding compatibility mode, and JoyToken check.

Step 1: Install

npm install -g openclaw@2026.6.11
openclaw --version

Step 2: Set the API key and base URL

export JOY_TOKEN_API_KEY="sk-xxx"
export JOY_TOKEN_OPENAI_BASE_URL="https://api.joytokens.ai/openai/v1"

For persistent use, add the selected variables to your shell profile.

Step 3: Register the provider

openclaw onboard \
  --non-interactive \
  --accept-risk \
  --auth-choice custom-api-key \
  --custom-provider-id joytoken \
  --custom-base-url "$JOY_TOKEN_OPENAI_BASE_URL" \
  --custom-compatibility openai \
  --custom-model-id auto \
  --custom-api-key "$JOY_TOKEN_API_KEY" \
  --skip-channels \
  --skip-daemon \
  --skip-skills \
  --skip-search \
  --skip-ui \
  --skip-health

Step 4: Confirm the config

cat ~/.openclaw/openclaw.json

The provider should contain joytoken/auto and the API value for the selected tab:

{
  "models": {
    "providers": {
      "joytoken": {
        "baseUrl": "https://api.joytokens.ai/openai/v1",
        "api": "openai-completions"
      }
    }
  }
}

Step 5: Verify

openclaw models status

Expected output includes joytoken/auto. Run one request:

openclaw infer model run \
  --local \
  --model joytoken/auto \
  --prompt "Reply with exactly: pong" \
  --json

A successful response includes pong.

JoyToken Check

Common Errors

Resources

• JoyToken API Guide
• JoyToken Authentication
• JoyToken Usage & Billing