dokumentace
Agenti v terminálu

OpenClaw

Markdown

Agent v terminálu · OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini

Úplný průvodce
FormátKde nastavit
OpenAI Chat, OpenAI Responses, Anthropic Messages, GeminiKonfigurace OpenClaw (~/.openclaw/openclaw.json) → models.providers.<id>; výchozí model – agents.defaults.model.primary; bezpečná úprava – openclaw config set models.providers.<id> '<json>' --strict-json --merge

Nastavení

Zkopírujte konfiguraci a nahraďte sk-... svým klíčem z účtu Ailoot. Klíč je lepší uložit do proměnné prostředí AILOOT_API_KEY, pokud to aplikace umožňuje.

Před spuštěním zavolejte GET /v1/models se svým klíčem Ailoot. Vyberte přesné ID modelu, jehož metody zahrnují POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent, a použijte je v konfiguraci. U agentů ověřte také podporu nástrojů a funkce potřebné pro vaši verzi klienta.

{
  "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
          }
        ]
      }
    }
  }
}

Toto nastavení načítá klíč z proměnné AILOOT_API_KEY. Nastavte ji před spuštěním aplikace:

export AILOOT_API_KEY="sk-..."   # přidejte do ~/.zshrc nebo ~/.bashrc

Příklad modelu: claude-sonnet-5-5. Jakýkoli jiný model vyberte z katalogu – ověřte, že podporuje požadovaný formát.

Co je dobré vědět

Ověření

  • Adresa pro formát OpenAI je https://api.ailoot.ai/v1 (nebo úplná cesta, pokud aplikace vyžaduje úplnou adresu).
  • Adresa pro formát Anthropic je https://api.ailoot.ai bez /v1.
  • Adresa pro formát Gemini je https://api.ailoot.ai – kořenová adresa API. Příklad výše neukazuje úplné nastavení tohoto formátu; požadovanou cestu v poli klienta ověřte v jeho dokumentaci. Prefix trasy API je /v1beta.
  • Položte krátkou otázku. Pokud se objeví chyba, podívejte se na kód a Request ID a porovnejte je s informacemi na stránce Chyby a limity.
  • Chyba 404 hned po nastavení téměř vždy znamená nesprávnou adresu: nadbytečné nebo chybějící /v1.
  • Chyba 402 – zůstatek nestačí na rezervu. Agenti rezervují více než chat: proč.

Dokumentace aplikace: https://docs.openclaw.ai/gateway/config-tools/custom-providers

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.Napsat podpoře