Changer le thème

OpenClaw 2026.3 avancé : nouvelles fonctionnalités et bonnes pratiques

Easton editorial illustration: recovery checkpoint console

OpenClaw 2026.3 (v2026.3.7-beta.1) corrige plus de 200 bugs ; le CHANGELOG officiel fait près de quinze mille mots. Avant, le routage multi-modèles échouait souvent sur la configuration des permissions sandbox ; avec la nouvelle version, tout passe du premier coup. Les mises à jour clés : le moteur ContextEngine (occupation du contexte réduite d’environ 30 %), le système de plugins refactorisé en architecture à trois couches Bundle + Provider + Plugin, et trois nouveaux backends sandbox OpenShell et SSH.

Cet article est le 34ᵉ de la série OpenClaw et regroupe les points pratiques de la version 2026.3 : utilisation du ContextEngine, configuration de l’architecture plugins en trois couches, choix du backend sandbox. Si vous migrez depuis une ancienne version, vous y trouverez rapidement les points de migration essentiels.

1. Vue d’ensemble — ce qu’apporte 2026.3

Commençons par les chiffres. La seule version v2026.3.7-beta.1 corrige plus de 200 bugs, sans compter les patchs suivants. Le CHANGELOG officiel approche les quinze mille mots ; après lecture, voici les grandes directions :

200+
Corrections de bugs
Version unique v2026.3.7-beta.1

Mise à niveau du moteur ContextEngine. Avant, la gestion du contexte d’OpenClaw était assez « brute » : tout ce qu’on lui donnait, il le consommait, et tenir le coup dépendait du modèle. La nouvelle version ajoute un mécanisme de « découpe intelligente » : identification automatique des informations réellement utiles à la tâche en cours, mise de côté du reste. En test, sur une tâche complexe de 50 tours de dialogue, l’occupation du contexte baisse d’environ 30 %.

Refonte du système de plugins. C’est le changement le plus important : passage de l’ancienne structure Skills à une couche unique vers Bundle + Provider + Plugin en trois niveaux. En clair, des plugins plus « modulaires ». Avant, migrer une compétence de Codex vers Claude impliquait de retoucher beaucoup de configuration ; maintenant, il suffit de changer de Provider, la logique centrale reste intacte. Le chapitre 3 détaille la configuration.

Diversification des backends sandbox. Auparavant, tout tournait autour de Docker ; désormais OpenShell (modes mirror et remote) et SSH sandbox s’ajoutent. Sur Mac ou sans Docker, le mode mirror OpenShell est une bonne option — shell local direct, démarrage bien plus rapide.

Renforcement du workflow human-in-the-loop. La nouvelle version abandonne l’idée du « tout automatique » : l’IA s’arrête en cours de route pour demander « est-ce correct ? », puis reprend après validation. Au début ça semble superflu ; après quelques essais, on évite pas mal d’erreurs.

Point souvent négligé : la détection automatique SELinux. Sur CentOS ou RHEL, la configuration sandbox posait parfois des problèmes de permissions ; OpenClaw détecte et propose des recommandations.

2. Nouvelles fonctionnalités en détail

2.1 Questions latérales /btw

Je ne l’ai pas prise au sérieux au départ — une simple « bifurcation de conversation ». En pratique, c’est très utile.

Scénario : OpenClaw refactorise un composant React complexe, la tâche tourne depuis une dizaine de tours, le contexte s’accumule. Vous voulez poser une question sans lien, par exemple « comment écrire cette regex ». Avant, nouvelle session ou question injectée dans le fil actuel (et le contexte explose).

Tapez /btw votre question : OpenClaw répond dans un « canal latéral », sans toucher au contexte de la tâche principale. Une fois la réponse donnée, il reprend automatiquement le travail principal.

# Exemple de question latérale
/btw Aide-moi à écrire une regex pour valider une adresse e-mail

# Exemple de sortie
# [Question latérale] Regex e-mail : ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
# [Tâche principale] Refactorisation du composant en cours...

Cette fonction règle un problème récurrent : intervenir au milieu d’une longue tâche sans casser le contexte.

2.2 Backends sandbox interchangeables

Les changements sandbox sont techniques. Avant, Docker seul ; maintenant trois options :

