Skip to main content
If you want full control over OpenClaw’s configuration — custom model lists, fallback chains, auth profiles stored in your system keychain, or per-channel routing — edit openclaw.json directly instead of running the setup script.
Prefer the one-command setup? See Quick Setup.

​
Step 1: Get your AIsa API key

1

Log in to the dashboard

console.aisa.one
2

Navigate to API Keys

console.aisa.one/console/token
3

Create a new key

Give it a label like openclaw-local. Copy the value (starts with sk-aisa-) immediately — it’s shown only once.

​
Step 2: Set your API key

Add the key to ~/.openclaw/openclaw.json or export it in your shell: 
export AISA_API_KEY="sk-aisa-..."
Prefer an environment variable over hardcoding the key in openclaw.json. See Authentication for rotation and storage best practices.

​
Step 3: Configure the AIsa provider

Add this block to your ~/.openclaw/openclaw.json: 
{
  "env": {
    "AISA_API_KEY": "sk-aisa-..."
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aisa": {
        "baseUrl": "https://api.aisa.one/v1",
        "apiKey": "${AISA_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4.1", "name": "GPT 4.1" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "claude-3-7-sonnet-20250219", "name": "Claude 3.7 Sonnet" },
          { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "qwen3-max", "name": "Qwen3 Max" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aisa/kimi-k2.5"
      },
      "models": {
        "aisa/kimi-k2.5": {}
      }
    }
  }
}
OpenClaw now knows about the aisa provider. Reference any model with the aisa/<model-id> format.

​
Step 4: Restart OpenClaw

openclaw gateway restart
Your agents will now route through AIsa.

​
Video walkthrough

​
Model format

Always use aisa/<model-id> — e.g., aisa/kimi-k2.5, aisa/gpt-5, aisa/claude-sonnet-4-6. Add any supported model to the models array in your provider config; the full list is in the model catalog.

​
Advanced configuration

​
Fallback chains

If the primary model fails (upstream outage, rate limit), OpenClaw can automatically retry with a fallback model: 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "aisa/kimi-k2.5",
        "fallbacks": ["aisa/gpt-4.1"]
      },
      "models": {
        "aisa/kimi-k2.5": {},
        "aisa/gpt-4.1": {}
      }
    }
  }
}

​
Auth profiles (keychain storage)

Keep your API key out of openclaw.json by storing it in your system keychain:
1

Declare an auth profile

{
  "auth": {
    "profiles": {
      "aisa:default": {
        "provider": "aisa",
        "mode": "api_key"
      }
    }
  }
}
2

Store the key via OpenClaw CLI

openclaw auth set aisa:default --key "$AISA_API_KEY"
3

Reference the profile in your provider config

"providers": {
  "aisa": {
    "apiKey": "auth:aisa:default",
    "baseUrl": "https://api.aisa.one/v1",
    "api": "openai-completions"
  }
}

​
Per-channel models

Run a different model on each messaging platform: 
{
  "telegram": {
    "agents": {
      "defaults": {
        "model": { "primary": "aisa/kimi-k2.5" }
      }
    }
  },
  "discord": {
    "agents": {
      "defaults": {
        "model": { "primary": "aisa/claude-sonnet-4-6" }
      }
    }
  }
}

​
Monitoring usage

Track your spend and per-request detail in the AIsa dashboard. See Usage Logs for what’s available.

​
Troubleshooting

Fix:
  1. Confirm AISA_API_KEY is set: echo $AISA_API_KEY
  2. Verify openclaw.json references ${AISA_API_KEY} (not a literal string).
  3. Restart OpenClaw so it re-reads the env.
  4. As a last resort, hardcode the key to verify the rest of the config works, then move it back to env.
Fix:
  1. Confirm the key is valid in the dashboard.
  2. Ensure baseUrl is exactly https://api.aisa.one/v1 (no trailing slash issues).
  3. See Authentication for rotation guidance.
Fix:
  1. Double-check the model ID against the catalog.
  2. Make sure the model is listed in models.providers.aisa.models.
  3. Reference it as aisa/<model-id>.

Quick Setup

One-command setup script instead of manual config.

Authentication

API key lifecycle, storage, and best practices.

OpenClaw docs

Official OpenClaw documentation.