> 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 zeigt, wie Sie lokale offene LLMs mit **OpenClaw verwenden, indem Sie es mit Unsloth verbinden**. OpenClaw ist eine **Open-Source-KI-Agent** Schnittstelle, die sich mit einem Modell verbindet, um Aufgaben in Ihrem 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 lädt und bereitstellt **lokale API**.Nach der Einrichtung wird OpenClaw über Unsloth mit Ihrem lokalen Modell ausgeführt, sodass Sie es direkt als **KI-Agenten verwenden können.** In diesem Tutorial verwenden wir [Qwen3.6](/docs/de/modelle/qwen3.6.md).
Mit OpenClaw verbindenSchnellstart
{% hint style="info" %}
In diesem Tutorial verwenden wir `unsloth/Qwen3.6-27B-GGUF` in Unsloth und greifen Sie über OpenClaw darauf zu. Bevorzugen Sie ein anderes Modell? Tauschen Sie es einfach aus, indem Sie ein anderes Modell in Unsloth laden und die Konfiguration aktualisieren.
{% endhint %}
### OpenClaw installieren
{% tabs %}
{% tab title="macOS, Linux, WSL" %}
Installieren Sie OpenClaw mit dem offiziellen Installationsprogramm:
`curl -fsSL https://openclaw.ai/install.sh | bash`
Dadurch wird OpenClaw eingerichtet und Sie durch die Erstkonfiguration geführt.
{% endtab %}
{% tab title="Windows (PowerShell)" %}
Installieren Sie OpenClaw mit dem offiziellen Installationsprogramm:
`iwr -useb https://openclaw.ai/install.ps1 | iex`
Dadurch wird OpenClaw eingerichtet und Sie durch die Erstkonfiguration geführt.
{% endtab %}
{% endtabs %}
### ⚡ Schnellstart
Nach der Installation von OpenClaw 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. **Starten Sie Unsloth.** Beachten Sie, dass der Port, auf dem es startet, normalerweise `8000` oder `8888`. Sie sehen ihn in der Terminalausgabe und in der Browser-URL (`http://localhost:PORT`).
3. **Lade ein Modell.** Klicken Sie auf **Neuer Chat**, wähle oder suche ein Modell (GGUF) und warte, bis das Laden abgeschlossen ist.
4. **Verbinden Sie OpenClaw.** Führen Sie aus `unsloth start openclaw` um OpenClaw mit dem geladenen Unsloth-Modell in einer separaten verwalteten Umgebung zu starten. Ihre normale OpenClaw-Konfiguration bleibt unverändert.
### ⚙️ Starten Sie OpenClaw mit `unsloth start`
OpenClaw kann sich mit einem Modell verbinden, das bereits in Unsloth Studio läuft, oder automatisch eines starten, wenn Unsloth nicht ausgeführt wird.
Mit einer laufenden Unsloth-Instanz verbinden
Sobald ein Modell in Unsloth Studio geladen ist, führen Sie aus:
```bash
unsloth start openclaw
```
Unsloth startet OpenClaw im lokalen TUI-Modus mit dem Unsloth-Provider, dem Modell und der Kontexterlänge, konfiguriert in einer separaten verwalteten Umgebung. Ihre normale OpenClaw-Einrichtung bleibt unverändert.
Sobald OpenClaw geöffnet ist, geben Sie ihm eine Aufgabe wie:
```
Untersuche dieses Repo und fasse es in einem Satz zusammen: https://github.com/unslothai/unsloth
```
#### Modell automatisch starten
Wenn Unsloth Studio noch nicht läuft, geben Sie eine Modell-ID an:
```bash
unsloth start openclaw --model unsloth/Qwen3.6-27B-GGUF
```
Unsloth startet das Modell, startet OpenClaw und stoppt den temporären Server, wenn Sie beenden. \n\nUm Ihren OpenClaw-Status beizubehalten und später zur selben Sitzung zurückzukehren, fügen Sie `--persist` und wählen Sie einen Sitzungs-Schlüssel:
```bash
unsloth start openclaw \\
--model unsloth/Qwen3.6-27B-GGUF \\
--persist \\
agent --local \\
--session-key my-session \\
--message "Inspect this repository"
```
Später mit demselben Sitzungs-Schlüssel fortfahren:
```bash
unsloth start openclaw \\
--model unsloth/Qwen3.6-27B-GGUF \\
--persist \\
agent --local \\
--session-key my-session \\
--message "Continue"
```
Siehe die vollständige [unsloth start](/docs/de/integrationen/unsloth-start.md) Referenz für benannte Sitzungen, das Laden von Modellen, entfernte Unsloth-Server und erweiterte Optionen.
Der Rest dieser Anleitung behandelt das manuelle Einrichten des OpenClaw-Providers.
### Manuelle Einrichtung des OpenClaw-Providers
### 🔑 Einen API-Schlüssel erstellen
Schlüssel werden erstellt in **Unsloth → Einstellungen → API-Schlüssel**.
1. Öffne die Seitenleiste und klicke unten links auf dein **Unsloth** Profilbild.
2. Gehe zu **Einstellungen** → **API-Schlüssel**.
3. Gib einen aussagekräftigen Namen ein (z. B. `claude-code-macbook`).
4. *(Optional)* Legen Sie ein Ablaufdatum fest.
5. Klicken Sie auf **Erstellen**.
6. **Kopieren Sie den Schlüssel sofort.** Unsloth speichert nur einen Hash und du kannst ihn nicht erneut ansehen.
Alle Schlüssel beginnen mit dem `sk-unsloth-` Präfix. Widerrufe einen Schlüssel jederzeit auf derselben Seite. Anfragen mit einem widerrufenen Schlüssel schlagen mit `401 Unauthorized`.
### Mit OpenClaw verbinden
OpenClaw liest seine Konfiguration aus `~/.openclaw/openclaw.json`. Fügen Sie einen hinzu (oder führen Sie ihn zusammen) `Modelle` Block mit einem `unsloth` Provider hinzu, der auf Unsloths Anthropic-Messages-API 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 Unsloth-Ursprungsadresse ohne Pfad. OpenClaw kommuniziert mit Unsloth über die Anthropic-Messages-API, und das Anthropic-SDK hängt `/v1/messages` sie selbst an, fügen Sie also kein `/v1` hier hinzu (ein angehängtes `/v1` würde Anfragen an `/v1/v1/messages`).
* `api: "anthropic-messages"` weist OpenClaw an, mit Unsloths `/v1/messages` Endpunkt zu kommunizieren.
* `authHeader: true` sendet Ihren Schlüssel als `Authorization: Bearer …`.
* Setzen Sie für jedes Modell den `id` und `Namen` auf den Namen, den Sie beim Laden des Modells in Unsloth gewählt haben.
* Wenn Sie Unsloth auf einem entfernten Rechner ausführen, ersetzen Sie `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
# Standard-Generierungsverhalten konfigurieren (--disable-tools reicht OpenClaws eigene Werkzeuge durch)
unsloth run \\
--model unsloth/gemma-4-26B-A4B-it-GGUF \\
--disable-tools \\
--reasoning off \\
--temp 0.6
```
{% hint style="warning" %}
Verwende `--disable-tools` beim Steuern von OpenClaw (oder jedem anderen externen Coding-Agenten). Standardmäßig führt Unsloth Studio seine eigenen serverseitigen Werkzeuge aus, die die Werkzeugaufrufe des Agenten abfangen, sodass OpenClaw antwortet, aber nie Dateien bearbeitet. `--disable-tools` wechselt auf Durchleitung, sodass OpenClaws eigene Werkzeuge verwendet werden.
{% endhint %}
Verwende `--reasoning off` um das Denken auszuschalten, oder `--reasoning on` um es für Modelle, die Schlussfolgern unterstützen, einzuschalten.
```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 andere Geräte in Ihrem lokalen Netzwerk eine Verbindung herstellen können.
Für eine erweiterte Laufzeitkonfiguration siehe den Hauptabschnitt [API-Optimierung](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, and the optional `goal` query parameter:
```
GET https://unsloth.ai/docs/de/integrationen/openclaw.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.