OpenClaw Konfigurationsanleitung
OpenClaw fügt benutzerdefinierte Modellanbieter über models.providers hinzu. ai2save verwendet die OpenAI Compatible-Schnittstelle, Base URL muss https://ai2save.com/v1 ausgefüllt werden.
1. Vorbereitung von OpenClaw und API Key
Wenn OpenClaw bereits installiert ist, kann die Installation übersprungen werden:
npm install -g openclaw@latest
openclaw --version
- Öffnen Sie https://ai2save.com/keys.
- Erstellen Sie eine API Key, die zur OpenAI / GPT-Modellgruppe gehört.
- Kopieren Sie den vollständigen
sk-...-Schlüssel.
2. Bearbeiten der OpenClaw-Konfigurationsdatei
Die Standardkonfigurationsdatei von OpenClaw ist:
~/.openclaw/openclaw.json
Windows unterstützt normalerweise %USERPROFILE%\.openclaw\openclaw.json. Dateien, die JSON5 unterstützen, können gemäß der folgenden Struktur in die vorhandene Konfiguration integriert werden:
{
env: {
vars: {
AI2SAVE_API_KEY: "sk-dein-api-key",
},
},
agents: {
defaults: {
model: {
primary: "ai2save/gpt-5.5",
},
},
},
models: {
mode: "merge",
providers: {
ai2save: {
baseUrl: "https://ai2save.com/v1",
apiKey: "${AI2SAVE_API_KEY}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "gpt-5.5",
name: "GPT 5.5",
reasoning: true,
input: ["text"],
contextWindow: 200000,
},
],
},
},
},
}
Erläuterung der Schlüsselfelder:
models.providers.ai2save.baseUrl: Muss mit/v1einhergehen.api: "openai-completions": Schnittstellentyp, der von OpenClaw für die Vertretung von OpenAI Compatible verwendet wird.models[].id: Muss genau mit der Modell-ID übereinstimmen, die über die ai2save-Konsole freigegeben ist.agents.defaults.model.primary: Das Format istanbieter-id/model-id.apiKeykann direkt als"sk-..."geschrieben werden; wenn auf${AI2SAVE_API_KEY}verwiesen wird, muss es inenv.varsdefiniert sein.
Wenn Sie mehrere Modelle hinzufügen möchten, fügen Sie diese weiterhin in das models-Array ein und ändern Sie primary in den ai2save/model-id, den Sie standardmäßig verwenden möchten.
3. Anwendung und Überprüfung der Konfiguration
OpenClaw Gateway wird Änderungen an der Konfigurationsdatei überwachen und automatisch anwenden. Wenn die Konfiguration nicht rechtzeitig wirksam wird, führen Sie Folgendes aus:
openclaw gateway restart
Dann prüfen Sie, ob das Modell bereits in OpenClaw vorhanden ist:
openclaw models list --provider ai2save
Wechsle das Standardmodell zu ai2save:
openclaw models set ai2save/gpt-5.5
Wenn das Modell nicht erscheint, führen Sie eine Diagnose durch und prüfen Sie auf Konfigurationsfehler:
openclaw doctor
4. Validierungsanforderung
- Öffnen Sie die Chat-Oberfläche oder WebChat von OpenClaw.
- Starten Sie eine neue Sitzung und senden Sie „Hallo, bitte melden Sie den aktuellen Modellnamen“.
- Bestätigen Sie, dass das Modellrouting als
ai2save/gpt-5.5angezeigt wird. - Überprüfen Sie zunächst nur Textaufgaben. Nach erfolgreicher Überprüfung können komplexe Tools wie Dateien, Browser und langer Kontext geöffnet werden.
OpenClaw behandelt nicht-offizielle OpenAI-Proxy automatisch kompatibel, man muss developer role nicht manuell aktivieren. Wenn es Probleme mit dem Tool-Aufruf gibt, stellen Sie zunächst sicher, dass die Modell-ID Tool-Aufrufe unterstützt, und erhöhen Sie gegebenenfalls die Timeout-Zeit.
5. Häufige Fehlermeldungen
- 401 / invalid_api_key:
AI2SAVE_API_KEYist nicht definiert, der Schlüssel wurde nicht vollständig kopiert oder die Schlüsselgruppe stimmt nicht überein. - 404 / model not found:
models[].id,primaryoder der tatsächlich angeforderte Modellname stimmen nicht überein. - Verbindung fehlgeschlagen / leere Antwort: Prüfen Sie, ob
baseUrlhttps://ai2save.com/v1entspricht, schreiben Sie nicht die Root-Adresse. - Leere Modellauswahl: Bestätigen Sie
models.mode: "merge"und stellen Sie sicher, dassmodels.providers.ai2save.models[]mindestens ein Modell enthält. - Konfiguration wurde nach dem Speichern nicht wirksam: Führen Sie
openclaw doctorerneut aus und starten Sie bei Bedarf OpenClaw Gateway neu.