Chatwoot Captain auf einem custom OpenAI-kompatiblen Endpoint betreiben.

Kurzantwort: drei Captain-Configs im Super Admin.

Bei aktuellem selbst gehostetem Chatwoot sind Captains LLM-Einstellungen Installations-Configs, keine .env-Variablen; die mitgelieferte .env.example sagt das explizit und verweist dich auf Super Admin, App Configs, Captain. Drei Werte zählen: CAPTAIN_OPEN_AI_API_KEY nimmt den Gateway-Key, CAPTAIN_OPEN_AI_MODEL nimmt die Modell-ID, und CAPTAIN_OPEN_AI_ENDPOINT nimmt den Endpoint-Host. Der Endpoint-Wert hat eine scharfe Kante: gib ihn ohne das /v1-Suffix an. Chatwoots Initializer baut die API-Base selbst, indem er einen abschließenden Slash entfernt und /v1 anhängt, und die eigene Beschreibung der Config zeigt den Default als https://api.openai.com/ in genau dieser Form. Für APIsRouter gib https://api.apisrouter.com ein und lass Chatwoot https://api.apisrouter.com/v1 ableiten. Diese Configs werden beim Boot der App gelesen, starte Chatwoot also nach dem Ändern neu.

CAPTAIN_OPEN_AI_API_KEY:  sk-YOUR-APISROUTER-KEY
CAPTAIN_OPEN_AI_MODEL:    claude-haiku-4-5-20251001
CAPTAIN_OPEN_AI_ENDPOINT: https://api.apisrouter.com
                          (no /v1 -- Chatwoot appends it)

then restart the Chatwoot processes

Was Captain mit dem konfigurierten Modell macht.

Chatwoot (rund 34.000 Stars auf GitHub) ist die führende Open-Source-Kundensupport-Plattform, und Captain ist ihre KI-Schicht: ein KI-Agent, der Kundengespräche aus deinen Hilfe-Center-Artikeln und FAQs beantwortet, ein Copilot, der Antworten für menschliche Agenten entwirft und Threads zusammenfasst, und dokumentengestützte Wissensfunktionen hinter beidem. Auf selbst gehosteten Installationen, wo Captain verfügbar ist, läuft das alles über das oben konfigurierte Modell. Unter der Haube konfiguriert Chatwoot sein Agents-SDK einmal beim Boot: den Key, die abgeleitete API-Base und das Standardmodell. Jede Captain-Funktion spricht dann Standard-Chat-Completions zu dieser Base URL, und die Modell-ID reist als reiner String. Chatwoot hält zwar eine Map von Modellnamen-Präfixen (claude-, gemini-, deepseek-), nutzt sie aber für Telemetrie-Labeling, nicht fürs Routing, also geht eine als CAPTAIN_OPEN_AI_MODEL gesetzte Claude- oder DeepSeek-ID trotzdem an deinen konfigurierten Endpoint wie jeder andere String. Support-Traffic hat ein charakteristisches Kostenprofil: viele Gespräche, kurze Züge, und fundierte Antworten aus abgerufenen Artikeln zusammengesetzt. Das macht die Kosten pro Gespräch zur entscheidenden Zahl, und sie werden von Input-Token aus dem abgerufenen Kontext dominiert. Eine schnelle ID bedient die Agenten-Stufe gut, mit Eskalation zu einer stärkeren ID als Ein-Config-Änderung, wenn der Copilot bessere Entwürfe schreiben soll.

Vollständiges Setup und das Boot-Zeit-Detail.

Öffne die Super-Admin-Konsole deiner Installation, geh zu App Configs und wähl Captain, dann füll die drei Werte aus. Stammt dein Chatwoot aus der Zeit vor der Endpoint-Config (sie kam in der v4.4-Ära Mitte 2025), aktualisiere zuerst; in älteren Versionen existierten nur Key und Modell, und der Endpoint war fest verdrahtet. Weil der Initializer diese Configs beim App-Boot liest, greifen Änderungen erst nach einem Neustart der Web- und Worker-Prozesse. Das bedeutet auch, ein falscher Wert scheitert nicht beim Speichern; er scheitert bei der ersten Captain-Anfrage nach dem Neustart, gut zu wissen, bevor du an der falschen Stelle debuggst. Captain hat auch eine Embedding-Seite: CAPTAIN_EMBEDDING_MODEL (Standard text-embedding-3-small) treibt die Dokumentensuche über deinen Hilfe-Center-Content, und sie löst sich gegen denselben konfigurierten Endpoint auf. Zeigst du den Endpoint auf ein Gateway um, bestätige, dass die dort konfigurierte Embedding-ID vom Endpoint tatsächlich bedient wird; belass Dokumentenfunktionen sonst auf ihrem bestehenden Setup und validiere sie nach dem Wechsel separat.

# Chatwoot will call <endpoint>/v1/chat/completions
curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Ein Modell für Support-Automation wählen.

Die Bewertungsschleife, die funktioniert: eine Woche auf einer schnellen ID laufen lassen, die Nutzungszahlen exportieren, dann die copilot-lastigen Teams auf einer stärkeren ID laufen lassen und die Akzeptanz von Entwürfen vergleichen statt Bauchgefühl. Beide Kandidaten rechnen über denselben Key ab, also kommt der Vergleich bepreist an.

