Uruchom Chatwoot Captain na niestandardowym endpoincie kompatybilnym z OpenAI.

Szybka odpowiedź: trzy konfiguracje Captain w Super Admin.

W obecnym samodzielnie hostowanym Chatwoot ustawienia LLM Captain to konfiguracje instalacji, nie zmienne .env; dostarczany .env.example mówi to wprost i kieruje Cię do Super Admin, App Configs, Captain. Liczą się trzy wartości: CAPTAIN_OPEN_AI_API_KEY przyjmuje klucz bramki, CAPTAIN_OPEN_AI_MODEL przyjmuje identyfikator modelu, a CAPTAIN_OPEN_AI_ENDPOINT przyjmuje host endpointu. Wartość endpointu ma jedną ostrą krawędź: podaj ją bez sufiksu /v1. Inicjalizator Chatwoot sam buduje bazę API, przycinając końcowy ukośnik i doklejając /v1, a własny opis konfiguracji pokazuje domyślną wartość jako https://api.openai.com/ dokładnie w tym kształcie. Dla APIsRouter wpisz https://api.apisrouter.com i pozwól Chatwoot wyprowadzić https://api.apisrouter.com/v1. Te konfiguracje są czytane przy starcie aplikacji, więc zrestartuj Chatwoot po ich zmianie.

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

Co Captain robi ze skonfigurowanym modelem.

Chatwoot (około 34 tys. gwiazdek na GitHubie) to wiodąca open-source'owa platforma wsparcia klienta, a Captain to jej warstwa AI: agent AI odpowiadający na rozmowy klientów na podstawie artykułów i FAQ z Twojego centrum pomocy, copilot piszący szkice odpowiedzi i streszczający wątki dla ludzkich agentów, oraz funkcje wiedzy oparte na dokumentach za obiema. Na instalacjach self-hosted, gdzie Captain jest dostępny, wszystko to działa przez model skonfigurowany powyżej. Pod spodem Chatwoot konfiguruje swój agents SDK raz przy starcie: klucz, wyprowadzoną bazę API i domyślny model. Każda funkcja Captain mówi wtedy standardowym chat completions do tego base URL, a identyfikator modelu podróżuje jako zwykły string. Chatwoot trzyma mapę prefiksów nazw modeli (claude-, gemini-, deepseek-), ale używa jej do etykietowania telemetrii, nie routingu, więc identyfikator Claude albo DeepSeek ustawiony jako CAPTAIN_OPEN_AI_MODEL nadal idzie do Twojego skonfigurowanego endpointu jak każdy inny string. Ruch wsparcia ma charakterystyczny profil kosztowy: wiele rozmów, krótkie tury i ugruntowane odpowiedzi składane z pobranych artykułów. To sprawia, że koszt per rozmowa jest liczbą, która się liczy, i jest zdominowany przez tokeny wejściowe z pobranego kontekstu. Szybki identyfikator dobrze obsługuje tier agenta, a eskalacja do mocniejszego identyfikatora to zmiana jednej konfiguracji, gdy chcesz, żeby copilot pisał lepsze szkice.

Pełna konfiguracja i szczegół czasu startu.

Otwórz konsolę Super Admin na swojej instalacji, przejdź do App Configs i wybierz Captain, a następnie wypełnij trzy wartości. Jeśli Twój Chatwoot poprzedza konfigurację endpointu (wylądowała w erze v4.4 w połowie 2025), zaktualizuj najpierw; w starszych wersjach istniały tylko klucz i model, a endpoint był zakodowany na sztywno. Ponieważ inicjalizator czyta te konfiguracje podczas startu aplikacji, zmiany wchodzą w życie po restarcie procesów web i worker. To oznacza też, że zła wartość nie zawodzi w momencie zapisu; zawodzi przy pierwszym żądaniu Captain po restarcie, co warto wiedzieć, zanim zaczniesz debugować w złym miejscu. Captain ma też stronę embeddingową: CAPTAIN_EMBEDDING_MODEL (domyślnie text-embedding-3-small) napędza wyszukiwanie dokumentów po treści Twojego centrum pomocy i rozwiązuje się względem tego samego skonfigurowanego endpointu. Jeśli przekierowujesz endpoint na bramkę, potwierdź, że identyfikator embeddingu, który tam konfigurujesz, jest jednym z tych, które endpoint faktycznie serwuje; w przeciwnym razie zostaw funkcje dokumentów na ich obecnej konfiguracji i zwaliduj je osobno po przełączeniu.

# 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"}]}'

Dobór modelu do automatyzacji wsparcia.

Pętla ewaluacji, która działa: uruchom tydzień na szybkim identyfikatorze, wyeksportuj liczby użycia, a potem uruchom zespoły ciężkie na copilocie na mocniejszym identyfikatorze i porównaj akceptację szkiców zamiast przeczucia. Oba kandydaty rozliczają się przez ten sam klucz, więc porównanie przychodzi wycenione.

