ai2saveai2save

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
  1. Öffnen Sie https://ai2save.com/keys.
  2. Erstellen Sie eine API Key, die zur OpenAI / GPT-Modellgruppe gehört.
  3. 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 /v1 einhergehen.
  • 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 ist anbieter-id/model-id.
  • apiKey kann direkt als "sk-..." geschrieben werden; wenn auf ${AI2SAVE_API_KEY} verwiesen wird, muss es in env.vars definiert 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

  1. Öffnen Sie die Chat-Oberfläche oder WebChat von OpenClaw.
  2. Starten Sie eine neue Sitzung und senden Sie „Hallo, bitte melden Sie den aktuellen Modellnamen“.
  3. Bestätigen Sie, dass das Modellrouting als ai2save/gpt-5.5 angezeigt wird.
  4. Ü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_KEY ist nicht definiert, der Schlüssel wurde nicht vollständig kopiert oder die Schlüsselgruppe stimmt nicht überein.
  • 404 / model not found: models[].id, primary oder der tatsächlich angeforderte Modellname stimmen nicht überein.
  • Verbindung fehlgeschlagen / leere Antwort: Prüfen Sie, ob baseUrl https://ai2save.com/v1 entspricht, schreiben Sie nicht die Root-Adresse.
  • Leere Modellauswahl: Bestätigen Sie models.mode: "merge" und stellen Sie sicher, dass models.providers.ai2save.models[] mindestens ein Modell enthält.
  • Konfiguration wurde nach dem Speichern nicht wirksam: Führen Sie openclaw doctor erneut aus und starten Sie bei Bedarf OpenClaw Gateway neu.