microclaw : lecture pratique du dépôt microclaw

Focus du projet et conception principale

MicroClaw est décrit comme un runtime d'agent Rust auto-hébergé. L'idée de conception centrale est d'utiliser une boucle d'agent indépendante du canal et une couche LLM indépendante du fournisseur pour alimenter Telegram, Discord, Slack, Feishu/Lark, Web et d'autres adaptateurs sans dupliquer le comportement à chaque frontière. Il est conçu pour des travaux qui durent plus longtemps qu'une seule requête, comme l'utilisation d'outils en plusieurs étapes, des sessions reprenables, la livraison durable, la mémoire persistante, les tâches planifiées et les extensions gouvernées.

Fonctionnalités principales et fiabilité

Le projet met l'accent sur un runtime unique pour de nombreuses surfaces, une exécution qui peut continuer à travers les redémarrages de processus et la liberté des fournisseurs via Anthropic natif ou un large ensemble de fournisseurs compatibles OpenAI et locaux. L'extensibilité vient de l'ajout de compétences, de serveurs MCP, de plugins, de hooks, d'outils ou d'adaptateurs de canal sans remplacer le runtime principal. Il est conçu pour fonctionner sur une infrastructure modeste, en s'appuyant sur un service Rust et SQLite intégré, sans nécessiter de base de données vectorielle distincte ni de maillage de services. La sécurité fait partie de l'exécution grâce à des points d'application partagés pour les barrières de risque des outils, les autorisations limitées, les contrôles de sortie, le sandboxing, la rédaction et les pistes d'audit.

Fiabilité que vous pouvez vérifier

Le README comprend un tableau qui associe des scénarios de défaillance spécifiques aux garanties de MicroClaw et aux commandes ou interfaces permettant de les vérifier. Par exemple, si une réponse dépasse une limite de canal, la réponse est acceptée durablement, divisée en morceaux ordonnés et réessayée sans perdre d'octets limites; cela peut être vérifié avec `microclaw doctor delivery`. Si le processus s'arrête entre les étapes de modèle et d'outil, un point de contrôle neutre reprend le travail terminé sans rejouer les résultats d'outils terminés. Si un outil d'écriture est interrompu, la récupération s'arrête au niveau des effets secondaires incertains et demande une vérification au lieu de rejouer aveuglément l'appel. Si un canal est indisponible, l'achèvement de la tâche et la livraison du message restent séparés, ce qui permet au résultat de rester en file d'attente pour un nouvel essai.

Flux de travail et architecture

Chaque message suit le même flux : reprendre l'état de la session et charger la mémoire, les compétences et le contexte d'exécution pertinents; appeler le modèle sélectionné en utilisant des messages et des définitions d'outils neutres vis-à-vis du fournisseur; exécuter les outils via des garde-fous, des hooks et des contrôles d'autorisation partagés; continuer jusqu'à la fin, puis persister le tour et livrer le résultat durablement. Les adaptateurs de canal ne traduisent que les événements d'entrée et de livraison; ils ne portent pas leurs propres boucles d'agent ni comportement spécifique au fournisseur.

Aperçu des capacités

Les capacités de MicroClaw sont organisées en plusieurs domaines. L'exécution de l'agent couvre les outils en plusieurs étapes, les vagues de lecture seule parallèles, la planification, les mises à jour de progression, les contrats d'achèvement et les sous-agents. La continuité couvre les sessions reprenables, la compression de contexte, les points de contrôle, la livraison sortante durable, la planification et l'annulation. La mémoire et l'apprentissage couvrent la mémoire fichier et SQLite, le rappel sémantique, le graphe de connaissances temporel, les preuves d'expérience et l'évolution des compétences gouvernée. L'extension couvre les compétences, les plugins de manifeste, les hooks, MCP, ClawHub, A2A et ACP. Les interfaces incluent une UI Web locale, des API HTTP/SSE/WebSocket, des adaptateurs de chat et des protocoles d'agent. La sécurité et les opérations incluent les approbations d'outils, les autorisations de capacité limitées, le sandboxing Docker, la politique de sortie, la rédaction des secrets, les métriques, les traces et les diagnostics.

Canaux et fournisseurs

Le runtime inclut des adaptateurs pour Telegram, Discord, Slack, Feishu/Lark, WeChat, DingTalk, QQ, WhatsApp, Signal, Matrix, IRC, Nostr, iMessage, e-mail et Web. Matrix est activé par la fonctionnalité `full`, et la disponibilité et les exigences de configuration varient selon la plateforme. Anthropic a un chemin de fournisseur natif, tandis qu'OpenAI, OpenAI Codex, OpenRouter, Ollama, Google, DeepSeek, les serveurs locaux et de nombreux autres services utilisent le chemin compatible OpenAI partagé. La matrice de fournisseurs générée est citée comme la source de vérité pour les ID, protocoles, valeurs par défaut et modèles actuels.

Options d'installation et documentation

Le README répertorie plusieurs méthodes d'installation : un script d'installation macOS/Linux, un script PowerShell Windows, Homebrew, une image conteneur et des builds source. Le binaire Linux pré-construit a des exigences glibc et OpenSSL, et le guide de démarrage doit être lu avant l'installation sur une distribution plus ancienne. La documentation est divisée en sections couvrant le démarrage, un livre de recettes, un catalogue d'outils généré, les valeurs par défaut de configuration, un manuel d'exploitation, un guide de sécurité, des guides de développement et de contribution, un guide de test, un journal des modifications et un guide de mise à niveau. Les fichiers README localisés couvrent l'aperçu du projet et le démarrage rapide, tandis que la documentation technique anglaise est traitée comme la source canonique pour les commandes et les faits de configuration.

Contrôler microclaw dans son environnement

Suivez la commande de démarrage MicroClaw du README, inspectez sa configuration et testez une requête minimale en vérifiant les journaux et le comportement d’arrêt. Cette vérification est liée aux fichiers, commandes et interfaces cités par microclaw/microclaw. Relevez la version utilisée, la sortie complète et le comportement d’une entrée nominale puis invalide. Le README ne documente pas nécessairement les limites de charge, les migrations ou les garanties de sécurité; ces points doivent donc rester des réserves précises dans la décision, surtout pour un outil qui touche au réseau, aux paquets, aux données vidéo, au cluster ou à l’inférence locale.

Conclusion éditoriale

Ce projet s’adresse à une équipe dont le besoin correspond exactement au parcours décrit pour microclaw/microclaw. Il convient moins à une adoption sans revue des versions et des limites. Commencez par cette vérification : Suivez la commande de démarrage MicroClaw du README, inspectez sa configuration et testez une requête minimale en vérifiant les journaux et le comportement d’arrêt.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes