> 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/fr/integrations/openclaw.md).

# Comment exécuter des modèles d’IA locaux avec OpenClaw

Guide pour exécuter des LLM locaux avec OpenClaw.

Ce guide montrera comment utiliser des LLM open source localement avec **OpenClaw en le connectant à Unsloth**. OpenClaw est une **interface d’agent IA open source** qui se connecte à un modèle pour exécuter des tâches dans tout votre projet. OpenClaw peut fonctionner avec n’importe quel modèle local en se connectant via **l’API compatible OpenAI d’Unsloth**: notamment DeepSeek, Qwen, Gemma, et bien d’autres.

OpenClaw agit comme client, tandis qu’Unsloth charge et sert les modèles via une **API locale**.Après la configuration, OpenClaw s’exécutera sur votre modèle local via Unsloth, ce qui vous permettra de l’utiliser directement comme un **agent IA.** Dans ce tutoriel, nous utiliserons [Qwen3.6](/docs/fr/modeles/qwen3.6.md).

<a href="/docs/fr/integrations/openclaw.md#connecting-to-openclaw" class="button primary" data-icon="lobster">Connexion à OpenClaw</a><a href="/docs/fr/integrations/openclaw.md#quickstart" class="button primary">Démarrage rapide</a>

{% hint style="info" %}
Dans ce tutoriel, nous utiliserons `unsloth/Qwen3.6-27B-GGUF` dans Unsloth et y accéderons via OpenClaw. Vous préférez un autre modèle ? Remplacez-le par n’importe quel autre modèle en le chargeant dans Unsloth et en mettant à jour la configuration.
{% endhint %}

### Installation d’OpenClaw

{% tabs %}
{% tab title="macOS, Linux, WSL" %}
Installez OpenClaw à l’aide du programme d’installation officiel :

`curl -fsSL https://openclaw.ai/install.sh | bash`

Cela configure OpenClaw et vous guide dans la configuration initiale.
{% endtab %}

{% tab title="Windows (PowerShell)" %}
Installez OpenClaw à l’aide du programme d’installation officiel :

`iwr -useb https://openclaw.ai/install.ps1 | iex`

Cela configure OpenClaw et vous guide dans la configuration initiale.
{% endtab %}
{% endtabs %}

### ⚡ Démarrage rapide

Après avoir installé OpenClaw, nous devrons installer [Unsloth Desktop](/docs/fr/desktop.md) pour permettre à OpenClaw de servir et d’exécuter l’inférence de modèles locaux.

{% stepper %}
{% step %}

#### Télécharger Unsloth

La façon la plus simple de commencer est d’installer l’application Unsloth Desktop. Elle prend en charge [MacOS](/docs/fr/commencer/install/mac.md), Linux, [Windows](/docs/fr/commencer/install/windows-installation.md), [NVIDIA](/docs/fr/commencer/install/pip-install.md), [AMD](/docs/fr/commencer/install/amd.md), Intel et les configurations CPU.

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Télécharger Unsloth</a>

