🚀 OpenClaw / Clawdbot Integration mit benutzerdefinierten CodingPlanX-Modellen

Dieses Tutorial führt Sie durch die Installation von Clawdbot (OpenClaw) und die Konfiguration einer benutzerdefinierten API-Relay-Station (Proxy), damit Sie Modelle wie GPT-4o, Claude 3.5 und Gemini flexibel nutzen können.

---

🛠️ Schritt 1: Umgebungsvorbereitung und Basis-Initialisierung

Bevor Sie beginnen, stellen Sie bitte sicher, dass die Node.js-Umgebung auf Ihrem System installiert ist.

1. Clawdbot global installieren

Öffnen Sie das Terminal (CMD oder PowerShell) und führen Sie den folgenden Befehl aus:

npm i -g clawdbot

2. Initialisierungsassistenten ausführen

Führen Sie das Setup-Programm aus, um die Grundeinstellungen abzuschließen. Bitte folgen Sie den Anweisungen auf dem Bildschirm:

clawdbot onboard

> [!IMPORTANT] > Hinweis für Windows-Benutzer: Wenn das System in der nativen Umgebung meldet, dass openclaw kein interner Befehl ist, verwenden Sie bitte einheitlich den Befehl clawdbot.

---

⚙️ Schritt 2: Hauptkonfigurationsdatei clawdbot.json ändern

In diesem Schritt definieren Sie die API-Adresse der Relay-Station und die Modellzuordnung, indem Sie die Hauptkonfigurationsdatei ändern.

Dateipfad: C:\Users\IhrBenutzername\.clawdbot\clawdbot.json (Hinweis: Der Pfad im ursprünglichen Tutorial war Administrator, bitte ändern Sie ihn entsprechend Ihrem tatsächlichen Benutzernamen)

Ändern Sie die Abschnitte agents, auth und models in der Datei wie folgt:

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.codingplanx.ai/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.codingplanx.ai",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.codingplanx.ai/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

---

🔑 Schritt 3: Authentifizierungsdatei auth-profiles.json konfigurieren

In diesem Schritt müssen Sie den echten API-Schlüssel eingeben, den Sie von der Relay-Station erhalten haben.

Dateipfad: C:\Users\IhrBenutzername\.clawdbot\agents\main\agent\auth-profiles.json

Bitte ändern Sie das Feld key in Ihren eigenen API-Schlüssel:

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-Ihr_echter_GPT_Schlüssel"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-Ihr_echter_Claude_Schlüssel"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-Ihr_echter_Google_Schlüssel"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

---

🚦 Schritt 4: Dienst überprüfen und starten

Nachdem die Konfiguration abgeschlossen ist, überprüfen und starten Sie den Dienst durch den folgenden Prozess.

1. Gesundheitscheck durchführen

Überprüfen Sie, ob die Konfigurationssyntax und die Konnektivität normal sind:

clawdbot doctor

2. Gateway-Dienst starten

Führen Sie den Gateway-Dienst aus, um den KI-Agenten zu aktivieren:

clawdbot gateway

3. Web-Konsole aufrufen

1. Öffnen Sie Ihren Browser und besuchen Sie: http://127.0.0.1:18789/
2. Anmeldeinformationen: Verwenden Sie das Token, das am Ende von Schritt 1 (clawdbot onboard) ausgegeben wurde, um sich anzumelden.
3. Jetzt können Sie anfangen, Ihren KI-Agenten zu trainieren und zu nutzen!

---

💡 Tipp: Wenn Sie den Anbieter der Relay-Station wechseln, ändern Sie einfach die entsprechende baseUrl in clawdbot.json und aktualisieren Sie den key in auth-profiles.json.