LobsterAI mit QCode einrichten

QCode in LobsterAI als eigenes Modell eintragen: Settings → Custom Model, passendes API Format und Base URL für Claude, GPT und chinesische Modelle.

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-11-10 · 📄 Laut offizieller Dokumentation (LobsterAI 2026.11.6, veröffentlicht am 2026-11-06: README, Benutzerhandbuch, Quellcode des Repositorys)

Kann LobsterAI Ihren eigenen API-Schlüssel verwenden? Ja. Stand 2026-11-10 laut offiziellem README, Quellcode des Repositorys und der Antwort eines Maintainers: Öffnen Sie Settings → Custom Model, klicken Sie unten in der Anbieterliste auf + Add Custom, wählen Sie unter API Format Anthropic Compatible (Messages) oder OpenAI Compatible (Chat Completions), tragen Sie die Base URL von QCode und Ihren cr_-Schlüssel ein, fügen Sie eine Modell-ID hinzu und klicken Sie auf Test Connection.

Auf einen Blick¶

Die offizielle FAQ beschreibt LobsterAI (chinesischer Name: Youdao Lobster) als quelloffenen Desktop-KI-Agenten von NetEase Youdao, gedacht als Büroassistent für alle Arbeitsbereiche. Er baut auf dem quelloffenen Agenten-Framework OpenClaw auf, läuft unter macOS (Apple Silicon und Intel) und Windows und steht unter der MIT-Lizenz auf GitHub (netease-youdao/LobsterAI). Er ist ein anderes Produkt als OpenClaw: OpenClaw ist das Laufzeit-Framework, LobsterAI ein Desktop-Client mit eigener Oberfläche.

Version: Stand 2026-11-10 ist das auf GitHub als Latest markierte Release LobsterAI 2026.11.6 (veröffentlicht am 2026-11-06); die Startseite der offiziellen Website zeigt am selben Tag 2026.10.30. Die Oberflächenbezeichnungen unten sind mit dem Quellcode von 2026.11.6 abgeglichen.

Welches Protokoll Sie verwenden¶

Ein benutzerdefinierter Anbieter bietet mehrere API-Formate; für den Alltag mit QCode reichen zwei:

• Anthropic Compatible (Messages) + https://api.qcode.cc/api: Claude-Modelle sowie GLM / Kimi / DeepSeek / Qwen.
• OpenAI Compatible (Chat Completions) + https://api.qcode.cc/openai/v1: GPT-Modelle sowie GLM / Kimi / DeepSeek / Qwen.

Ein cr_-Schlüssel gilt für beide. Claude-Modelle gibt es nur am Anthropic-Endpunkt, GPT-Modelle nur an den OpenAI-Endpunkten; die vollständige Matrix steht unter Endpunkte & API-Pfade. Das Format OpenAI Compatible (Responses) behandelt ein optionaler Abschnitt weiter unten.

Installation¶

Das offizielle README verweist auf die Downloadseite (macOS Apple Silicon, macOS Intel, Windows x64) oder auf die neuesten Installer unter GitHub Releases. Ein Konto bei einem Modellanbieter brauchen Sie nicht: Erstellen Sie im Dashboard einen cr_-Schlüssel und halten Sie ihn bereit.

Konfiguration¶

Die offiziellen Quellen beschreiben den Menüpfad mit leicht unterschiedlichen Worten:

• README: den eigenen API-Schlüssel unter Settings → Custom Model hinzufügen.
• Antwort eines Repository-Maintainers in Issue #362 (2026-10-06): „add a custom provider under Settings → Custom Models … choose OpenAI-compatible with base URL … and the … key, add a model ID … and run Test Connection“. Laut derselben Antwort wird der Anbieter nach erfolgreichem Test automatisch aktiviert und lässt sich in der Modellauswahl des Eingabefelds wählen; die andere Wahl ist das Anthropic-kompatible Format.
• Benutzerhandbuch und Leitfaden zur Modellkonfiguration nutzen Settings → Models für die integrierten Anbieter (DeepSeek, Moonshot, Zhipu, MiniMax, Qwen und weitere). QCode gehört unter Custom Model.

