Dokumentation

Copilot für Obsidian

Im BYOK-Tab von Copilot lässt sich über drei Felder ein benutzerdefinierter OpenAI-kompatibler Anbieter einrichten. Die Dokumentation beschreibt genau, in welchen Bereichen die daraus resultierenden Modelle verfügbar sind. Diese Seite hält sich an diese Präzision, statt das gesamte Plugin zu versprechen.

Settings → Copilot → BYOK → Add a custom provider: Anzeigename, Schlüssel und https://api.kunavo.com/v1 — Quick Chat immer, Agent Chat unter opencode, wenn der Anbieter dort angezeigt wird.

Settings → Copilot → BYOK → Add a provider → Add a custom provider

Display name             Kunavo
API key                  sk-kn-...
Base URL                 https://api.kunavo.com/v1
Enable CORS              off — see the note below before turning it on
Model ID → Add           claude-sonnet-5
                         claude-haiku-4-5
Search available models  discovery reads GET /v1/models; typed ids also work
Save                     needs at least one model and a routable endpoint

Die Basis-URL enthält hier das Suffix /v1. Die Dokumentation macht das anhand von Beispielen deutlich, nicht durch eine ausdrückliche Aussage: Sie sagt lediglich „Ein benutzerdefinierter OpenAI-kompatibler Anbieter benötigt eine Basis-URL“. Beide mitgelieferten OpenAI-kompatiblen Vorlagen verwenden jedoch standardmäßig eine URL, die auf /v1 endet – http://localhost:11434/v1 für Ollama und http://localhost:1234/v1 für LM Studio. Außerdem heißt es: „Die Modellerkennung verwendet die Antwort des Endpunkts auf /v1/models“. Wenn die Erkennung keine Modelle findet, solltest du diese beiden Angaben zuerst noch einmal prüfen.

Ein BYOK-Anbieter ist nicht in allen Bereichen des Plugins verfügbar, und die Dokumentation sagt das unmissverständlich: „Das Hinzufügen eines Schlüssels ändert nicht die von Claude Code oder Codex bereitgestellten Modelle.“ Die zugehörige Tabelle ordnet BYOK-Modelle ausdrücklich Quick Chat und Agent Chat nur mit dem opencode-Backend zu, „wenn der Anbieter dort angezeigt wird“ – eine Bedingung, keine allgemeine Regel. Außerdem heißt es: „Ein Modell, das opencode nicht weiterleiten kann, wird aus der opencode-Liste ausgeschlossen, funktioniert aber möglicherweise weiterhin in Quick Chat.“ Wenn du das Claude- oder Codex-Backend verwendest, musst du stattdessen die eigene Umgebung dieser CLI konfigurieren: siehe /docs/integrations/claude-code.

CORS aktivieren ist ein Kompromiss und keine Einstellung, die dauerhaft aktiviert bleiben sollte. In der Dokumentation heißt es: „Wenn der Test erfolgreich ist, Quick Chat aber keine Nachricht senden kann, bearbeite den Anbieter und aktiviere CORS aktivieren. Antworten werden dann nach Abschluss statt Token für Token angezeigt.“ Außerdem wird darauf hingewiesen, dass die Einstellung die Weiterleitung über opencode nicht ändert. Wenn du sie also zur Fehlerbehebung in Quick Chat aktivierst, entfällt dort die Token-für-Token-Ausgabe, aber in keinem anderen Bereich.

Copilot 4.x benötigt keinen Embedding-Anbieter: Die semantische Suche wurde in den separaten Dienst Miyo verlagert, und der BYOK-Dialog enthält kein entsprechendes Feld. Das ist auch gut so, denn Kunavo stellt kein Embedding-Modell bereit. Diese Seite wird also auch keines suggerieren.

Kunavo hat dieses Plugin nicht zur Laufzeit getestet. Alle oben genannten Felder und Zitate stammen aus der eigenen Dokumentation von Copilot, wie sie am unten angegebenen Datum vorlag. Eine veröffentlichte Einrichtungsseite ist kein Testlauf. Sende eine echte Aufgabe über Quick Chat, bevor du einen Arbeitsablauf darauf umstellst.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Copilot für Obsidian-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffne in Obsidian Einstellungen → Copilot → BYOK und klicke auf Anbieter hinzufügen.
Wähle Benutzerdefinierten Anbieter hinzufügen statt eines benannten Anbieters oder einer Vorlage für Self Host.
Fülle wie oben beschrieben Anzeigename, API-Schlüssel und Basis-URL aus. Lasse CORS aktivieren zunächst ausgeschaltet.
Füge mindestens ein Modell hinzu: Gib entweder unter Modell-ID → Hinzufügen eine ID ein oder wähle eine aus Verfügbare Modelle suchen, wo die Liste aus GET /v1/models geladen wird. Klicke auf Testen und dann auf Speichern. Das Speichern ist erst möglich, wenn sowohl ein Modell als auch ein erreichbarer Endpunkt vorhanden sind.
Lege unter Basic → Agents → Quick Chat und Basic → Agents → opencode fest, wo diese Modelle angezeigt werden sollen. Für jeden Bereich gibt es ein eigenes Standardmodell. Neue Chat-Modelle sind standardmäßig für beide aktiviert.

