OpenClaw Modellanbieter einrichten

OpenClaw wird in Appbox installiert, ohne dass ein Modell-API-Schlüssel erforderlich ist.

Die empfohlene Methode zum Abschließen der Einrichtung ist, sich per SSH mit Ihrer OpenClaw-App zu verbinden und den integrierten Assistenten openclaw onboard auszuführen. Der Assistent ist sicherer als das manuelle Bearbeiten der gesamten Konfigurationsdatei, weil er die Appbox-Gateway-Einstellungen beibehält und Sie durch Modellanbieter, API-Schlüssel, Kanäle, Health-Checks und Skills führt.

Wenn Sie SSH nicht nutzen können oder nicht nutzen möchten, verwenden Sie stattdessen die Backup-Methode über das Dashboard.

Empfohlene Methode: per SSH in OpenClaw einloggen und Onboarding ausführen

Nutzen Sie diese Methode für neue Installationen und für bestehende Installationen, bei denen Modellanbieter-Zugangsdaten ergänzt oder geändert werden müssen.

Was Sie zuerst benötigen

• Die Detailseite Ihrer OpenClaw-App in Appbox.
• Den SSH-Befehl im Bereich Konfiguration.
• Ihr Gateway-Token / SSH-Passwort. Das ist derselbe generierte geheime Wert, der auch für die Anmeldung am OpenClaw-Dashboard verwendet wird.
• Ein Modellanbieter-Konto oder einen API-Schlüssel. Falls Sie noch keinen haben, siehe API-Schlüssel holen.

Die App-Detailseite zeigt den direkt kopierbaren SSH-Befehl:

Verbindung von macOS herstellen

1. Öffnen Sie Terminal oder iTerm2.
2. Kopieren Sie den SSH-Befehl von der OpenClaw-App-Detailseite.
3. Fügen Sie ihn ein und führen Sie ihn aus. Er sieht ungefähr so aus:

ssh node@your-openclaw-domain.example -p 12345

4. Wenn macOS fragt, ob Sie dem Host vertrauen, geben Sie yes ein und drücken Enter.
5. Wenn nach einem Passwort gefragt wird, fügen Sie Ihr Gateway-Token / SSH-Passwort ein und drücken Enter. Terminal zeigt beim Tippen oder Einfügen des Passworts keine Zeichen an.

Verbindung von Windows herstellen

Windows 10 und Windows 11 enthalten den OpenSSH-Client standardmäßig.

1. Öffnen Sie Windows Terminal oder PowerShell.
2. Kopieren Sie den SSH-Befehl von der OpenClaw-App-Detailseite.
3. Fügen Sie ihn ein und führen Sie ihn aus:

ssh node@your-openclaw-domain.example -p 12345

4. Wenn Windows fragt, ob Sie dem Host vertrauen, geben Sie yes ein und drücken Enter.
5. Wenn nach einem Passwort gefragt wird, fügen Sie Ihr Gateway-Token / SSH-Passwort ein und drücken Enter. PowerShell zeigt das eingefügte Passwort nicht an.

Wenn Windows meldet, dass ssh nicht erkannt wird, installieren Sie OpenSSH Client über Einstellungen > System > Optionale Features, öffnen Sie Windows Terminal erneut und versuchen Sie es noch einmal.

Den OpenClaw-Onboarding-Assistenten ausführen

Nachdem die SSH-Verbindung hergestellt ist, führen Sie aus:

openclaw onboard

Der Assistent ist interaktiv. Verwenden Sie diese Appbox-spezifischen Optionen:

