hello-claw : un tutoriel OpenClaw, pas un logiciel

Un dépôt de cours, pas une bibliothèque

Le README est explicite : le projet est « un tutoriel complet orienté OpenClaw », destiné à apprendre un système d'assistant en ligne de commande. Il n'y a pas de paquet à installer depuis ce dépôt, pas de binaire, pas de release publiée. La page d'accueil pointe vers une lecture en ligne, et le badge de licence indique CC BY-NC-SA 4.0. Le langage principal déclaré est JavaScript, ce qui correspond vraisemblablement aux exemples et au code des chapitres de développement, mais le dépôt lui-même reste avant tout un ensemble de fichiers Markdown organisés en chapitres. C'est une distinction importante : quand vous clonez hello-claw, vous récupérez de la prose et des exemples, pas un logiciel à exécuter.

Trois parcours pour trois niveaux d'engagement

La documentation est découpée en trois blocs. Le premier, « 领养龙虾 » (adopter un homard), couvre 11 chapitres plus 7 annexes : installation aux chapitres 1 à 3, configuration du cœur aux chapitres 4 à 6, exploitation étendue aux chapitres 7 à 9, sécurité et clients aux chapitres 10 et 11. Le deuxième bloc, « 龙虾大学 » (université du homard), est un catalogue de scénarios prêts à l'emploi autour des Skills : messagerie, santé, briefing matinal, agenda, CI/CD, génération de documentation, veille scientifique, CRM, réunions, collaboration multi-agents, domotique, analyse financière, formation. Le troisième, « 构建龙虾 » (construire un homard), compte 11 chapitres et part de l'analyse du code source d'OpenClaw pour aller vers l'écriture de Skills, de canaux et de personnalisations complètes. Le README recommande aux débutants de commencer par le premier bloc, à ceux qui veulent un résultat concret d'aller piocher 5 à 10 Skills dans le deuxième, et aux développeurs d'attaquer directement le troisième.

Ce que l'installation demande vraiment

Deux chemins sont décrits. Le premier passe par AutoClaw, un client de bureau présenté comme une prise en main en cinq minutes sans prérequis. Le second est manuel : introduction au terminal, installation de Node.js, npm install, puis un assistant de configuration appelé onboard. Le chapitre 3 détaille ce que fait cet assistant sur macOS et comment le relancer, et mentionne un mode Custom Provider pour brancher un fournisseur de modèle non listé. Les chapitres suivants traitent le raccordement des plateformes de messagerie en prenant Feishu comme exemple complet, la gestion des modèles avec rotation de clés API et bascule en cas de panne, puis la gestion multi-agents avec espaces de travail, battements de cœur et règles de liaison. Le chapitre 7 couvre les tâches planifiées avec trois modes : cron, at et every. Le chapitre 8 traite la passerelle : démarrage, mise à jour à chaud, authentification, gestion des clés, politique de bac à sable et journaux. Le chapitre 9 aborde l'accès distant via tunnel SSH et Tailscale. Aucun numéro de version de Node.js n'apparaît dans le matériel fourni, et je ne peux donc pas vous le donner.

Le rythme des mises à jour dépasse celui d'un livre

La section des actualités montre un projet qui suit OpenClaw de très près. Une entrée datée du 25 mars 2026 liste, pour OpenClaw v2026.3.24 : un point de terminaison compatible OpenAI sur la passerelle (/v1/models, /v1/embeddings), une intégration Microsoft Teams via SDK officiel, l'installation des Skills en une commande, un filtre d'état dans l'interface de contrôle, une option CLI --container pour exécuter dans un conteneur, un nommage automatique des fils Discord, un crochet de plugin before_dispatch, et des correctifs de sécurité sur les médias en bac à sable. Deux jours plus tôt, la version 3.22 était décrite comme une refonte du SDK de plugins avec abandon de l'ancienne extension-api, un durcissement de sécurité (fuite d'identifiants SMB, injection de variables d'environnement, usurpation Unicode), le passage à GPT-5.4 par défaut et l'allongement du délai d'expiration des agents à 48 heures. Ce rythme a une conséquence directe : un tutoriel qui suit des versions publiées toutes les quarante-huit heures vieillit vite, et la valeur du dépôt dépend de la fréquence à laquelle ses chapitres sont réécrits. Le README affirme que les chapitres sont synchronisés à chaque version, mais rien dans le matériel fourni ne permet de vérifier chapitre par chapitre.