* <i class="fa-apple">:apple:</i> [Télécharger pour macOS](https://unsloth.ai/download/mac)
* <i class="fa-windows">:windows:</i> [Télécharger pour Windows](https://unsloth.ai/download/windows)
* <i class="fa-linux">:linux:</i> [Télécharger pour Linux](https://unsloth.ai/download/linux)

Ou, si vous préférez une installation manuelle :

**MacOS, Linux, WSL :**

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

**Windows PowerShell :**

```bash
irm https://unsloth.ai/install.ps1 | iex
```

{% endstep %}

{% step %}

#### Installer

1. Ouvrez le programme d’installation d’Unsloth (`.dmg`, `.exe` fichiers)
2. Faites glisser Unsloth vers Applications sur Mac ou terminez la configuration pour Windows.
3. Lancez l’application et attendez la fin de l’installation
   {% endstep %}

{% step %}

#### Choisir un modèle

Ouvrez le menu déroulant « Select model » en haut ou l’onglet « Model hub », choisissez un modèle et une quantification adaptés à votre appareil, puis téléchargez-le. Une fois le téléchargement terminé, commencez à discuter — aucune configuration requise.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FNCEVgKLJI0goPqjgcg9B%2Fmodel%20hub%20models.png?alt=media&amp;token=533b5e3c-a901-4b33-963e-4a703cc9d5a6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Unsloth est maintenant prêt

Pour commencer à discuter, saisissez un message et appuyez sur Entrée.

**Connectez OpenClaw.** Exécutez `unsloth start openclaw` pour lancer OpenClaw avec le modèle Unsloth chargé dans un environnement géré séparé. Votre configuration OpenClaw habituelle reste inchangée.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FpAGvwjGD0iVMZKBoyu7m%2Fgreeennn.png?alt=media&amp;token=d17a5528-8375-444c-9aff-f9e9f7903bcd" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### ⚙️ Lancer OpenClaw avec `unsloth start`

OpenClaw peut se connecter à un modèle déjà en cours d’exécution dans Unsloth Studio, ou en démarrer un automatiquement lorsque Unsloth n’est pas en cours d’exécution.

Se connecter à une instance Unsloth en cours d’exécution

Une fois qu’un modèle est chargé dans Unsloth Studio, exécutez :

```bash
unsloth start openclaw
```

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQm2hy6E5WvSzvmhQX0VL%2Fimage.png?alt=media&amp;token=e87ad9ac-8c43-4d20-9276-10eed404bd89" alt="" width="563"><figcaption></figcaption></figure></div>

Unsloth lance OpenClaw en mode TUI local avec le fournisseur, le modèle et la longueur de contexte Unsloth configurés dans un environnement géré séparé. Votre configuration OpenClaw habituelle reste inchangée.

Une fois OpenClaw ouvert, donnez-lui une tâche telle que :

```
inspectez ce dépôt et résumez-le en une phrase : https://github.com/unslothai/unsloth
```

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fz93FYVhDJZKkBw3bY5X9%2Fimage.png?alt=media&amp;token=f79db6e8-59ea-4ac7-8008-fe6e6124d977" alt="" width="563"><figcaption></figcaption></figure></div>

#### Démarrer un modèle automatiquement

Si Unsloth n’est pas déjà en cours d’exécution, fournissez un identifiant de modèle :

Pour lancer OpenClaw directement avec un modèle, exécutez :

```bash
unsloth start openclaw \
    --model unsloth/Qwen3.8-27B-GGUF-GGUF:UD-Q4_K_XL
    --temp 1.0 \
    --top-p 0.95 \
    --top-k 20 \
    --min-p 0.0 \
    --reasoning-effort medium
```

Unsloth sélectionne automatiquement les bons paramètres à utiliser, mais vous pouvez toujours les modifier.

Unsloth démarre le modèle, lance OpenClaw et arrête le serveur temporaire lorsque vous quittez.\
\
Pour conserver l’état de votre OpenClaw et revenir plus tard à la même session, ajoutez `--persist` et choisissez une clé de session :

```bash
unsloth start openclaw \
  --model unsloth/Qwen3.6-27B-GGUF \
  --persist \
  agent --local \
  --session-key my-session \
  --message "Inspect this repository"
```

Continuez plus tard en utilisant la même clé de session :

```bash
unsloth start openclaw \
  --model unsloth/Qwen3.6-27B-GGUF \
  --persist \
  agent --local \
  --session-key my-session \
  --message "Continue"
```

Consultez la [unsloth start](/docs/fr/integrations/unsloth-start.md) référence complète pour les sessions nommées, le chargement de modèles, les serveurs Unsloth distants et les options avancées.

Le reste de ce guide couvre la configuration manuelle du fournisseur OpenClaw.

### Configuration manuelle du fournisseur OpenClaw

### 🔑 Création d’une clé API

Les clés sont créées à partir de **Unsloth → Paramètres → Clés API**.

1. Ouvrez la barre latérale, cliquez sur votre **avatar Unsloth** en bas à gauche.
2. Allez à **Paramètres** → **Clés API**.
3. Saisissez un nom convivial (par ex. `claude-code-macbook`).
4. *(Facultatif)* Définissez une date d’expiration.
5. Cliquez sur **Créer**.
6. **Copiez immédiatement la clé.** Unsloth ne stocke qu’un hachage et vous ne pourrez plus la consulter.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FrWnqY5PgvZdbWK8pmlD5%2Fimage.png?alt=media&amp;token=3507e7d7-b552-447f-b503-2418802b8f6e" alt="" width="375"><figcaption></figcaption></figure></div>

Toutes les clés commencent par le préfixe `sk-unsloth-` . Révoquez une clé depuis cette même page à tout moment. Les requêtes effectuées avec une clé révoquée échoueront avec `401 Unauthorized`.

### Connexion à OpenClaw

OpenClaw lit sa configuration à partir de `~/.openclaw/openclaw.json`. Ajoutez (ou fusionnez) un bloc `models` avec un bloc `unsloth` provider pointant vers l’API Anthropic Messages d’Unsloth.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fs5g7Epfb2KjiQQf4MJf7%2Fopenclaw_unsloth_chat.png?alt=media&amp;token=c4de5f80-2a99-4527-bde0-c4e05e086f79" alt="" width="375"><figcaption></figcaption></figure></div>

{% 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 %}

**Notes :**

* `baseUrl` est l’origine Unsloth sans chemin. OpenClaw communique avec Unsloth via l’API Anthropic Messages, et le SDK Anthropic ajoute `/v1/messages` lui-même, donc n’ajoutez pas `/v1` ici (un suffixe `/v1` enverrait les requêtes vers `/v1/v1/messages`).
* `api: "anthropic-messages"` indique à OpenClaw de communiquer avec le `/v1/messages` point de terminaison d’Unsloth.
* `authHeader: true` envoie votre clé comme `Authorization: Bearer …`.
* Définissez pour chaque modèle son `id` et son `name` sur le nom que vous avez choisi lors du chargement du modèle dans Unsloth.
* Si vous exécutez Unsloth sur une machine distante, remplacez `localhost:8888` par l’adresse de cette machine (par ex. `http://10.0.0.42:8888`).

### Facultatif : configurer le comportement du modèle

OpenClaw se connecte via le modèle exécuté dans Unsloth. Les paramètres d’exécution peuvent être configurés au démarrage du serveur.

```bash
# Configure default generation behavior (--disable-tools passes OpenClaw's own tools through)
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  --disable-tools \
  --reasoning off \
  --temp 0.6
```

{% hint style="warning" %}
Utilisez `--disable-tools` lorsque vous pilotez OpenClaw (ou tout autre agent de codage externe). Par défaut, Unsloth Studio exécute ses propres outils côté serveur, ce qui intercepte les appels d’outils de l’agent ; OpenClaw répond alors mais ne modifie jamais les fichiers. `--disable-tools` passe en mode relais, de sorte que les outils d’OpenClaw sont utilisés.
{% endhint %}

Utilisez `--reasoning off` pour désactiver le raisonnement, ou `--reasoning on` pour l’activer pour les modèles qui prennent en charge le raisonnement.

```bash
# Autoriser les connexions depuis d’autres appareils
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  -H 0.0.0.0 \
  -p 8888
```

Cela démarre le serveur sur `0.0.0.0:8888`, permettant aux autres appareils de votre réseau local de se connecter.

Pour une configuration d’exécution plus avancée, consultez la section principale [Ajustement de l’API](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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/fr/integrations/openclaw.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.