PicoClaw : un assistant IA ultra-léger pour matériel low-cost

https://github.com/sipeed/picoclaw

📌 PicoClaw est une application ultra-légère d’assistant IA personnel développée en Go, conçue pour fonctionner sur du matériel à 10 $, avec moins de 10 MB de RAM et un démarrage en 1 seconde. PicoClaw est inspiré de NanoBot et entièrement refactorisé en Go via un processus d’auto-bootstrapping où l’agent IA a piloté lui-même l’architecture et l’optimisation du code. Le résultat : un binaire unique, portable et autonome, capable de tourner sur RISC-V, ARM ou x86. Pensé pour l’efficacité extrême, PicoClaw réduit drastiquement l’empreinte mémoire et les coûts d’infrastructure, tout en conservant des capacités avancées d’agent IA.

• 🪶 Ultra-léger : <10 MB de RAM — jusqu’à 99 % de mémoire en moins que certaines alternatives.
• 💰 Coût minimal : exécutable sur des cartes Linux à partir de 10 $.
• ⚡ Démarrage éclair : boot en <1 seconde, même sur CPU single-core 0.6–0.8 GHz.
• 🌍 Binaire unique multiplateforme : déploiement en un clic.
• 🤖 Architecture AI-bootstrapped : cœur majoritairement généré par agent IA avec validation humaine.

Comparé à des solutions TypeScript ou Python nécessitant >100 MB à >1 GB de RAM et plusieurs dizaines de secondes de démarrage, PicoClaw privilégie la compacité et la rapidité d’exécution. Le déploiement est possible sur presque n’importe quel appareil Linux : LicheeRV-Nano (~9.9 $), NanoKVM, MaixCAM ou cartes similaires pour des cas d’usage tels qu’assistant domestique minimal, maintenance serveur automatisée ou monitoring intelligent. L’installation peut se faire via binaire précompilé, compilation depuis la source ou via Docker Compose. En quelques commandes (picoclaw onboard, configuration des clés API, puis picoclaw agent -m "..."), un assistant IA opérationnel est disponible en moins de deux minutes. PicoClaw prend en charge plusieurs fournisseurs LLM : OpenRouter, Zhipu, Anthropic, OpenAI, Gemini, Groq. La recherche web peut s’appuyer sur Brave Search (2000 requêtes gratuites/mois) ou DuckDuckGo en fallback automatique. L’assistant peut être connecté à Telegram, Discord, QQ, DingTalk ou LINE via configuration JSON simple. En conversation de groupe, la réponse s’active uniquement lors d’une mention explicite. La structure interne repose sur un workspace local organisé :

• 📂 sessions/ : historique des conversations
• 🧠 memory/ : mémoire long terme
• 🗂️ state/ : état persistant
• ⏰ cron/ : tâches planifiées
• 🛠️ skills/ : extensions personnalisées

Un mode Heartbeat permet l’exécution automatique de tâches périodiques (vérification email, météo, actualités IA) toutes les 30 minutes. Les tâches longues peuvent être déléguées à des sous-agents asynchrones via spawn, sans bloquer le cycle principal. La sécurité constitue un pilier central. Par défaut, l’agent est restreint à un sandbox (restrict_to_workspace: true) empêchant tout accès hors répertoire configuré. Les commandes dangereuses (rm -rf, format, shutdown, fork bomb, etc.) sont bloquées même en configuration étendue. Points de vigilance :

• 🚨 Aucun token ou crypto officiel — toute revendication externe est frauduleuse.
• 🌐 Domaine officiel : picoclaw.io (éditeur : sipeed.com).
• ⚠️ Projet en développement pré-v1.0 — éviter les environnements de production.
• 📈 Les dernières mises à jour peuvent temporairement augmenter l’empreinte mémoire (10–20 MB) avant optimisation.