1. Vorhandene Konfiguration: Wählen Sie die Option zum Prüfen oder Ändern der aktuellen Konfiguration. Wählen Sie keinen vollständigen Reset, es sei denn, Sie möchten Ihre OpenClaw-Einrichtung absichtlich neu aufbauen.
2. Modell und Authentifizierung: Wählen Sie Ihren Anbieter, z. B. OpenRouter, OpenAI, Anthropic, Google, xAI oder einen benutzerdefinierten OpenAI-kompatiblen Anbieter. Fügen Sie den API-Schlüssel ein, wenn der Assistent danach fragt. OpenRouter ist für die meisten Nutzer der einfachste Standard, weil ein Schlüssel viele Modelle ansprechen kann. Wenn Sie ein OpenAI-Codex-Abonnement haben, wählen Sie in der Anbieter-Liste OpenAI Codex und nicht eine Option, die nur codex heißt.
3. Standardmodell: Wählen Sie das vom Assistenten empfohlene Modell für diesen Anbieter oder geben Sie manuell einen provider/model-Wert ein, z. B. openrouter/auto.
4. Workspace: Behalten Sie den Standard-Workspace bei, sofern Sie keinen bestimmten Grund haben, ihn zu ändern.
5. Gateway-Einstellungen: Behalten Sie die bestehenden Appbox-Gateway-Einstellungen bei. Lassen Sie insbesondere Token-Authentifizierung aktiviert und behalten Sie die vorhandenen Gateway-Port-/Bind-Einstellungen bei.
6. Kanäle: Konfigurieren Sie WhatsApp, Telegram, Discord, Signal, iMessage oder andere Kanäle jetzt, oder überspringen Sie sie und fügen Sie sie später mit openclaw configure hinzu.
7. Websuche: Wählen Sie einen Suchanbieter, falls Sie einen haben, oder überspringen Sie diesen Schritt vorerst.
8. Daemon-/Service-Installation: Appbox überwacht OpenClaw bereits im Container. Überspringen Sie daher die Daemon-Installation, falls der Assistent sie anbietet.
9. Health-Check: Lassen Sie den Assistenten den Health-Check ausführen.
10. Skills: Lassen Sie den Assistenten die mitgelieferten Skills prüfen. Wenn er nach Preferred node manager for skill installs fragt, wählen Sie npm.

Wenn das Onboarding abgeschlossen ist, kehren Sie zum OpenClaw-Dashboard zurück. Falls das Dashboard bereits geöffnet war, aktualisieren Sie es und testen Sie eine kurze Chat-Nachricht.

Nützliche Folgekommandos über SSH:

openclaw configure
openclaw status --deep
openclaw health

API-Schlüssel holen (mit Links zu den Konsolen)

Nutzen Sie diese Anbieter-Konsolen, um Schlüssel zu erzeugen. Bei der empfohlenen SSH-Methode fügen Sie den Schlüssel ein, wenn openclaw onboard danach fragt. Bei der Backup-Methode über das Dashboard führen Sie den Schlüssel in Config > Secrets > Raw zusammen.

Empfehlung zuerst: OpenRouter (beste Voreinstellung für die meisten Nutzer)

Warum wir es empfehlen:

• Ein Schlüssel für viele Modellanbieter.
• Sie können openrouter/auto nutzen; das Modell kann je nach Aufgabenkomplexität wechseln.
• auto kann Kosten senken, indem einfachere Aufgaben an günstigere Modelle geroutet werden.

So erhalten Sie einen Schlüssel:

1. Gehen Sie zu OpenRouter und melden Sie sich an.
2. Öffnen Sie die API-Keys-Einstellungen.
3. Klicken Sie auf Create und kopieren Sie den Schlüssel (wird nur einmal angezeigt).
4. Verwenden Sie ihn, wenn der OpenClaw-Assistent nach Ihrem OpenRouter-API-Schlüssel fragt. Für die Backup-Methode über das Dashboard lautet der Konfigurationsschlüssel models.providers.openrouter.apiKey.

Quelle/Tutorial: How to Get an OpenRouter API Key

OpenAI

So erhalten Sie einen Schlüssel:

1. Melden Sie sich bei der OpenAI Platform an.
2. Öffnen Sie API Keys.
3. Klicken Sie auf Create new secret key.
4. Kopieren Sie ihn sofort (OpenAI zeigt den vollständigen Wert nur einmal).

Quelle/Tutorial: How to Get an OpenAI API Key

Anthropic

So erhalten Sie einen Schlüssel:

1. Melden Sie sich in der Anthropic Console an.
2. Öffnen Sie API Keys.
3. Klicken Sie auf Create Key.
4. Kopieren Sie den Schlüssel sofort (wird nur einmal angezeigt).

Quelle/Tutorial: How to get your Claude API key