Mode mirror OpenShell : shell local, exécution des commandes « miroirée » et enregistrée. Avantages : démarrage rapide, faible consommation ; inconvénient : isolation moindre qu’avec Docker. Idéal pour dev et tests locaux.

Mode remote OpenShell : connexion au shell d’un serveur distant. Avec une machine dédiée aux tâches, OpenClaw exécute là-bas et pilote depuis la machine locale. Adapté à l’équipe ou à un environnement unifié.

Backend SSH sandbox : proche du mode remote, mais plus « natif », sans protocole propriétaire OpenClaw. Pour une infra SSH existante.

Exemple de configuration (OpenShell mirror). Note : la configuration principale d’OpenClaw est ~/.openclaw/openclaw.json (JSON) ; le YAML ci-dessous illustre la hiérarchie — noms de clés et structure réels : voir Configuration Gateway et la version courante.

# Schéma indicatif, ne pas coller tel quel comme config officielle
sandbox:
  type: openshell
  mode: mirror
  options:
    shell: /bin/bash  # ou /bin/zsh
    timeout: 300      # timeout par commande (secondes)

Sans Docker, le mode mirror est léger. Sur MacBook Air, la RAM consommée était environ deux fois moindre qu’avec Docker.

2.3 Intégration Firecrawl

Le scraping web était un point faible — ancienne approche « brutale » : curl puis parsing HTML ; anti-bot ou rendu dynamique, et c’était bloqué.

Avec Firecrawl, la situation s’améliore nettement. Service dédié au scraping : rendu JavaScript, pagination automatique, sortie Markdown structurée. OpenClaw l’expose comme outil intégré.

# Activer Firecrawl
tools:
  web_scraping:
    engine: firecrawl
    api_key: ${FIRECRAWL_API_KEY}  # variable d'environnement recommandée

En test, sur une SPA complexe (ex. site de doc React), plusieurs tours de prompt étaient nécessaires avant ; désormais, en général une seule passe suffit.

2.4 Workflow Secrets

Gestion sécurisée des clés API. Avant : clés en dur dans la config, ou variables d’environnement commitées par erreur sur Git.

La version 2026.3 supporte un cycle complet CRUD pour les secrets :

# Ajouter une clé
/secrets set OPENAI_API_KEY "sk-xxx"

# Lister toutes les clés (noms uniquement, pas les valeurs)
/secrets list

# Supprimer une clé
/secrets delete OPENAI_API_KEY

Les clés sont chiffrées dans ~/.openclaw/secrets/ ; Git ignore ce répertoire. Pour une config partagée en équipe, export possible au format variables d’environnement, puis injection en CI/CD.

3. Refonte du système de plugins en pratique

C’est la partie la plus impactante de 2026.3 — et ce qui déroute le plus les utilisateurs longue date. J’ai passé un week-end entier à comprendre cette architecture.

3.1 De Skills à l’architecture en trois couches

Avant, les plugins s’appelaient Skills : modules fonctionnels indépendants. Installer un Skill, le configurer, c’est tout. Simple, mais avec des limites :

  • Conflits de dépendances entre Skills
  • Migration vers un autre modèle IA : vérifier la compatibilité Skill par Skill
  • Personnaliser un Skill existant ≈ réécrire

La nouvelle architecture en trois couches :

Bundle (pack de capacités) : couche supérieure, « ensemble de fonctions », ex. codex-bundle, claude-bundle. Un Bundle regroupe des Plugin liés et la config Provider par défaut — un kit prêt à l’emploi.

Provider (fournisseur de modèle) : couche intermédiaire, connexion au modèle IA concret. Ex. openrouter-provider pour des dizaines de modèles via OpenRouter, copilot-provider pour GitHub Copilot.

Plugin : couche basse, logique fonctionnelle concrète. Ex. web-search-plugin pour la recherche web, code-review-plugin pour la revue de code.

Exemple : migrer la revue de code d’OpenAI vers Claude — modifier la config Provider, le Plugin reste inchangé.

3.2 Exemple de configuration Bundle

Pour claude-bundle, la configuration ressemble à ceci :