Depuis son lancement, PicoClaw a connu une forte adoption communautaire, avec plusieurs milliers d’étoiles GitHub en quelques jours. Les contributions sont encouragées, avec une feuille de route en cours de structuration et un groupe développeurs actif. PicoClaw démontre qu’un assistant IA complet peut fonctionner sur une architecture minimaliste, combinant sobriété matérielle, rapidité d’exécution et contrôle local avancé.

Personnellement je l’ai installé sur ma Freebox après avoir configuré une petite VM sur Debian. Et ensuite j’ai procédé de la manière suivante.

Tutoriel Complet (ce que j’ai fait sur ma VM freebox)

1. Cloner PicoClaw
   git clone https://github.com/sipeed/picoclaw.git /home/clm/picoclaw
   
   Note: /picoclaw (racine) n’était pas accessible sans droits admin, donc
   installation dans /home/clm/picoclaw.
   
2. Installer le binaire PicoClaw (sans Go)
   mkdir -p /home/clm/.local/bin
   curl -fL https://github.com/sipeed/picoclaw/releases/download/v0.1.1/
   picoclaw-linux-arm64 -o /home/clm/.local/bin/picoclaw
   chmod +x /home/clm/.local/bin/picoclaw
   
3. Initialiser PicoClaw
   picoclaw onboard
   Ça crée les fichiers dans ~/.picoclaw/ (dont config.json).
   
4. Configurer Z.AI (avec ma clé API, mais ça fonctionne bien evidemment avec OpenAI, OpenRouter, Anthropic, etc… au pire demande à ChatGPT de t’aider, c’est ce que j’ai fait personnellement 😉 )
   Fichier: ~/.picoclaw/config.json
   Config utilisée:
   {
   « agents »: {
   « defaults »: {
   « workspace »: « ~/.picoclaw/workspace »,
   « provider »: « zhipu »,
   « model »: « glm-4.7 »,
   « max_tokens »: 8192,
   « temperature »: 0.7,
   « max_tool_iterations »: 20
   }
   },
   « providers »: {
   « zhipu »: {
   « api_key »: « TA_CLE_ZAI »,
   « api_base »: « https://api.z.ai/api/coding/paas/v4 »
   }
   },
   « tools »: {
   « web »: {
   « duckduckgo »: {
   « enabled »: true,
   « max_results »: 5
   }}}}
   
   Important: pour ton plan GLM Coding Lite,
   il faut api_base = https://api.z.ai/api/coding/paas/v4
   (pas le endpoint général).
   
5. Tester en terminal picoclaw agent -m « Hello »
   Si réponse OK: installation fonctionnelle.
   
6. Configurer Telegram
   • Créer le bot et récupérer le token
   • Ouvre Telegram, cherche @BotFather
   • Envoie /newbot
   • Donne un nom puis un username (doit finir par bot)
   • BotFather te renvoie un token comme: 123456789:AA…
   • C’est la valeur à mettre dans channels.telegram.token
     
7. Récupérer ton user ID Telegram
   • cherche @userinfobot
   • Envoie n’importe quel message
   • Il te renvoie ton ID numérique (ex: 7319059834)
   • C’est la valeur à mettre dans channels.telegram.allow_from
     
8. Mettre la config Telegram dans ~/.picoclaw/config.json
   « channels »: {
   « telegram »: {
   « enabled »: true,
   « token »: « TON_BOT_TOKEN »,
   « allow_from »: [« TON_USER_ID »]
   }
   }
   
9. Lancer la gateway :
   picoclaw gateway
   
10. Si tu vois enabled_channels=1, Telegram est actif
11. Trouver ton bot sur Telegram (en le cherchant par son nom)
12. Ouvre le bot, clique Start, puis envoie un message
13. Option pour ne pas laisser le terminal ouvert
    nohup picoclaw gateway > ~/.picoclaw/gateway.log 2>&1 &
14. Sécurité importante :
    Si token/clé ont été partagés, régénère-les et remplace dans ~/.picoclaw/config.json.