Schritt 1: benutzerdefinierten Anbieter hinzufügen¶

1. Öffnen Sie Settings und gehen Sie zu Custom Model.
2. Klicken Sie unten in der Anbieterliste auf + Add Custom.
3. Füllen Sie die Felder aus (Bezeichnungen wie in den englischen UI-Texten im Quellcode von 2026.11.6).

Für beide Formate legen Sie zwei benutzerdefinierte Anbieter an. Laut offiziellem Changelog lassen sich mehrere benutzerdefinierte Anbieter gleichzeitig anbinden, höchstens 30.

Schritt 2: Braucht die Base URL ein /v1?¶

Drei offizielle Quellen beantworten das:

1. Der Hinweis unter API Format: „Must match the protocol behind your Base URL; OpenAI-compatible URLs usually end with /v1“.
2. Die Beispiele unter dem Feld Base URL („Examples (SiliconFlow, click to fill)“) ordnen OpenAI Compatible https://api.siliconflow.cn/v1 zu und Anthropic Compatible https://api.siliconflow.cn ohne /v1 (Quellcode des Repositorys).
3. Test Connection setzt den Anfragepfad selbst zusammen (Quellcode des Repositorys, 2026.11.6). Das Anthropic-Format sendet an Base URL + /v1/messages, endet die Base URL bereits auf /v1, nur an /messages. Das Format OpenAI Chat Completions hängt /chat/completions an, wenn die Base URL auf eine Version wie /v1 endet, und ergänzt sonst zuerst /v1. Das Responses-Format sendet an Base URL + /responses und ergänzt ebenfalls zuerst ein fehlendes /v1.

Tragen Sie also für Anthropic Compatible https://api.qcode.cc/api ein (der Test ruft dann /api/v1/messages auf) und für OpenAI Compatible https://api.qcode.cc/openai/v1 (der Test ruft /openai/v1/chat/completions auf). Hängen Sie /v1/messages oder /chat/completions nicht selbst an. Auf einer LobsterAI-Installation haben wir diese Einrichtung nicht getestet; maßgeblich ist daher das Ergebnis von Test Connection. Bei instabilem Netz können Sie den Host durch asia.qcode.cc (Asien) oder us.qcode.cc (Nordamerika) ersetzen; der Pfad bleibt gleich.

Schritt 3: Modell hinzufügen und Verbindung testen¶

1. Klicken Sie im neuen Anbieter auf Add Model und füllen Sie Model Name (die Bezeichnung in der Liste) und Model ID aus.
2. Die Model ID muss Zeichen für Zeichen einem Modell entsprechen, das auf qcode.cc/models angeboten wird, zum Beispiel:

1. Klicken Sie auf Test Connection. Laut der Antwort des Maintainers in Issue #362 wird der Anbieter nach Erfolg automatisch aktiviert, und Sie können ihn in der Modellauswahl des Eingabefelds wählen. Die Preise je Modell stehen unter https://qcode.cc/models.

Optional: OpenAI Compatible (Responses)¶

Die offiziellen Release Notes zu 2026.10.23 sagen: „Custom providers now support OpenAI Responses and Gemini native APIs.“ Die Option heißt OpenAI Compatible (Responses), mit dem Hinweis „Requires the provider to support the OpenAI Responses API. Requests go to Base URL + /responses.“ Bei QCode bedient Responses GPT-Modelle; mit der Base URL https://api.qcode.cc/openai/v1 landet die Anfrage auf /openai/v1/responses, den die Endpunktseite als gleichwertig zu /openai/responses führt. Für den Alltag genügt OpenAI Compatible (Chat Completions). Gemini-Modelle bietet QCode derzeit nicht an, die Option Gemini (generateContent) bleibt also ungenutzt.

