# AutoClaw mit QCode.cc einrichten

> **Zuletzt überprüft**: 2026-11-10 · 📄 Laut offizieller Dokumentation (AutoClaw China-Website v2.3.0, veröffentlicht am 2026-10-29)

Kann AutoClaw Ihren eigenen API-Schlüssel nutzen? Ja, über das OpenAI-Protokoll. Stand 2026-11-10 laut offizieller Dokumentation und offiziellem Blog: Einstellungen → Models & API → benutzerdefiniertes Modell hinzufügen, den Anbieter auf Custom und das API-Protokoll auf OpenAI setzen, die OpenAI-Adresse von QCode als Base URL eintragen, dann den Verbindungstest ausführen und das Modell als Standard festlegen.

## Auf einen Blick

| Punkt | Details |
|---|---|
| Nutzbare Modelle | GPT ✅ · chinesische Modelle ✅ (DeepSeek / GLM / Kimi / Qwen) · Claude ❌ (das dokumentierte benutzerdefinierte Protokoll ist OpenAI) · Gemini ❌ (QCode bietet es derzeit nicht an) |
| Protokoll & Base URL | OpenAI: `https://api.qcode.cc/openai/v1` |
| Wo konfigurieren | In der App: Einstellungen → Models & API → benutzerdefiniertes Modell hinzufügen |
| Offizielle Dokumentation | [Model settings](https://autoclaw.zhipuai.cn/docs/advanced/models/) · [Local model setup guide](https://autoclaw.zhipuai.cn/blog/news/autoclaw-local-model-setup-guide/) · [Changelog](https://autoclaw.zhipuai.cn/changelog/) |

Das offizielle Dokumentationsportal beschreibt AutoClaw als Desktop-KI-Agenten von Zhipu, die erste App mit Ein-Klick-Installation für lokales OpenClaw. Es gibt eine China-Website (autoclaw.zhipuai.cn) und eine internationale Website (autoclaw.z.ai), deren englische Seite es als allgemeinen Agenten von Z.ai beschreibt. Versionsstand 2026-11-10: Das Changelog der China-Website nennt v2.3.0 (2026-10-29) als neueste Version; das internationale Changelog nennt zum selben Stichtag v1.17.8 (2026-08-27).

Die Oberfläche ist nur auf der China-Website und nur auf Chinesisch dokumentiert. Die englischen Bezeichnungen unten sind daher unsere Übersetzungen der chinesischen Oberfläche. Die internationale Website hat keine entsprechende Seite; halten Sie sich an die Beschriftungen in Ihrer installierten Version.

## Welches Protokoll Sie verwenden

Im offiziellen Blogbeispiel für ein benutzerdefiniertes Modell ist das API-Protokoll auf OpenAI gesetzt. Der Blog erklärt, AutoClaw funktioniere mit jedem Modelldienst, der mit dem OpenAI-Chat-Completions-Protokoll kompatibel ist. Bei QCode bedient dieses Protokoll GPT und chinesische Modelle (DeepSeek / GLM / Kimi / Qwen); die Base URL lautet `https://api.qcode.cc/openai/v1`.

Claude-Modelle laufen über den Anthropic-Endpunkt, den die Oberfläche für benutzerdefinierte Modelle in AutoClaw nicht verwendet. Wenn Sie Claude brauchen, sehen Sie sich Tools an, die einen Anthropic-Endpunkt akzeptieren: [LobsterAI](/docs/ide/lobsterai), [Qoder](/docs/ide/qoder), [OpenClaw](/docs/ide/openclaw) oder Claude Code im Terminal ([Installation und Einrichtung](/docs/getting-started/installation)). Die vollständige Matrix aus Modellen und Protokollen finden Sie unter [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths).

## Installation

Laden Sie das Installationsprogramm für macOS oder Windows von der [China-Website](https://autoclaw.zhipuai.cn/) herunter (laut offiziellem Blog werden macOS und Windows unterstützt) und folgen Sie der Anleitung beim ersten Start, um einen Arbeitsordner festzulegen. Außerdem benötigen Sie einen QCode-Schlüssel `cr_` aus dem [Dashboard](https://qcode.cc/dashboard). Ein Konto beim Entwickler des Modells ist nicht nötig.

## Konfiguration

Der Ablauf laut offiziellem Blog (2026-10-26): AutoClaw öffnen, unten links auf das Einstellungssymbol klicken und in der linken Navigation Models & API wählen. Die Seite hat zwei Bereiche: integrierte Modelle und benutzerdefinierte Modelle. Klicken Sie rechts auf Add custom model und setzen Sie im Dialog den Anbieter auf Custom. Die offizielle Seite Model settings beschreibt einen weiteren Weg: Klicken Sie im Chatfeld auf das aktuelle Modell, dann auf „+“, um ein benutzerdefiniertes Modell hinzuzufügen. Die App wechselt dann zu Einstellungen → Models & API.

Im Dialog tragen Sie Folgendes ein:

| Feld | Wert |
|---|---|
| Provider | `Custom` |
| Model ID | genau ein Modell aus [qcode.cc/models](https://qcode.cc/models), z. B. `gpt-6.1-sol` |
| API protocol | `OpenAI` |
| Base URL | `https://api.qcode.cc/openai/v1` |
| API Key | Ihr `cr_xxx` |

Beispiele für Modell-IDs: `gpt-6.1-sol`, `gpt-6.1-terra`, `glm-5.3`, `deepseek-v4.1-flash`, `kimi-k3`, `qwen3.8-max`. Preise je Modell finden Sie unter https://qcode.cc/models.

### Muss die Base URL `/v1` enthalten?

Ja, und Sie hören bei `/v1` auf. Grundlage ist das Beispiel des offiziellen Blogs: Für Ollama lautet die Base URL `http://localhost:11434/v1`. Der Blog bezeichnet dies als OpenAI-kompatible Endpunktadresse von Ollama und erklärt, dass der Pfad `/v1` die OpenAI-kompatible API bereitstellt. Für QCode ergibt sich `https://api.qcode.cc/openai/v1`; hängen Sie kein `/chat/completions` an. Die offizielle Dokumentation sagt nicht, welches Pfadsegment AutoClaw an die Base URL anhängt. Lassen Sie das daher den Verbindungstest im nächsten Schritt entscheiden. Bei instabilem Netz in Asien können Sie den Host durch `asia.qcode.cc` ersetzen; der Pfad bleibt gleich.

### Verbindungstest und als Standard setzen

1. Klicken Sie nach dem Ausfüllen der Felder auf den Verbindungstest. Laut offiziellem Blog sendet die App eine echte Anfrage; zeigt der Status einen erfolgreichen Test an, stimmt die Konfiguration.
2. Klicken Sie auf Add, um das Modell zu registrieren.
3. Suchen Sie in der Modellliste das neue Modell und klicken Sie auf Set as default; AutoClaw-Aufgaben laufen dann damit. Laut Blog können Sie auch mehrere benutzerdefinierte Modelle behalten und manuell wechseln.

## Prüfen

Wählen Sie nach erfolgreichem Test das Modell im Chatfeld und senden Sie `ping`. Um Netzwerk und Schlüssel vorab im Terminal zu prüfen (eine 400 bei leerem Body bedeutet, dass Pfad und Schlüssel passen):

```bash
KEY="cr_your_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](https://probe.qcode.cc). Geben Sie Ihren Schlüssel ein, um Modell und Statuscode jedes Aufrufs zu sehen.

## Bekannte Einschränkungen

- **Das Modell muss Tool-Aufrufe unterstützen**: Laut offiziellem Blog hängen die Kernfunktionen von AutoClaw am Tool-Calling. Das gewählte Modell muss daher Function Calling unterstützen. Andernfalls kann es chatten, aber keine Skills steuern, und die Aufgabenkette bricht ab.
- **Modelle von Drittanbietern laufen eigenständig**: Die offizielle Seite Model settings weist darauf hin, Dienststatus und Abrechnung des Drittanbieters zu beobachten, weil Aufrufe während der Nutzung weiterlaufen können. Ihre QCode-Nutzung sehen Sie im Dashboard und auf [probe.qcode.cc](https://probe.qcode.cc).

## Verwandte Dokumente

- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths): Protokolle und das Ausfüllen der Base URLs
- [Übersicht der Tool-Kompatibilität](/docs/ide/tool-compatibility): Protokollunterstützung aller Tools
- [LobsterAI-Integration](/docs/ide/lobsterai): ebenfalls auf OpenClaw basiert; die benutzerdefinierten Modelle akzeptieren Anthropic Compatible
- [OpenClaw-Integration](/docs/ide/openclaw): Konfiguration des OpenClaw-Frameworks selbst
- [Chinesische Modelle](/docs/usage/cn-models): aktuelle GLM / Kimi / DeepSeek / Qwen-IDs im Angebot
- [Fehlerbehebungsleitfaden](/docs/reference/troubleshooting)