Google (Gemini über AI Studio)

So erhalten Sie einen Schlüssel:

1. Öffnen Sie Google AI Studio.
2. Gehen Sie zu API Keys.
3. Klicken Sie auf Create API key (neues oder bestehendes Projekt).
4. Kopieren Sie den Schlüssel und bewahren Sie ihn sicher auf.

Quelle/Tutorial: Get Google AI API Key

Hinweis: Anbieter-Dashboards ändern sich häufig; je nach Sitzungszustand kann eine Anmeldung erforderlich sein.

Backup-Methode: Anbieter-Authentifizierung im Dashboard konfigurieren

Verwenden Sie diese Methode nur, wenn SSH nicht verfügbar ist oder Sie die Konfiguration lieber manuell vornehmen möchten. Der Raw-Editor im Dashboard funktioniert, bearbeitet aber das gesamte OpenClaw-Konfigurationsobjekt auf einmal. Achten Sie darauf, Anbieter-Einstellungen in die bestehende Datei einzuführen, statt die Appbox-Standards für Gateway und Skills zu ersetzen.

1. Öffnen Sie die OpenClaw-Dashboard-URL auf der Seite mit den Installationsdetails der App.
2. Gehen Sie zu Config > Secrets.
3. Wählen Sie Raw statt Form.
4. Klicken Sie auf die Schaltfläche zum Anzeigen sensibler Werte (Auge mit durchgestrichenem Symbol).
5. Führen Sie die Anbieter-Einstellungen aus den Beispielen unten mit Ihrer bestehenden Konfiguration zusammen (siehe Wie manuelle Anbieter-Konfiguration in die gesamte Datei passt) — ersetzen Sie nicht die ganze Datei, es sei denn, Sie wollen Gateway, Skills und andere Appbox-Standards wirklich zurücksetzen.
6. Speichern und Konfigurationsänderungen anwenden.

Wie manuelle Anbieter-Konfiguration in die gesamte Datei passt

Config > Secrets > Raw bearbeitet die gesamte OpenClaw-Konfiguration in einem Objekt. Auf Appbox enthält diese Datei bereits Einträge wie gateway (Bind, Token-Auth, Control UI), skills.load.extraDirs (mitgelieferte Skills), commands und manchmal meta. Die Ausschnitte im Abschnitt Beispiele großer Anbieter zeigen nur die Teile, die Sie für Modelle brauchen: den models-Zweig und agents.defaults.model.primary.

Vorgehen: Behalten Sie Ihre vorhandenen Schlüssel auf oberster Ebene (gateway, skills, commands usw.) und ergänzen oder aktualisieren Sie diese beiden Bereiche:

• models.providers — fügen Sie Ihren Anbieter (z. B. openrouter) samt apiKey, bei Bedarf baseUrl und der Liste models hinzu.
• agents.defaults.model.primary — setzen Sie die Standard-Modellzeichenkette (z. B. openrouter/auto), damit der Agent diesen Anbieter nutzt.

Wenn models oder agents schon existieren, führen Sie neue Schlüssel in diese Objekte ein, statt sie zu duplizieren.

Unten steht ein Beispiel für die gesamte Raw-Datei als JSON (der Editor kann in der Praxis auch JSON5-ähnliche Anführungszeichen akzeptieren). Ihre echte Datei kann weitere Felder enthalten (z. B. reichhaltigere Modell-Metadaten, meta). Die Anbieter-Blöcke in den Beispielen weiter unten sind die Teile, die Sie mit models und agents hier abstimmen.