Abgeglichen mit Die Seite „Modellquellen und BYOK“ von Copilot am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Dies ist die Kurzfassung. Die vollständige Anleitung – Modellauswahl, Kosten einer tatsächlichen Sitzung und Fehlerszenarien – findest du in welches Copilot-Backend tatsächlich die Tokenkosten trägt.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Copilot für Obsidian.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Copilot für Obsidian hineinpasst
`claude-haiku-4-5`	$0.70 / $3.50	Quick Chat, wo den ganzen Tag über kurze Fragen zu einer Notiz gestellt werden
`claude-sonnet-5`	$1.40 / $7.00	das opencode-Backend in Agent Chat – das standardmäßige Arbeitsmodell
`claude-opus-5`	$3.50 / $17.50	lange Zusammenfassungen über viele Notizen hinweg, bei denen eine falsche Interpretation teuer ist
`gpt-5-6-sol`	$2.00 / $12.00	eine zweite Meinung aus einer anderen Modellfamilie mit demselben Schlüssel und Anbieter-Eintrag

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Häufig gestellte Fragen

Wo trage ich in Obsidian Copilot einen API-Schlüssel ein?

Einstellungen → Copilot → BYOK → Anbieter hinzufügen und dann „Benutzerdefinierten Anbieter hinzufügen“ für einen Endpunkt, der nicht in der integrierten Liste steht. Der Dialog enthält die Felder Anzeigename, API-Schlüssel und Basis-URL sowie die optionale Einstellung CORS aktivieren. Außerdem musst du mindestens ein Modell per ID hinzufügen oder aus der erkannten Liste auswählen, bevor du auf Speichern klickst. Laut Copilots Dokumentation werden Anbieterschlüssel im Obsidian-Schlüsselbund des jeweiligen Geräts und nicht in der Datei data.json des Tresors gespeichert. Beim Synchronisieren eines Tresors wird der Zugang also nicht auf einen anderen Computer übertragen.

Muss die Basis-URL von Obsidian Copilot am Ende /v1 enthalten?

Verwende das Format mit /v1 – für Kunavo https://api.kunavo.com/v1. Die Dokumentation formuliert die Regel nicht ausdrücklich, sondern sagt, dass ein benutzerdefinierter OpenAI-kompatibler Anbieter eine Basis-URL benötigt, dass die Modellerkennung die Antwort des Endpunkts auf /v1/models verwendet und dass die beiden mitgelieferten OpenAI-kompatiblen Vorlagen standardmäßig http://localhost:11434/v1 und http://localhost:1234/v1 verwenden. Beide mitgelieferten Standardwerte enthalten das Suffix. Das ist die deutlichste Aussage, die sich den Dokumenten dazu entnehmen lässt. Eine falsche Basis-URL führt in der Regel zu einer leeren Modellliste oder einem fehlgeschlagenen Test, nicht zu einem Authentifizierungsfehler.

Kann Obsidian Copilot statt eines Anbieterschlüssels ein Gateway wie OpenRouter oder Kunavo verwenden?

Ja für Quick Chat und unter bestimmten Bedingungen für Agent Chat. In der eigenen Dokumentation beschreibt Copilot BYOK als Verbindung „direkt mit einem KI-Anbieter, einem kompatiblen Gateway oder einem Modellserver auf deinem Computer“. Über „Benutzerdefinierten Anbieter hinzufügen“ lässt sich eine beliebige OpenAI-kompatible Basis-URL mit einer Modell-ID verwenden. Die Tabelle zu den Modellquellen ordnet BYOK-Modelle ausdrücklich Quick Chat und Agent Chat nur mit dem opencode-Backend zu, „wenn der Anbieter dort angezeigt wird“. Die Claude- und Codex-Backends akzeptieren BYOK-Schlüssel grundsätzlich nicht. Laut Dokumentation ändert das Hinzufügen eines Schlüssels nicht die von ihnen bereitgestellten Modelle.

Brauche ich für die Tresorsuche in Obsidian Copilot ein Embedding-Modell?

Nicht von deinem Chat-Anbieter. Copilot 4.x betreibt keinen eigenen Index mehr im Plugin. Laut Dokumentation werden semantische Suche und „Relevante Notizen“ vom separaten lokalen oder entfernten Dienst Miyo bereitgestellt. Der BYOK-Dialog enthält kein Feld für diese Art von Modell. Auch Kunavo stellt kein Embedding-Modell bereit. Diese Seite ist also nicht als Angebot eines solchen Modells zu verstehen: Ein Chat-Anbieter-Eintrag in Copilot übernimmt ausschließlich die Kosten für Chats.

Ersetzt ein Kunavo-Schlüssel eine Copilot Lite- oder Plus-Lizenz?

Nein, die beiden sind bewusst voneinander getrennt. In Copilots Dokumentation gelten eine Lizenz und BYOK als unterschiedliche Modellquellen: Eine Lizenz stellt von Copilot gehostete Modelle bereit, deren Kosten Brevilabs deinem Tarif anrechnet. BYOK sendet Anfragen an deinen eigenen Endpunkt, wobei die Abrechnung beim jeweiligen Anbieter bleibt. Ein Schlüssel hier füllt das Lizenzkontingent nicht wieder auf, schaltet gesperrte, von Copilot gehostete Einträge nicht frei und ändert nichts an lizenzgebundenen Diensten. Umgekehrt kannst du BYOK auch ohne Lizenz im kostenlosen Tarif verwenden.