# bundles/claude-bundle.yaml
name: claude-bundle
version: 1.2.0
description: "Kit de capacités Claude AI"

provider:
  name: anthropic
  model: claude-3-5-sonnet-20241022
  api_key: ${ANTHROPIC_API_KEY}

plugins:
  - name: code-generation
    enabled: true
  - name: code-review
    enabled: true
  - name: web-search
    enabled: false  # Claude a déjà le web, pas besoin de ce plugin

settings:
  max_tokens: 4096
  temperature: 0.7

Activer un Bundle dans la config principale :

# Schéma (config réelle : openclaw.json + doc officielle)
bundles:
  - claude-bundle
  - dev-tools-bundle  # plusieurs Bundles possibles

3.3 Provider pluginisé

Sans le Provider par défaut du Bundle, configuration séparée. Ex. OpenRouter pour Claude (parfois moins cher) :

# providers/openrouter.yaml
name: openrouter
type: http
base_url: https://openrouter.ai/api/v1
api_key: ${OPENROUTER_API_KEY}

models:
  - id: anthropic/claude-3.5-sonnet
    alias: claude-sonnet
  - id: openai/gpt-4o
    alias: gpt4

Puis référence dans le Bundle :

# bundles/custom-claude.yaml
provider:
  ref: openrouter
  model: claude-sonnet  # alias défini ci-dessus

Utile pour l’optimisation des coûts : modèle économique pour les tâches simples, modèle haut de gamme pour le complexe. Détail dans l’épisode 26 de la série, « OpenClaw : optimisation des coûts et routage de modèles ».

3.4 ClawHub, marketplace de skills

Marketplace officielle ClawHub, un peu comme le store d’extensions VS Code. Recherche et installation depuis OpenClaw :

# Rechercher un skill
/hub search code-review

# Installer
/hub install voltagent/code-review-enhanced

# Voir les installés
/hub list

Skills communautaires vérifiés, versioning propre. Pour publier le vôtre : hub publish.

4. Mise à niveau et migration

4.1 Mise à niveau en douceur

La mise à niveau est simple : /update ou détection automatique :

# Option 1 : mise à jour manuelle
/update

# Option 2 : demander à l'IA
"Vérifie s'il y a une nouvelle version"

Attention : avant la mise à niveau :

  1. Sauvegarder la config : copier tout le répertoire ~/.openclaw/
  2. Noter les Skills installés : le nouveau système de plugins n’est pas compatible ; réinstallation nécessaire
  3. Vérifier les clés API : si vous utilisez des variables d’environnement, confirmer qu’elles sont bien définies

Après la mise à niveau, OpenClaw tente une migration automatique, sans garantie à 100 %. Les configs Bundle et Provider demanderont souvent un ajustement manuel.

4.2 Checklist de compatibilité

Après la mise à niveau, parcourir cette liste :

VérificationCommandeRésultat attendu
Version--versionv2026.3.x
Liste plugins/plugins listPlugins installés affichés
État Provider/providers statusProviders configurés affichés
État sandbox/sandbox statusType et état sandbox affichés
Stockage secrets/secrets listNoms des clés stockées

En cas d’erreur, vérifier le fichier de config correspondant. Pièges fréquents :

  • Skills disparus : normal, réinstaller le Bundle équivalent
  • Échec connexion Provider : vérifier la migration des clés API
  • Erreur permissions sandbox : relancer l’initialisation sandbox

4.3 Problèmes courants

Problème 1 : ancienne config Skills non reconnue

Le format Skills n’est plus supporté. Solution :

# Lister les anciens Skills (noms uniquement)
/legacy-skills list

# Convertir vers le format Plugin
/migrate-skills

La config convertie est dans ~/.openclaw/plugins/migrated/ ; ajustements manuels possibles.

Problème 2 : échec démarrage sandbox Docker

Souvent SELinux. Exécuter :

# Détecter et corriger SELinux
/sandbox fix-selinux

# Ou passer en mode mirror OpenShell
/config set sandbox.type openshell
/config set sandbox.mode mirror

Problème 3 : config routage multi-modèles perdue

Rencontré aussi à la mise à niveau : la nouvelle architecture Provider change l’écriture du routage. Solution : reprendre les exemples du chapitre 3 et réécrire les fichiers Provider.