{
  "models": {
    "providers": {
      "openrouter": {
        "baseUrl": "https://openrouter.ai/api/v1",
        "apiKey": "YOUR_OPENROUTER_KEY",
        "models": [
          {
            "id": "auto",
            "name": "Auto (OpenRouter)",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/auto"
      }
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "gateway": {
    "bind": "lan",
    "controlUi": {
      "dangerouslyAllowHostHeaderOriginFallback": true,
      "dangerouslyDisableDeviceAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "YOUR_GATEWAY_TOKEN"
    }
  },
  "skills": {
    "load": {
      "extraDirs": ["/app/skills"]
    }
  }
}

Gateway-Token vs. Anbieter-API-Schlüssel: gateway.auth.token dient nur für die Anmeldung an der OpenClaw Control UI / dem Gateway. models.providers.*.apiKey ist Ihr LLM-Anbieter-Schlüssel (OpenRouter, OpenAI usw.) — das sind zwei verschiedene Dinge.

Beispiele großer Anbieter

Nutzen Sie zuerst jeweils nur einen Anbieter-Block, prüfen Sie, ob es funktioniert, und fügen Sie dann weitere hinzu. Jedes Beispiel unten ist ein Merge-Fragment: ... steht für ausgelassene Konfiguration (Zeilen darüber oder darunter), und das }, vor "models" schließt den Schlüssel ab, der in Ihrer Datei über models steht (z. B. skills oder commands). Die Ausschnitte sind für sich allein kein gültiges JSON — führen Sie die Abschnitte models und agents in Ihr Root-Objekt ein.

OpenRouter

...
  },
  "models": {
    "providers": {
      "openrouter": {
        "baseUrl": "https://openrouter.ai/api/v1",
        "apiKey": "sk-or-...",
        "models": [
          {
            "id": "auto",
            "name": "Auto (OpenRouter)"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/auto"
      }
    }
  },
...

OpenAI

...
  },
  "models": {
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "sk-...",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-5.4"
      }
    }
  },
...

Anthropic

...
  },
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://api.anthropic.com/v1",
        "apiKey": "sk-ant-...",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6"
      }
    }
  },
...

Google (Gemini)

...
  },
  "models": {
    "providers": {
      "google": {
        "apiKey": "AIza...",
        "models": [
          {
            "id": "gemini-3.1-pro-preview",
            "name": "Gemini 3.1 Pro Preview"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "google/gemini-3.1-pro-preview"
      }
    }
  },
...

xAI (Grok)

...
  },
  "models": {
    "providers": {
      "xai": {
        "apiKey": "xai-...",
        "models": [
          {
            "id": "grok-4",
            "name": "Grok 4"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "xai/grok-4"
      }
    }
  },
...

Mistral

...
  },
  "models": {
    "providers": {
      "mistral": {
        "baseUrl": "https://api.mistral.ai/v1",
        "apiKey": "sk-...",
        "models": [
          {
            "id": "mistral-large-latest",
            "name": "Mistral Large Latest"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "mistral/mistral-large-latest"
      }
    }
  },
...

Together AI

...
  },
  "models": {
    "providers": {
      "together": {
        "baseUrl": "https://api.together.xyz/v1",
        "apiKey": "together-...",
        "models": [
          {
            "id": "moonshotai/Kimi-K2.5",
            "name": "Kimi K2.5"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "together/moonshotai/Kimi-K2.5"
      }
    }
  },
...

Hinweis zu Bedrock (kein API-Schlüssel)

Amazon Bedrock nutzt AWS-Zugangsdaten (z. B. AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) statt eines API-Schlüssels. Ein minimaler Anbieter-Eintrag sieht so aus:

...
  },
  "models": {
    "providers": {
      "amazon-bedrock": {
        "baseUrl": "https://bedrock-runtime.us-east-1.amazonaws.com",
        "api": "bedrock-converse-stream",
        "auth": "aws-sdk",
        "models": [
          {
            "id": "us.anthropic.claude-opus-4-6-v1:0",
            "name": "Claude Opus 4.6 (Bedrock)"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0"
      }
    }
  },
...

Hinweise

• Gateway-Auth-Token und Modellanbieter-API-Schlüssel sind unterschiedliche Einstellungen.
• Bei einem Anbieterfehler (z. B. fehlender Anthropic-Key) passen Sie Ihr Standardmodell an einen konfigurierten Anbieter an.
• Schlägt die Validierung eines Anbieters fehl, prüfen Sie zuerst, ob alle nötigen Felder gesetzt sind (baseUrl, models und ggf. apiKey).

Offizielle Anbieter-Dokumentation

• OpenClaw provider directory
• OpenRouter provider
• OpenAI provider
• Anthropic provider
• Google provider
• xAI provider
• Mistral provider
• Together AI provider
• Amazon Bedrock provider