• Tier agenta AI to praca wolumenowa: ugruntowane odpowiedzi na pobranych artykułach, tysiące rozmów miesięcznie. claude-haiku-4-5-20251001, gpt-5.4-mini i gemini-3.5-flash utrzymują koszt per rozmowa na płaskim poziomie, nie tracąc dyscypliny ugruntowania.
• Tier copilota czyta całe wątki i pisze szkice odpowiedzi dla ludzi, gdzie widać ton i osąd. claude-sonnet-4-6 to naturalny krok w górę, gdy jakość szkicu napędza produktywność agenta.
• Wielojęzyczne biura wsparcia powinny przetestować deepseek-v4-pro i gemini-3.5-flash na swojej prawdziwej mieszance językowej; jakość ugruntowanej odpowiedzi zmienia się między językami bardziej, niż sugerują benchmarki angielskie.
• Koszt per rozmowa jest mierzalny, nie teoretyczny: tokeny per rozmowa razy rozmowy per miesiąc, prosto z logu użycia.
• Jeden model obsługuje wszystkie funkcje Captain per instalacja, więc wybieraj pod swoje dominujące obciążenie i wracaj do wyboru po przeczytaniu tygodnia prawdziwego użycia.

Płatność za użycie · poniżej cen oficjalnych

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

Tryby awarii charakterystyczne dla Chatwoot Captain.

Podwójny sufiks /v1 to klasyk. Ponieważ Chatwoot dokleja /v1 do tego, co wpiszesz, wklejenie https://api.apisrouter.com/v1 produkuje żądania przeciwko /v1/v1/chat/completions, które dostają 404 z bramki. Wpisz host bez /v1. Zmiany konfiguracji, które wyglądają na ignorowane, to zasada restartu. Agents SDK jest konfigurowany raz przy starcie z konfiguracji instalacji; edytowanie ich w Super Admin bez restartu zostawia stare wartości żywe w każdym działającym procesie. Stare przewodniki wskazują na złą powierzchnię. Tutoriale ze starszych wersji Chatwoot konfigurują OPENAI_API_KEY przez zmienne środowiskowe albo starą integrację OpenAI; w obecnych wersjach powierzchnią są konfiguracje Captain w Super Admin, i .env.example mówi to wprost. Model-not-found przy pierwszej odpowiedzi Captain po przełączeniu to literówka w identyfikatorze CAPTAIN_OPEN_AI_MODEL; listing /v1/models bramki jest autorytatywną pisownią. Błędy uwierzytelniania oznaczają, że konfiguracje klucza i endpointu do siebie nie pasują. A jeśli wyszukiwanie artykułów albo ugruntowanie dokumentów degraduje się, podczas gdy czat odpowiada dobrze, spójrz na konfigurację embeddingu, która jest osobnym modelem rozwiązującym się względem tego samego endpointu.

Kto kieruje Chatwoot Captain przez bramkę.

• Zespoły wsparcia self-hosted, które chcą jakości Claude w pisaniu szkiców w copilocie bez osobnego konta dostawcy i relacji rozliczeniowej.
• Biura o wysokim wolumenie, gdzie agent AI odpowiada na większość rozmów, a koszt per rozmowa decyduje, czy automatyzacja się opłaca; szybkie identyfikatory z katalogu utrzymują tę liczbę uczciwą.
• Zespoły prowadzące jeden Chatwoot per marka albo region, mierzące każdą instalację własnym kluczem, żeby koszt AI wsparcia sam się raportował per marka.
• Operatorzy porównujący modele wsparcia na prawdziwym ruchu: każdy kandydat to jedna wartość konfiguracji i restart, nie migracja.
• Deweloperzy bez dostępu do rozliczeń danego dostawcy. Dostęp oparty na doładowaniu, bez wymogu karty, usuwa zależność od rejestracji u każdego dostawcy z osobna.

Zweryfikuj endpoint i debuguj pierwszą rozmowę.

Zweryfikuj najpierw poza Chatwoot: wylistuj modele swoim kluczem i uruchom jedno chat completion względem dokładnego identyfikatora, który ustawiłeś w CAPTAIN_OPEN_AI_MODEL. Jeśli to przejdzie, połowa bramki jest udowodniona, a wszystko inne leży po stronie Chatwoot. Potem zrestartuj i obserwuj pierwszą interakcję Captain. Awarie uwierzytelniania wskazują na konfigurację klucza; model-not-found wskazuje na konfigurację modelu; błędy w kształcie 404 wskazują na /v1 wklejone w konfigurację endpointu. Jeśli funkcje Captain po prostu się nie pojawiają, to kwestia dostępności i licencjonowania na Twoim tierze instalacji, nie konfiguracji endpointu. Gdy rozmowy już płyną, konsola APIsRouter pokazuje model per żądanie, liczbę tokenów i wydatki. AI wsparcia to linia budżetowa, która kumuluje się miesięcznie, a jeden klucz per instalacja zamienia log użycia w raport kosztów per biuro, o który wciąż pyta Twój dział finansowy.

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

Częste pytania