dokumentation
Agenter i terminalen

OpenClaw

Markdown

Terminalagent · OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini

Komplet guide
FormatHvor skal du konfigurere?
OpenAI Chat, OpenAI Responses, Anthropic Messages, GeminiOpenClaw-konfigurationen (~/.openclaw/openclaw.json) → models.providers.<id>; standardmodel — agents.defaults.model.primary; sikker redigering — openclaw config set models.providers.<id> '<json>' --strict-json --merge

Konfiguration

Kopiér konfigurationen, og erstat sk-... med din egen nøgle fra Ailoots kontrolpanel. Opbevar helst nøglen i en miljøvariabel AILOOT_API_KEY, hvis applikationen understøtter det.

Kald GET /v1/models med din Ailoot-nøgle før start. Vælg et præcist model-ID, hvis metoder omfatter POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent, og brug det i konfigurationen. Kontrollér også værktøjsstøtte og de funktioner, din klientversion kræver til agenter.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ailoot/claude-sonnet-5-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ailoot": {
        "baseUrl": "https://api.ailoot.ai/v1",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "Claude Sonnet 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "deepseek-v4-pro",
            "name": "DeepSeek V4 Pro",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      },
      "ailoot-claude": {
        "baseUrl": "https://api.ailoot.ai",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5-5",
            "name": "Claude Opus 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      }
    }
  }
}

Denne konfiguration læser nøglen fra variablen AILOOT_API_KEY. Angiv den, før applikationen startes:

export AILOOT_API_KEY="sk-..."   # tilføj i ~/.zshrc eller ~/.bashrc

Eksempel på model: claude-sonnet-5-5. Find enhver anden model i kataloget — kontrollér, at den har det nødvendige format.

Værd at vide

Kontrol

  • For OpenAI-format er adressen https://api.ailoot.ai/v1 (eller hele stien, hvis applikationen kræver den fulde adresse).
  • For Anthropic-format er adressen https://api.ailoot.ai uden /v1.
  • For Gemini-format er adressen https://api.ailoot.ai — API'ens rodadresse. Den fulde konfiguration af dette format er ikke vist i eksemplet ovenfor; kontrollér i klientens dokumentation, hvilken sti der skal bruges i feltet. API-rutens præfiks er /v1beta.
  • Stil et kort spørgsmål. Hvis du får en fejl, skal du se på koden og Request ID og sammenholde dem med siden Fejl og grænser.
  • 404 umiddelbart efter konfigurationen betyder næsten altid forkert adresse: et ekstra eller manglende /v1.
  • 402 — saldoen rækker ikke til reservationen. Agenter reserverer mere end chat: hvorfor.

Applikationens dokumentation: https://docs.openclaw.ai/gateway/config-tools/custom-providers

Har du stadig spørgsmål? Send Request ID og en beskrivelse — så hjælper vi med at finde ud af det.Kontakt support