• Die KI-Agenten-Stufe ist Volumenarbeit: fundierte Antworten über abgerufene Artikel, Tausende Gespräche pro Monat. claude-haiku-4-5-20251001, gpt-5.4-mini und gemini-3.5-flash halten die Kosten pro Gespräch flach, ohne die Grounding-Disziplin zu verlieren.
• Die Copilot-Stufe liest ganze Threads und entwirft Antworten für Menschen, wo Ton und Urteilsvermögen sichtbar werden. claude-sonnet-4-6 ist der natürliche Schritt nach oben, wenn Entwurfsqualität die Agenten-Produktivität treibt.
• Mehrsprachige Support-Desks sollten deepseek-v4-pro und gemini-3.5-flash an ihrem echten Sprachmix testen; die Qualität fundierter Antworten variiert über Sprachen hinweg stärker, als englische Benchmarks vermuten lassen.
• Kosten pro Gespräch sind messbar, nicht theoretisch: Token pro Gespräch mal Gespräche pro Monat, direkt aus dem Nutzungslog.
• Ein Modell bedient alle Captain-Funktionen pro Installation, wähle also für deine dominante Workload und überdenk es nach einer Woche echter Nutzungsdaten.

Nutzungsbasiert · unter offiziellem Preis

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Fehlerbilder speziell für Chatwoot Captain.

Das doppelte /v1-Suffix ist der Klassiker. Weil Chatwoot /v1 an das anhängt, was du eingibst, erzeugt das Einfügen von https://api.apisrouter.com/v1 Requests gegen /v1/v1/chat/completions, die am Gateway mit 404 scheitern. Gib den Host ohne /v1 ein. Config-Änderungen, die ignoriert scheinen, sind die Neustart-Regel. Das Agents-SDK wird einmal beim Boot aus den Installations-Configs konfiguriert; sie im Super Admin zu bearbeiten, ohne neu zu starten, lässt die alten Werte in jedem laufenden Prozess live. Alte Guides zeigen auf die falsche Oberfläche. Tutorials aus früheren Chatwoot-Versionen konfigurieren OPENAI_API_KEY über Umgebungsvariablen oder die Legacy-OpenAI-Integration; bei aktuellen Versionen sind die Captain-Configs im Super Admin die Oberfläche, und die .env.example sagt das so ausdrücklich. Model-not-found bei Captains erster Antwort nach einem Wechsel ist ein ID-Tippfehler in CAPTAIN_OPEN_AI_MODEL; die /v1/models-Liste des Gateways ist die maßgebliche Schreibweise. Authentifizierungsfehler bedeuten, Key- und Endpoint-Configs gehören nicht zusammen. Und degradiert die Artikelsuche oder Dokumenten-Grounding, während Chat-Antworten gut funktionieren, schau auf die Embedding-Config, ein separates Modell, das sich gegen denselben Endpoint auflöst.

Wer Chatwoot Captain über ein Gateway routet.

• Selbst gehostete Support-Teams, die Claude-Qualität im Copilot ohne separates Vendor-Konto und Billing-Beziehung wollen.
• Hochvolumige Desks, wo der KI-Agent die meisten Gespräche beantwortet und die Kosten pro Gespräch entscheiden, ob sich Automation rechnet; schnelle Katalog-IDs halten diese Zahl ehrlich.
• Teams, die ein Chatwoot pro Marke oder Region betreiben und jede Installation mit ihrem eigenen Key messen, sodass Support-KI-Kosten sich pro Marke selbst berichten.
• Betreiber, die Support-Modelle an echtem Traffic vergleichen: jeder Kandidat ist ein Config-Wert und ein Neustart, keine Migration.
• Entwickler ohne Zugang zum Billing eines bestimmten Vendors. Guthabenbasierter Zugang ohne Kartenpflicht entfernt die Sign-up-Abhängigkeit pro Provider.

Endpoint verifizieren und das erste Gespräch debuggen.

Verifiziere zuerst außerhalb von Chatwoot: liste Modelle mit deinem Key und lauf eine Chat Completion gegen genau die ID, die du in CAPTAIN_OPEN_AI_MODEL gesetzt hast. Bestehen die, ist die Gateway-Hälfte bewiesen, und alles andere ist Chatwoot-seitig. Starte dann neu und beobachte die erste Captain-Interaktion. Authentifizierungsfehler weisen auf die Key-Config, model-not-found auf die Modell-Config, 404-förmige Fehler auf ein in die Endpoint-Config eingefügtes /v1. Erscheinen Captain-Funktionen einfach nicht, ist das Verfügbarkeit und Lizenzierung auf deiner Installations-Stufe, keine Endpoint-Konfiguration. Sobald Gespräche fließen, zeigt die APIsRouter-Konsole Modell, Token-Zahlen und Ausgaben pro Anfrage. Support-KI ist eine Budgetposition, die sich monatlich aufsummiert, und ein Key pro Installation macht das Nutzungslog zum Kostenreport pro Desk, den dein Finance-Team immer wieder anfragt.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

Häufige Fragen