5. Scénarios pratiques et bonnes pratiques

5.1 Scénario 1 : optimisation des coûts par routage multi-modèles

Question clé pour développeurs solo et petites équipes. Le routage multi-modèles de la nouvelle version concrétise « tâches simples → modèle pas cher, tâches complexes → modèle premium ».

Schéma de base :

# router.yaml
rules:
  - name: simple-tasks
    condition: "tokens < 1000 and complexity < 0.3"
    provider: openrouter
    model: openai/gpt-3.5-turbo

  - name: complex-tasks
    condition: "tokens >= 1000 or complexity >= 0.3"
    provider: openrouter
    model: anthropic/claude-3.5-sonnet

  - name: code-review
    condition: "task_type == 'code_review'"
    provider: anthropic
    model: claude-3-5-sonnet-20241022
40%-60%
Réduction des coûts
Données mesurées sur charge de travail identique

Sur la même charge, les coûts baissent de 40 à 60 % selon la répartition des tâches.

5.2 Scénario 2 : automatisation navigateur renforcée

Nouvelle prise en charge de « Live Chrome session attachment » : OpenClaw peut prendre le contrôle d’une fenêtre Chrome déjà ouverte.

Utile quand :

  • Vous êtes déjà connecté à un site avec captcha
  • Navigation entre plusieurs pages
  • Conservation des cookies et de la session

Configuration :

# Schéma (clés automation navigateur : doc officielle)
browser:
  mode: attach
  chrome_path: /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome
  user_data_dir: ~/.chrome-debug-profile
  debug_port: 9222

Lancer Chrome avec le port de debug :

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=~/.chrome-debug-profile

# Puis dans OpenClaw :
"Prends le contrôle de ma fenêtre navigateur actuelle"

5.3 Scénario 3 : déploiement sécurisé en entreprise

En environnement corporate, la sécurité est incontournable. Plusieurs fonctionnalités aident à la conformité :

1. Stockage chiffré des Secrets

Toutes les clés sont chiffrées AES-256 ; la clé de chiffrement reste en mémoire, pas sur disque.

2. Journal d’audit

En mode audit, toutes les requêtes et réponses IA sont enregistrées :

audit:
  enabled: true
  log_path: /var/log/openclaw/audit.log
  redact_secrets: true  # masquage automatique des secrets

3. Contrôle du trafic sortant

Limiter OpenClaw à des domaines spécifiques :

network:
  allowlist:
    - api.anthropic.com
    - api.openai.com
    - openrouter.ai
  deny_all_others: true

4. Détection automatique SELinux

Sur CentOS/RHEL, détection de l’état SELinux et recommandations :

# Suggestion générée par OpenClaw
# Exécutez les commandes suivantes pour la politique Docker SELinux :
# semanage port -a -t docker_port_t -p tcp 2375-2376

Synthèse

Après une mise à niveau vers 2026.3, testez ces cinq fonctions en priorité :

  1. /btw questions latérales : intercaler une question en longue tâche sans casser le contexte
  2. Mode mirror OpenShell : si Docker vous a pesé en ressources, à essayer absolument
  3. Scraping Firecrawl : tester sur une SPA complexe, le gain est visible
  4. Marketplace ClawHub : parcourir les contributions communautaires
  5. Workflow Secrets : migrer les clés en dur de la config, bien plus sûr

OpenClaw évolue vite — parfois une nouvelle version toutes les deux semaines. En cas de blocage, cherchez sur GitHub Issues : quelqu’un a probablement déjà eu le même problème.

Cette série couvre déjà config détaillée, optimisation des coûts, analyse d’architecture. Première découverte d’OpenClaw ? Commencez par « Guide d’architecture OpenClaw : de l’initiation à la maîtrise » pour une vision d’ensemble.

Guide rapide OpenClaw 2026.3

Mettre à niveau depuis une ancienne version vers 2026.3 et configurer les fonctions clés

