> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/de/integrationen/openclaw.md).
# Wie man lokale KI-Modelle mit OpenClaw ausführt
Diese Anleitung ermöglicht es dir, offene LLMs lokal mit **OpenClaw, indem du es mit Unsloth verbindest**. OpenClaw ist eine **Open-Source-KI-Agenten** Oberfläche, die sich mit einem Modell verbindet, um Aufgaben in deinem Projekt auszuführen.
OpenClaw kann mit jedem lokalen Modell arbeiten, indem es sich über **Unsloths OpenAI-kompatible API**: einschließlich DeepSeek, Qwen, Gemma und mehr. OpenClaw fungiert als Client, während Unsloth Modelle über eine **lokale API**.
Nach der Einrichtung läuft OpenClaw über Unsloth gegen dein lokales Modell, sodass du es direkt als **KI-Agenten verwenden kannst.**
Mit OpenClaw verbindenSchnellstart
{% hint style="info" %}
In diesem Tutorial verwenden wir `unsloth/Qwen3.6-27B-GGUF` in Unsloth und greifen über OpenClaw darauf zu. Lieber ein anderes Modell? Ersetze es einfach durch ein anderes Modell, indem du es in Unsloth lädst und die Konfiguration aktualisierst.
{% endhint %}
### OpenClaw installieren
{% tabs %}
{% tab title="macOS, Linux, WSL" %}
Installiere OpenClaw mit dem offiziellen Installer:
`curl -fsSL https://openclaw.ai/install.sh | bash`
Dadurch wird OpenClaw eingerichtet und du wirst durch die Ersteinrichtung geführt.
{% endtab %}
{% tab title="Windows (PowerShell)" %}
Installiere OpenClaw mit dem offiziellen Installer:
`iwr -useb https://openclaw.ai/install.ps1 | iex`
Dadurch wird OpenClaw eingerichtet und du wirst durch die Ersteinrichtung geführt.
{% endtab %}
{% endtabs %}
{% hint style="info" %}
Der API-Zugriff ist Teil von **Unsloth (Beta)**. Stelle sicher, dass du die neueste Version verwendest; frühere Builds stellen die externe API nicht bereit. Siehe Installation, um zu installieren oder zu aktualisieren.
{% endhint %}
### Unsloth installieren
### ⚡ Schnellstart
Nachdem wir OpenClaw installiert haben, müssen wir Unsloth Studio installieren, damit OpenClaw lokale Modelle bereitstellen und Inferenz ausführen kann.
1. **Installieren oder aktualisieren** [**Unsloth Studio**](/docs/de/neu/studio.md)**.** Frühere Versionen stellen die externe API nicht bereit. Siehe Installation.
2. **Starte Unsloth.** Merke dir den Port, auf dem es startet; das ist normalerweise `8000` oder `8888`. Du siehst ihn in der Terminalausgabe und in der Browser-URL (`http://localhost:PORT`).
3. **Lade ein Modell.** Klicke auf **Neuer Chat**, wähle oder suche ein Modell (GGUF) aus und warte, bis es vollständig geladen ist.
4. **Einen API-Schlüssel erstellen.** Klicke in Unsloth auf deinen **Unsloth** Avatar unten links → **Einstellungen** → **API-Schlüssel** → gib einen Schlüsselnamen ein → **Erstellen**. Kopiere den `sk-unsloth-…` angezeigten Wert. Unsloth zeigt ihn nur einmal an.
5. **Richte deinen Client auf Unsloth aus.** Verwende `http://localhost:PORT` als Basis-URL und deinen `sk-unsloth-…` Schlüssel zur Authentifizierung. Springe unten zum Rezept für dein Tool.
### 🔑 Einen API-Schlüssel erstellen
Schlüssel werden erstellt über **Unsloth → Einstellungen → API-Schlüssel**.
1. Öffne die Seitenleiste, klicke auf deinen **Unsloth** Avatar unten links.
2. Gehe zu **Einstellungen** → **API-Schlüssel**.
3. Gib einen freundlichen Namen ein (z. B. `claude-code-macbook`).
4. *(Optional)* Lege ein Ablaufdatum fest.
5. Klicke auf **Erstellen**.
6. **Kopiere den Schlüssel sofort.** Unsloth speichert nur einen Hash und du kannst ihn nicht erneut anzeigen.
Alle Schlüssel beginnen mit dem `sk-unsloth-` Präfix. Du kannst einen Schlüssel jederzeit auf derselben Seite widerrufen. Anfragen mit einem widerrufenen Schlüssel schlagen mit `401 Unauthorized`.
{% hint style="warning" %}
Behandle deinen API-Schlüssel wie ein Passwort. Jeder mit dem Schlüssel und Netzwerkzugriff auf deine Unsloth-Instanz kann Anfragen an dein geladenes Modell senden.
{% endhint %}
### Mit OpenClaw verbinden
OpenClaw liest seine Konfiguration aus `~/.openclaw/openclaw.json`. Füge einen `models` -Block mit einem `unsloth` Anbieter hinzu, der auf die Anthropic-Messages-API von Unsloth verweist.
{% code title="\~/.openclaw/openclaw\.json" %}
```json
{
"models": {
"mode": "merge",
"providers": {
"unsloth": {
"baseUrl": "http://localhost:8888",
"apiKey": "sk-unsloth-xxxxxxxxxxxx",
"api": "anthropic-messages",
"models": [
{
"id": "unsloth/Qwen3.6-27B-GGUF",
"name": "unsloth/Qwen3.6-27B-GGUF"
}
],
"authHeader": true
}
}
}
}
```
{% endcode %}
**Hinweise:**
* `baseUrl` ist die Studio-URL ohne Pfad. OpenClaw kommuniziert mit Studio über die Anthropic-Messages-API, und das Anthropic-SDK hängt `/v1/messages` selbst an, also füge `/v1` hier nicht hinzu (ein abschließendes `/v1` würde Anfragen senden an `/v1/v1/messages`).
* `api: "anthropic-messages"` weist OpenClaw an, mit Unsloths `/v1/messages` Endpunkt zu kommunizieren.
* `authHeader: true` sendet deinen Schlüssel als `Authorization: Bearer …`.
* Setze bei jedem Modell die `id` und `name` auf den Namen, den du beim Laden des Modells in Unsloth gewählt hast.
* Wenn du Unsloth auf einem entfernten Rechner ausführst, ersetze `localhost:8888` durch die Adresse dieses Rechners (z. B. `http://10.0.0.42:8888`).
### Optional: Modellverhalten konfigurieren
OpenClaw verbindet sich über das in Unsloth laufende Modell. Laufzeiteinstellungen können beim Starten des Servers konfiguriert werden.
```bash
# Standardmäßiges Generierungsverhalten konfigurieren (--disable-tools reicht OpenClaws eigene Tools durch)
unsloth run \
--model unsloth/gemma-4-26B-A4B-it-GGUF \
--disable-tools \
--reasoning off \
--temp 0.6
```
{% hint style="warning" %}
Verwende `--disable-tools` wenn du OpenClaw (oder einen anderen externen Coding-Agenten) steuerst. Standardmäßig führt Unsloth Studio seine eigenen serverseitigen Tools aus, wodurch die Tool-Aufrufe des Agenten verschluckt werden, sodass OpenClaw antwortet, aber nie Dateien bearbeitet. `--disable-tools` wechselt zu Durchleitung, sodass OpenClaws eigene Tools verwendet werden.
{% endhint %}
Verwende `--reasoning off` um das Denken auszuschalten, oder `--reasoning on` um es für Modelle einzuschalten, die Reasoning unterstützen.
```bash
# Verbindungen von anderen Geräten zulassen
unsloth run \
--model unsloth/gemma-4-26B-A4B-it-GGUF \
-H 0.0.0.0 \
-p 8888
```
Dadurch startet der Server auf `0.0.0.0:8888`, sodass sich andere Geräte in deinem lokalen Netzwerk verbinden können.
Weitere erweiterte Laufzeitkonfigurationen findest du im Hauptabschnitt [API-Anpassung](https://unsloth.ai/docs/basics/api#unsloth-run-command) .
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://unsloth.ai/docs/de/integrationen/openclaw.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.