OpenClaw
MarkdownTerminalagent · OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini
Vollständiger Leitfaden
| Format | Konfigurationsort |
|---|---|
| OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini | OpenClaw-Konfiguration (~/.openclaw/openclaw.json) → models.providers.<id>; Standardmodell: agents.defaults.model.primary; sichere Änderung: openclaw config set models.providers.<id> '<json>' --strict-json --merge |
Konfiguration
Kopieren Sie die Konfiguration und ersetzen Sie sk-... durch Ihren Schlüssel aus dem Ailoot-Kundenbereich. Speichern Sie den Schlüssel möglichst in der Umgebungsvariablen AILOOT_API_KEY, sofern die Anwendung dies unterstützt.
Rufen Sie vor dem Start GET /v1/models mit Ihrem Ailoot-Schlüssel ab. Wählen Sie eine genaue Modell-ID mit den Methoden POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent und tragen Sie diese ID in die Konfiguration ein. Prüfen Sie bei Agenten auch die Werkzeugunterstützung und die für Ihre Clientversion benötigten Funktionen.
{
"agents": {
"defaults": {
"model": {
"primary": "ailoot/claude-sonnet-5-5"
}
}
},
"models": {
"mode": "merge",
"providers": {
"ailoot": {
"baseUrl": "https://api.ailoot.ai/v1",
"apiKey": "${AILOOT_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "claude-sonnet-5-5",
"name": "Claude Sonnet 5.5",
"reasoning": true,
"input": [
"text"
],
"contextWindow": 1000000,
"maxTokens": 128000
},
{
"id": "deepseek-v4-pro",
"name": "DeepSeek V4 Pro",
"reasoning": true,
"input": [
"text"
],
"contextWindow": 1000000,
"maxTokens": 131072
}
]
},
"ailoot-claude": {
"baseUrl": "https://api.ailoot.ai",
"apiKey": "${AILOOT_API_KEY}",
"api": "anthropic-messages",
"models": [
{
"id": "claude-opus-5-5",
"name": "Claude Opus 5.5",
"reasoning": true,
"input": [
"text"
],
"contextWindow": 1000000,
"maxTokens": 131072
}
]
}
}
}
}Diese Konfiguration liest den Schlüssel aus der Variablen AILOOT_API_KEY. Setzen Sie sie vor dem Start der Anwendung:
export AILOOT_API_KEY="sk-..." # in ~/.zshrc oder ~/.bashrc eintragensetx AILOOT_API_KEY "sk-..." # anschliessend das Terminal neu startenBeispielmodell: claude-sonnet-5-5. Weitere Modelle finden Sie im Katalog — prüfen Sie, ob das benötigte Format verfügbar ist.
Gut zu wissen
Prüfung
- Für das OpenAI-Format lautet die Adresse
https://api.ailoot.ai/v1(oder der vollständige Pfad, falls die Anwendung eine vollständige Adresse verlangt). - Für das Anthropic-Format lautet die Adresse
https://api.ailoot.aiohne/v1. - Für das Gemini-Format lautet die Adresse
https://api.ailoot.ai— die Stammadresse der API. Die vollständige Konfiguration für dieses Format ist im obigen Beispiel nicht dargestellt; gleichen Sie den erforderlichen Pfad im Client-Feld mit der Dokumentation des Clients ab. Das Präfix der API-Route lautet:/v1beta. - Stellen Sie eine kurze Frage. Bei einem Fehler prüfen Sie Code und Request ID und vergleichen Sie sie mit der Seite Fehler und Limits.
- 404 direkt nach der Einrichtung bedeutet fast immer eine falsche Adresse: Ein überflüssiges oder fehlendes
/v1. - 402 — Guthaben reicht nicht für die Reservierung. Agenten reservieren mehr als ein Chat: warum.
Dokumentation der Anwendung: https://docs.openclaw.ai/gateway/config-tools/custom-providers