Guide OpenClaw 2026 v2026.3.12 :
Nouvelle interface utilisateur de contrôle, plug-ins de fournisseur et Kubernetes : installation pour le triage
Les équipes d'expédition qui suivent OpenClaw ont rencontré trois fils de discussion qui se chevauchentv2026.3.12: unInterface utilisateur de contrôle de passerelle actualiséeavec des vues modulaires et une palette de commandes,mode rapide au niveau de la sessionpour OpenAI et Anthropic plus une architecture de plug-in de fournisseur pour Ollama, vLLM et SGLang, et un officielChemin de démarrage Kubernetesavec des manifestes bruts et une documentation Kind. Toute couche mal configurée rend le tri aléatoire. Ce guide est destiné aux opérateurs qui doivent poser la construction surpasserelles pour ordinateurs portables, production Docker ou clusters: trois modèles de douleur, un tableau fonctionnalité-impact, une matrice de forme de déploiement, cinq étapes répétables, trois métriques, la suppression des mythes et des liens pour l'installation, le Docker de production, la mise à niveau et la restauration, la répétition du loyer journalier, les notes de lancement et l'encyclopédie des erreurs - afin que vous puissiez valider sur macOS natif jetable en cas de besoin.
Table des matières
- 01. Trois modèles de douleur : interface utilisateur + prestataires + cluster
- 02. Carte des fonctionnalités v2026.3.12
- 03. Matrice de décision : ordinateur portable, Docker, Kubernetes
- 04. Cinq étapes : mise à niveau via validation
- 05. Métriques, notes de sécurité, mythes
- 06. Pourquoi une répétition sur Mac loué gagne toujours
01. Trois modèles de douleur : interface utilisateur + prestataires + cluster
1) Dérive de navigation après le tableau de bord-v2 :Le tableau de bord de la passerelle ajoute une présentation modulaire, des surfaces de discussion, de configuration, d'agent et de session, une palette de commandes, des onglets inférieurs mobiles et des fonctionnalités de discussion plus riches telles que les commandes slash, la recherche, l'exportation et les messages épinglés. Les captures d'écran des publications plus anciennes ne sont plus mappées un à un ; les équipes sans « chemin heureux » canonique se fragmentent en mémoire musculaire conflictuelle.
2) Limites du plugin fournisseur pour Ollama, vLLM et SGLang :Le déplacement de ces piles vers des hooks d'intégration, de découverte, de sélection de modèle et de post-sélection appartenant au fournisseur modularise le câblage de base, ce qui est idéal pour l'extensibilité, mais risqué si vous assumez toujours des chemins de base hérités. La validation de la mise à niveau doit inclure la redécouverte des modèles et un test de fumée minimal par appel d'outil par fournisseur.
3) Documents Kubernetes sans l'histoire des secrets de votre organisation :Les manifestes de démarrage et la configuration de Kind vous aident à démarrer rapidement, mais ils ne choisissent pas votre stratégie de rotation StorageClass, Ingress ou secrète. Les modifications apportées au couplage et à la confiance des plugins dans cette version signifient que la copie des habitudes d'un ordinateur portable dans un espace de noms peut briser les paramètres de sécurité par défaut attendus.
Préoccupation transversale :économie en mode rapide. Le mode rapide OpenAI GPT-5.4 et le mode rapide Anthropic introduisent des bascules configurables au niveau de la session dans/fast, TUI, Control UI et ACP avec les valeurs par défaut par modèle. Sans politique écrite, « jeûner partout » devient une surprise budgétaire ; « fast offwhere » cache des régressions de latence qui n'apparaissent que sous charge.
Un autre angle pratique estorchestration de sous-agents: le communiqué ajoutesessions_yieldafin que les orchestrateurs puissent mettre fin immédiatement au tour en cours, ignorer le travail des outils en file d'attente et transporter une charge utile de suivi cachée dans le tour de session suivant. Si votre automatisation suppose des tours monolithiques, vous devrez peut-être revoir les diagrammes de séquençage, en particulier lorsque les réponses de Slack Block Kit ou lorsque le thread Mattermost interagit avec les correctifs de livraison en streaming également mentionnés dans le journal des modifications.
Enfin, traitezMise à jour native de Windowsnote sérieusement si vous prenez en charge des flottes de systèmes d'exploitation mixtes : les installations de packages sont orientées vers le chemin de mise à jour npm avec Git portable fourni pour les mises à jour natives de Windows, réduisant ainsi les échecs précoces lorsquegitou les prérequis du téléchargeur manquaient. Les tests de parité sur les passerelles macOS et Windows empêchent les escalades « fonctionne sur mon Mac » après des modifications de l'interface utilisateur.
02. Carte des fonctionnalités v2026.3.12
Le tableau distille les notes de version en contrôles d'acceptation ; vérifiez toujours par rapport au journal des modifications officiel votre version exacte.
| Zone | Ce qui a été expédié | Comment valider |
|---|---|---|
| Contrôler l'interface utilisateur | Tableau de bord de la passerelle modulaire ; palette de commandes ; des outils de chat plus riches | Capturez un playbook de capture d'écran partagé pour l'intégration |
| Mode rapide | Basculements rapides OpenAI et Anthropic avec alignement UI/TUI | Exécutez des échantillons de latence A/B et de coûts sur des invites représentatives |
| Fournisseurs | Ollama, vLLM, SGLang sur l'architecture fournisseur-plugin | Réexécutez la découverte et la sélection du modèle après la mise à niveau |
| Kubernetes | Chemin d'installation de démarrage avec les manifestes bruts et les documents Kind | Répétez sur Kind avant les espaces de noms de production |
| Sécurité | Jetons d'amorçage de courte durée pour l'appairage ; confiance plus stricte dans les plugins d'espace de travail | Documentez la durée de vie du jeton et faites confiance aux décisions dans votre wiki |
Si les principes fondamentaux de l'installation sont fragiles, commencez parguide d'installation multiplateforme. Pour les conteneurs de production, associez-les àDocker de production et guide de sécurité. Pour les mises à niveau, utilisezliste de contrôle de mise à niveau, de migration et de restauration.
Lorsque vous câblez une livraison Slack ou Mattermost, notez que les chemins de réponse partagés ont obtenu des correctifs de médias et de threads plus riches : testez à nouveau toutes les commandes slash personnalisées ou les flux de boutons après la mise à niveau, car les livraisons en double ou les ancres de thread manquantes proviennent souvent de clés de déduplication en continu plutôt que de la qualité du modèle. Les sélecteurs de modèles en ligne Telegram ont également reçu des correctifs de persistance ; si vos opérateurs retournent des modèles en cours d'incident, confirmez que les remplacements survivent aux redémarrages afin que l'astreinte ne combatte pas les défauts obsolètes à trois heures du matin.
Du point de vue de l'observabilité, combinez les journaux de passerelle avec les histogrammes de latence du fournisseur : le mode rapide modifie la queue plus que la médiane, et les tâches sensibles à la queue (charges utiles d'outils volumineuses, sous-agents multi-sauts) sont les lieux où les surprises apparaissent. Capturez p95 et p99 pour au moins une invite « typique » et une « pire journée » définie chaque fois que vous activez les paramètres par défaut rapides à l'échelle de l'organisation.
03. Matrice de décision : ordinateur portable, Docker, Kubernetes
| Forme | Idéal pour | Coût principal |
|---|---|---|
| Passerelle pour ordinateur portable macOS | Développeurs solo nécessitant des autorisations complètes sur le bureau | Veille, mises à jour du système d'exploitation, invites du trousseau |
| Docker / Composer | Petites équipes souhaitant des versions reproductibles | Épinglage d’images, volume et hygiène secrète |
| Kubernetes | Équipes ayant besoin de répliques et de capacité élastique | Mise en réseau, RBAC, boucles d'incidents plus longues |
Répétition native à faible coût sans acheter de matériel : lireessai de loyer journalier versus coût localet choisissez une courte fenêtre qui correspond à l'exécution de votre script de validation.
La planification de la capacité pour Kubernetes doit inclureMarge CPU et RAM pour les modèles side-carslorsque vous colocalisez des passerelles avec inférence locale : vLLM et SGLang peuvent augmenter la mémoire du GPU ou du CPU d'une manière qui s'enregistre à peine sur les passerelles d'ordinateurs portables mais submerge les petits pools de nœuds. Étiquetez explicitement les nœuds si vous divisez les charges de travail « chat uniquement » et « lourdes en outils » afin que les autoscalers de cluster n'oscillent pas pendant les semaines d'évaluation en rafale.
04. Cinq étapes : mise à niveau via validation
- Mise à niveau et référence :Passez à la version v2026.3.12 via votre canal pris en charge, puis exécutez
openclaw doctoretopenclaw health; enregistrez la version de la passerelle, le système d'exploitation et les versions du nœud dans un ticket de modification. - Apprenez l'interface utilisateur de contrôle :Parcourez les vues modulaires, ouvrez la palette de commandes et documentez le chemin le plus court vers les écrans de session et de configuration pour votre équipe.
- Définir la stratégie de mode rapide :Expérimentez avec les bascules rapides OpenAI et Anthropic lors des sessions de test ; capturez les deltas de latence et de facturation avant d’activer les valeurs par défaut à l’échelle de l’organisation.
- Réintégrer les prestataires :Sous l'architecture du plugin, complétez les flux d'intégration Ollama, vLLM ou SGLang ; Appels d'outils de test de fumée et streaming pour chacun.
- Répétition Kubernetes :Appliquer les manifestes de démarrage sur Kind ou un espace de noms intermédiaire ; vérifiez les pods, les services et l'entrée s'ils sont utilisés avant de promouvoir des modèles.
openclaw --version
openclaw doctor
openclaw health
Les erreurs de commande appartiennent àFAQ sur les erreurs de commande; démons et connexionsguide de lancement et de récupération.
05. Métriques, notes de sécurité, mythes
- Métrique 1 :Les artefacts de version incluent les programmes d'installation de bureau et les archives dans l'ordre dedizaines de mégaoctets chacun— le temps de téléchargement du budget et le temps de somme de contrôle dans les bureaux CI ou à bande passante mesurée, pas seulement le temps CPU.
- Métrique 2 :Après le mode rapide et le routage multi-fournisseurs, une passe de régression sérieuse devrait couvrirau moins trois chemins de modèle(par exemple une API hébergée, un Ollama local et un vLLM de sauvegarde) — sinon vous pourriez voir une « interface utilisateur verte » pendant qu'un fournisseur dégrade silencieusement les appels d'outils.
- Métrique 3 :La sécurité se renforceappairage de jetons d'amorçageetchargement automatique du plugin d'espace de travailsignifie que les comportements qui « fonctionnaient par accident » auparavant nécessitent désormais une confiance explicite : traitez les invites comme une politique attendue, et non comme des bogues.
Mythe A :« K8s YAML équivaut à la préparation à la production » sans secrets ni classes de stockage.Mythe B :« Modification de l'interface utilisateur uniquement » ignore les modifications de routage et d'entrée de session.Mythe C :« Le test de fumée sur une seule machine couvre les bascules rapides de la passerelle » : validez l'interface utilisateur de contrôle et la TUI indépendamment.
Réalité de sécurité étendue : jetons d'amorçage de courte durée pour/pairet les flux QR réduisent les fuites d'informations d'identification partagées ; Le chargement automatique implicite du plugin d'espace de travail est désactivé, de sorte que les dépôts clonés ne peuvent pas exécuter les plugins d'espace de travail sans confiance explicite : tenez-en compte dans vos documents d'intégration de développeur, pas seulement dans les runbooks infra.
Conseil opérationnel : lorsque vous répétez sur Kind, gardez la durée de vie du cluster courte et les noms d'espace de noms évidents : rien n'érode la confiance plus rapidement qu'une passerelle parasite pointant vers des secrets de préparation pendant que les démonstrations de leadership à partir des diapositives de production.
L'hygiène de la documentation est importante : alignez les captures d'écran d'intégration avec les nouveaux onglets de l'interface utilisateur de contrôle, épinglez les versions CLI exactes dans les runbooks et stockez les versions rédigées.openclaw doctorsorties à côté pour changer les tickets. Le futur, vous remercierez le présent, lorsqu'une régression surviendra pendant un gel des vacances et que le seul artefact sera "ça a fonctionné mardi".
Pour les équipes mélangeant des API hébergées avec des modèles auto-hébergés, planifiezexercices de basculement: simulez les délais d'attente du fournisseur et confirmez que les niveaux de mode rapide Anthropic ou OpenAI se comportent toujours lorsque vous inversezparams.fastMode- la version met l'accent sur les chemins de vérification pour les deux fournisseurs, et l'asymétrie entre eux est plus facile à détecter dans les tests scriptés que dans le chat manuel.
Confirmez les SKU surTarifs MacDateet les ports surguide d'accès à distance.
06. Pourquoi une répétition sur Mac loué gagne toujours
La mise à niveau directement sur votre pilote quotidien est rapide jusqu'à ce qu'elle ne le soit pas : la pollution de dépendance mondiale, les tâches d'arrière-plan concurrentes et l'anxiété de restauration rendent la v2026.3.12 plus difficile à évaluer équitablement. UNmacOS natif jetableLe nœud - loué à la journée lorsque vous n'avez besoin que d'une fenêtre de répétition - permet de contenir les pannes, de correspondre aux modèles d'autorisation et de passerelle Apple et d'éviter de transformer votre ordinateur portable en rat de laboratoire.
Cela n’élimine pas la rigueur : vous continuez à effectuer des vérifications de script, à capturer des journaux et à comparer les métriques avant/après. L'avantage estalignement— lorsque l'interface utilisateur de contrôle et les fournisseurs fonctionnent, ils se comportent comme une véritable passerelle d'équipe ; en cas d'échec, triez les cartes vers les documents publics et les connaissances de la communauté sans risquer votre machine principale. Pour le dimensionnement du budget, ouvrezprix, associez-le àguide d'installationetGuide Docker de production, et promouvoir en production uniquement après avoir coché les cases de cluster et de sécurité.
Bouclez la boucle avec les parties prenantes : résumez quelles surfaces ont été déplacées (Control UI), quelles intégrations doivent être retestées (Slack Block Kit, Mattermost threading, boutons du modèle Telegram) et quels paramètres de sécurité par défaut nécessitent désormais une confiance explicite. Un delta d'une page bat une feuille de route de soixante diapositives lorsque les finances demandent pourquoi la mise à niveau de la passerelle de mars nécessitait un budget de répétition.
Enfin, archivez les sommes de contrôle des ressources de version téléchargées avec vos identifiants de build internes afin que les auditeurs puissent associer un binaire de passerelle en cours d'exécution à une balise Git spécifique sans s'appuyer uniquement sur des captures d'écran : répétez l'étape de somme de contrôle chaque fois que vous mettez en miroir les installateurs dans des magasins d'artefacts internes ou que vous reconstruisez des images dans CI. Cette petite habitude empêche la dérive silencieuse entre les passerelles de préparation et de production et maintient les différences d'astreinte honnêtes.