⏱️ Estimated time: 30 min

  1. 1

    Step 1: Sauvegarder et mettre à niveau

    Avant la mise à niveau, sauvegardez la configuration :

    ```bash
    # Sauvegarder le répertoire de config
    cp -r ~/.openclaw ~/.openclaw-backup

    # Déclencher la mise à niveau
    /update
    ```

    Après la mise à niveau, exécutez `--version` pour confirmer le numéro de version.
  2. 2

    Step 2: Migrer Skills vers Plugin

    La nouvelle version ne supporte plus l'ancien format Skills :

    ```bash
    # Lister les anciens Skills
    /legacy-skills list

    # Migration automatique
    /migrate-skills
    ```

    Vérifiez ensuite le répertoire `~/.openclaw/plugins/migrated/`.
  3. 3

    Step 3: Configurer le backend sandbox

    Mode mirror OpenShell recommandé (léger) :

    ```yaml
    sandbox:
    type: openshell
    mode: mirror
    options:
    shell: /bin/bash
    timeout: 300
    ```

    Ou continuer avec Docker.
  4. 4

    Step 4: Configurer Bundle et Provider

    Créer ou modifier la config Bundle :

    ```yaml
    # bundles/claude-bundle.yaml
    provider:
    name: anthropic
    model: claude-3-5-sonnet-20241022
    api_key: ${ANTHROPIC_API_KEY}
    plugins:
    - name: code-generation
    enabled: true
    ```

    Activer dans la config principale : `bundles: [claude-bundle]`
  5. 5

    Step 5: Migrer les clés vers Secrets

    Migrer les clés en dur vers la gestion sécurisée :

    ```bash
    # Ajouter une clé
    /secrets set ANTHROPIC_API_KEY "your-key-here"

    # Vérifier
    /secrets list
    ```

    Les clés sont chiffrées ; Git les ignore automatiquement.

FAQ

Après la mise à niveau vers 2026.3, l'ancienne config Skills fonctionne-t-elle encore ?
Non directement. La nouvelle version utilise l'architecture Bundle + Provider + Plugin et n'est plus compatible avec l'ancien format Skills. Utilisez la commande `/migrate-skills` pour migrer automatiquement, puis vérifiez le répertoire `~/.openclaw/plugins/migrated/`.
Quelle différence entre le mode mirror OpenShell et la sandbox Docker ?
Le mode mirror OpenShell utilise directement le shell local : démarrage plus rapide, consommation plus faible, adapté au dev local. Docker offre une meilleure isolation, idéal en production ou quand l'isolation stricte est requise.

Mesure sur MacBook Air : la RAM du mode mirror OpenShell est environ la moitié de celle de Docker.
La fonction /btw affecte-t-elle le contexte de la tâche principale ?
Non. /btw ouvre un canal latéral indépendant ; après la réponse, OpenClaw reprend automatiquement la tâche principale. Cela règle le problème de poser une question au milieu d'une longue tâche sans polluer le contexte.
Comment configurer le routage multi-modèles pour réduire les coûts ?
Définir des règles dans router.yaml :

- Tâches simples (tokens <1000) → GPT-3.5 économique
- Tâches complexes (tokens >=1000) → Claude 3.5 Sonnet
- Tâches spécifiques (ex. code_review) → modèle dédié

Réduction mesurée de 40 à 60 %. Voir l'épisode 26 de la série « Optimisation des coûts OpenClaw ».
L'intégration Firecrawl est-elle payante en supplément ?
Firecrawl est un service indépendant avec sa propre tarification. OpenClaw encapsule uniquement son API. Quota gratuit mensuel possible, ou facturation à l'usage. Configurer la variable d'environnement `FIRECRAWL_API_KEY`.
Quelles recommandations de sécurité pour un déploiement en entreprise ?
Activer les fonctionnalités suivantes :

- Stockage chiffré des Secrets (AES-256)
- Journal d'audit (toutes requêtes et réponses IA)
- Liste blanche trafic sortant (domaines autorisés)
- Détection automatique SELinux (CentOS/RHEL)

La config principale se trouve dans **~/.openclaw/openclaw.json** (JSON) et la doc Gateway / sécurité officielle ; ne pas supposer un fichier config.yaml unique.

10 min de lecture · Publié le: 18 mars 2026 · Mis à jour le: 27 juil. 2026

Commentaires

Connectez-vous avec GitHub pour laisser un commentaire

Easton BlogEaston Blog