La sécurité est traitée, mais pas par le dépôt

Le chapitre 10 annonce une couverture large : panorama des menaces, isolation par machine virtuelle, frontières de confiance, référence à MITRE ATLAS et sécurité de la chaîne d'approvisionnement. Un scénario dédié dans l'université sert de liste de contrôle. C'est un choix pédagogique cohérent avec la nature du sujet : un agent qui lit vos messages, exécute des commandes et se connecte à des services externes concentre les risques. Mais il faut être clair sur ce que cela signifie. hello-claw documente des pratiques ; il n'implémente aucun contrôle. Si vous cherchez un bac à sable, un proxy de filtrage ou un mécanisme d'approbation, vous ne le trouverez pas ici. La documentation vous dit quoi configurer dans OpenClaw, et la responsabilité de la configuration reste entièrement la vôtre.

Ce qui manque dans le matériel disponible

Plusieurs points restent ouverts. Le README est tronqué à la fin de l'annexe B, donc la liste complète des annexes n'est pas connue. Aucune release n'a été récupérée : il n'existe donc aucun point de version auquel accrocher une reproductibilité. Le fichier LICENSE est référencé par un lien relatif mais son contenu n'est pas fourni ; le badge indique CC BY-NC-SA 4.0, ce qui implique une clause non commerciale et un partage à l'identique, mais je ne peux pas confirmer la formulation exacte du fichier. Le dépôt n'est pas archivé, et la dernière poussée enregistrée date du 19 août 2026. Enfin, la documentation est en chinois, avec des README en anglais et en japonais, mais rien n'indique que les chapitres eux-mêmes existent dans ces langues.

Face à une documentation officielle ou à un cours généraliste

L'alternative la plus directe est la documentation du projet OpenClaw lui-même. La différence tient à la forme : une documentation de référence décrit les options une par une et suppose que vous savez ce que vous cherchez ; hello-claw organise le même sujet en progression, avec des scénarios complets et un parcours de reconstruction du code source. Une autre alternative est un cours généraliste sur les agents conversationnels. Là, l'écart est plus net : un cours générique vous apprendra les concepts de boucle d'agent et d'appel d'outils sur des exemples abstraits, tandis que hello-claw s'ancre dans un système précis, avec ses noms de commandes, ses fichiers de configuration et ses canaux de messagerie. Le prix de cet ancrage est la dépendance : si OpenClaw change de modèle de plugins, comme la version 3.22 l'a fait en abandonnant extension-api, les chapitres concernés deviennent obsolètes jusqu'à réécriture.

Licence et coût de suivi

La licence affichée est CC BY-NC-SA 4.0. Concrètement, cela signifie que la réutilisation commerciale du contenu n'est pas couverte par cette licence et que toute adaptation doit être partagée sous les mêmes conditions, avec attribution. Je ne donne pas d'avis juridique : si vous envisagez de reprendre ces chapitres dans une formation payante ou une documentation interne d'entreprise, lisez le fichier LICENSE du dépôt et, le cas échéant, demandez un avis compétent. Le coût de maintenance, lui, se lit dans le calendrier : le dépôt suit des versions publiées à un rythme de quelques jours, et chaque changement de SDK de plugins ou de gestion des Skills se répercute sur plusieurs chapitres à la fois. Adopter ce tutoriel comme ressource de référence implique donc de vérifier la date de la dernière poussée avant chaque session de formation, et de considérer les chapitres de développement comme la partie la plus fragile.

Conclusion éditoriale

hello-claw s'adresse à des lecteurs sinophones qui veulent un parcours structuré autour d'OpenClaw, pas à une équipe cherchant un composant à intégrer. Avant de vous engager, ouvrez docs/cn/university/security/index.md et vérifiez le contenu réel des chapitres 1 à 3 : le dépôt ne publie aucune release, donc la seule chose que vous pouvez évaluer est le texte.

Sources officielles

1. datawhalechina/hello-claw on GitHub
2. Issues
3. Project website
4. README