Doku
Agenten im Terminal

OpenClaw

Markdown

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

Vollständiger Leitfaden
FormatWo konfigurieren
OpenAI Chat, OpenAI Responses, Anthropic Messages, GeminiOpenClaw-Konfiguration (~/.openclaw/openclaw.json) → models.providers.<id>; Standardmodell — agents.defaults.model.primary; sichere Änderung — openclaw config set models.providers.<id> '<json>' --strict-json --merge

Konfiguration

Kopieren Sie die Konfiguration und ersetzen Sie sk-... durch Ihren Schlüssel aus dem Ailoot-Kundenbereich. Speichern Sie den Schlüssel am besten in der Umgebungsvariablen AILOOT_API_KEY, sofern die Anwendung dies unterstützt.

Rufen Sie vor dem Start GET /v1/models mit Ihrem Ailoot-Schlüssel ab. Wählen Sie eine genaue Modell-ID mit den Methoden POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent und tragen Sie diese ID in die Konfiguration ein. Prüfen Sie bei Agenten auch die Werkzeugunterstützung und die für Ihre Clientversion benötigten Funktionen.

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

Diese Konfiguration liest den Schlüssel aus der Variablen AILOOT_API_KEY. Setzen Sie sie vor dem Start der Anwendung:

export AILOOT_API_KEY="sk-..."   # in ~/.zshrc oder ~/.bashrc einfügen

Beispielmodell: claude-sonnet-5-5. Andere Modelle wählen Sie aus dem Katalog — prüfen Sie, ob das erforderliche Format verfügbar ist.

Wissenswertes

Prüfung

  • Für das OpenAI-Format lautet die Adresse https://api.ailoot.ai/v1 (oder der vollständige Pfad, wenn die Anwendung eine vollständige Adresse verlangt).
  • Für das Anthropic-Format lautet die Adresse https://api.ailoot.ai ohne /v1.
  • Für das Gemini-Format lautet die Adresse https://api.ailoot.ai — die Stammadresse der API. Die vollständige Konfiguration für dieses Format ist im obigen Beispiel nicht dargestellt; gleichen Sie den erforderlichen Pfad im Client-Feld mit der Dokumentation des Clients ab. Das Präfix der API-Route lautet: /v1beta.
  • Stellen Sie eine kurze Frage. Bei einem Fehler prüfen Sie Code und Request ID und vergleichen Sie diese mit der Seite Fehler und Limits.
  • 404 direkt nach der Einrichtung bedeutet fast immer eine falsche Adresse: ein zusätzliches oder fehlendes /v1.
  • 402 — das Guthaben reicht für die Reservierung nicht aus. Agenten reservieren mehr als ein Chat: warum.

Dokumentation der Anwendung: https://docs.openclaw.ai/gateway/config-tools/custom-providers

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung — wir helfen Ihnen weiter.Support kontaktieren