Überprüfen¶

1. Klicken Sie auf Test Connection; „Connection successful“ bedeutet, dass Pfad und Schlüssel funktionieren.
2. Wählen Sie im Eingabefeld das neue Modell in der Modellauswahl und senden Sie ping.
3. Wenn Sie Netzwerk und Schlüssel vorab im Terminal prüfen möchten (eine 400 bei leerem Body bedeutet, dass Pfad und Schlüssel passen):

KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/api/v1/messages -H "x-api-key: $KEY"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# 400 = path and key fine; 401 = bad key; 404 = wrong path prefix

Jede Anfrage erscheint auf probe.qcode.cc; geben Sie Ihren Schlüssel ein, um Modell und Statuscode jedes Aufrufs zu sehen.

Bekannte Grenzen und häufige Fehler¶

Auf Grundlage von offiziellem Handbuch, Changelog, Quellcode und Issues des Repositorys:

• Responses bei benutzerdefinierten Anbietern (Issue #185): Issue #185 (eröffnet am 2026-02-28) wünschte das neuere OpenAI-API-Format für benutzerdefinierte Anbieter; der Maintainer riet damals, die App-Sprache auf Englisch umzustellen und den integrierten OpenAI-Anbieter zu nutzen. Heutiger Stand: Seit 2026.10.23 unterstützen benutzerdefinierte Anbieter OpenAI Responses (siehe den optionalen Abschnitt oben).
• Die App-Sprache bestimmt die Liste der integrierten Anbieter: In den Issues #87 und #185 erklärt der Maintainer, dass die englische Oberfläche zusätzliche integrierte Anbieter wie OpenAI und Gemini zeigt. Heutiger Stand: Im Quellcode von 2026.11.6 hängt die integrierte Liste weiterhin von der Oberflächensprache ab, benutzerdefinierte Anbieter erscheinen in beiden Sprachen – die Einrichtung von QCode ist in der chinesischen und der englischen Oberfläche also gleich.
• Claude-ID unter einem OpenAI-Format: QCode antwortet mit model_not_available_on_endpoint. Stellen Sie das API Format dieses Anbieters auf Anthropic Compatible (Messages) mit https://api.qcode.cc/api um; das ist ein falsches Protokoll, kein Schlüsselproblem.
• Unbekannte Modell-ID: In Issue #87 antwortete ein anderer Dienst mit invalid param model:claude-haiku-4-5-20251001 (400), weil er diese ID nicht kannte. Verwenden Sie bei QCode nur IDs, die auf qcode.cc/models angeboten werden.
• Die Fehlertabelle im offiziellen Leitfaden zur Modellkonfiguration nennt vier Meldungen: „API Key Invalid“, „Insufficient Balance“, „Network Error“ und „Service Unavailable“. Bei QCode: den cr_-Schlüssel vollständig neu kopieren, das QCode-Guthaben prüfen, das Netzwerk prüfen und dann den Dienststatus prüfen.
• Schlüsselspeicherung: Laut offiziellem Handbuch wird der API-Schlüssel nur auf Ihrem lokalen Gerät gespeichert und auf keinen Server hochgeladen.

Weiterführende Dokumentation¶

• Endpunkte & API-Pfade – Protokolle und das Ausfüllen der Base URL
• Übersicht der Tool-Kompatibilität – Protokollunterstützung aller Tools
• OpenClaw anbinden – das OpenClaw-Framework, auf dem LobsterAI aufbaut
• AutoClaw – die lokale OpenClaw-App von Zhipu (benutzerdefinierte Modelle sprechen das OpenAI-Protokoll)
• Qoder – ein weiterer Desktop-Agent, dessen benutzerdefinierte Modelle Anthropic- und OpenAI-Endpunkte annehmen
• Chinesische Modelle – aktuelle IDs von GLM / Kimi / DeepSeek / Qwen im Angebot
• Fehlerbehebungsleitfaden

Enterprise →