Tutoriel PicoClaw : un framework d'agent hyper minimaliste pour les espaces disque limités

Si l'on en croit l'actualité, l'IA dévore toute la RAM et les CPU de la planète : PicoClaw arrive donc à point nommé. Pas étonnant qu'il ait fait grand bruit : il a reçu des milliers d'étoiles en quelques jours. L'agent IA complet tient en moins de 10 Mo et se lance en moins d'une seconde sur un processeur à 600 MHz. 

En le découvrant, j'ai voulu le tester moi-même pour vérifier si tout ce battage était mérité. Dans cet article, je vous présente PicoClaw et tout ce que j'y ai trouvé d'intéressant. 

Si vous souhaitez en savoir plus sur l'IA agentique, je vous conseille de commencer par le parcours de compétences AI Agent Fundamentals. 

Qu'est-ce que PicoClaw ?

PicoClaw est un assistant IA personnel léger inspiré de Nanobot. Écrit en Go par l'équipe Sipeed, il fonctionne sur des appareils « edge » comme Raspberry Pi, des cartes embarquées RISC-V et des routeurs basés sur MIPS. En clair : vous pouvez exécuter PicoClaw avec un budget matériel de 10 $. 

Fonctionnalités et capacités clés de PicoClaw

PicoClaw est livré sous forme d'un unique binaire. La mise en place est donc ultra-rapide : aucun environnement virtuel Python à configurer, aucun pip install à lancer. 

Sous forme binaire, il tourne sur de multiples architectures. La page des releases propose des téléchargements pour différents systèmes d'exploitation : Linux, macOS et Windows. 

Côté IA, PicoClaw est indépendant du fournisseur. Il prend en charge OpenAI, Anthropic, DeepSeek, et même Ollama pour les modèles locaux. Un atout de taille pour changer de modèle selon les besoins ou rester en local pour des raisons de confidentialité. 

Vous pouvez apprendre à configurer Ollama pour les modèles locaux dans le guide Using OpenClaw with Ollama. 

PicoClaw embarque des outils capables de : 

• Lire et écrire des fichiers 
• Exécuter des commandes shell sur l'hôte 
• Rechercher sur le web avec Brave Search ou DuckDuckGo 
• Planifier des tâches récurrentes avec cron 

Comme Nanobot, il gère les canaux habituels : WhatsApp, Telegram, Discord, QQ et DingTalk. Je vous montrerai plus loin comment le configurer avec Telegram. 

Découvrez Nanobot, l' alternative à OpenClaw légère. Créez un agent IA Python sûr et traçable en moins de 10 minutes avec ce guide d'installation complet de Nanobot.

Avantages et inconvénients de PicoClaw

Vous vous demandez sans doute quels sont les points faibles de PicoClaw, tant il est rapide et simple à configurer. On y vient ; regardons d'abord ses atouts. 

Premièrement, le fait d'être un binaire facilite l'installation sur quasiment n'importe quel appareil. Je l'ai configuré en quelques minutes sur mon téléphone Google Pixel. 

Deuxièmement, PicoClaw s'intègre à vos plateformes de messagerie existantes, ce qui permet d'interagir sans changer d'application. 

Côté limites, PicoClaw est encore en pré-version 1.0. En tant qu'outil très récent, il peut comporter des bugs inattendus ou des changements incompatibles. Au fil de mes recherches, j'ai aussi relevé de nombreux scams crypto ciblant PicoClaw. La doc officielle précise qu'ils n'ont aucune « coin » : soyez vigilant. 

Comment installer PicoClaw

L'installation de PicoClaw se fait en quelques étapes. Voici comment procéder :

Installation (téléchargement d'un binaire unique)

Pour installer PicoClaw, vous pouvez le compiler depuis les sources :

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
# Build, no need to install
make build
# Build for multiple platforms
make build-all
# Build for Raspberry Pi Zero 2 W (32-bit: make build-linux-arm; 64-bit: make build-linux-arm64)
make build-pi-zero
# Build And Install
make installPropulsé par

Je préfère toutefois Docker, bien plus rapide : 

# 1. Clone this repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. First run — auto-generates docker/data/config.json then exits
docker compose -f docker/docker-compose.yml --profile gateway up
# The container prints "First-run setup complete." and stops.
# 3. Set your API keys
nano docker/data/config.json   # Set provider API keys, bot tokens, etc.
# 4. Start
docker compose -f docker/docker-compose.yml --profile gateway up -dPropulsé par

Maîtrisez l'essentiel de la conteneurisation avec notre guide Docker for Beginners. 

Configurer votre fournisseur de LLM

Après l'installation, vous devez configurer le fournisseur LLM de votre choix. Pour cela, éditez le fichier docker/data/config.json :

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "your-api-key",
      "request_timeout": 300
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "your-anthropic-key"
    }
  ],
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "tavily": {
        "enabled": false,
        "api_key": "YOUR_TAVILY_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      },
      "perplexity": {
        "enabled": false,
        "api_key": "YOUR_PERPLEXITY_API_KEY",
        "max_results": 5
      },
      "searxng": {
        "enabled": false,
        "base_url": "http://your-searxng-instance:8888",
        "max_results": 5
      }
    }
  }
}Propulsé par

Lancer votre premier agent

Relier PicoClaw à Telegram ne prend que quelques étapes.

Voici comment j'ai procédé pour Telegram :

• Ouvrez Telegram et cherchez @BotFather 
• Saisissez /newbot et suivez les instructions 
• Copiez le jeton transmis par BotFather 
• Récupérez ensuite votre ID utilisateur pour que le bot n'accepte que vos commandes. Recherchez @userinfobot dans Telegram, cliquez sur Démarrer et copiez l'ID utilisateur.

Mettez ensuite à jour le fichier docker/data/config.json pour y renseigner le jeton du bot et votre ID Telegram. 

Rendez-vous maintenant sur votre bot Telegram et commencez à interagir avec PicoClaw. 

Essayons quelques invites. 

D'abord, j'utilise PicoClaw pour rechercher sur le web et renvoyer le cours actuel de l'action Apple. Comme on le voit sur la capture, il a utilisé l'outil de recherche DuckDuckGo et a récupéré le prix. 

Voici une autre demande : demander à PicoClaw de rédiger un article de blog, de l'enregistrer sur disque puis de le lire : 

J'étais curieux de ses capacités de planification : je lui ai demandé de me rappeler de publier l'article dans cinq minutes, et le rappel est bien arrivé après 5 minutes. 

Problèmes courants et dépannage avec PicoClaw

Lors de l'installation de PicoClaw, j'ai rencontré quelques problèmes. Je les cite brièvement ici au cas où vous auriez les mêmes. 

Aucune réponse sur Telegram

Si vous ne recevez aucune réponse sur Telegram, la cause peut être : 

• Le jeton Telegram est incorrect. Rouvrez le fichier de config et vérifiez-le 
• L'ID utilisateur from n'est pas défini, ou vous accédez à l'agent depuis un autre compte 
• Le modèle et les clés API ne sont pas renseignés. Ouvrez le fichier de config et complétez-les

En consultant les logs, vous verrez le problème exact : 

docker compose -f docker/docker-compose.yml logs -f picoclaw-gatewayPropulsé par

Modèle non défini 

L'erreur ci-dessous signifie que vous n'avez pas défini le modèle par défaut : 

Error: error creating provider: model "" not found in model_list: model "" not found in model_list or providersPropulsé par

Ouvrez le fichier de configuration JSON, définissez le nom du modèle à utiliser et assurez-vous que sa clé API figure également dans le fichier.

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4", ---> make sure this is here 
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  }Propulsé par

Clé API incorrecte

Ici, c'est simple : la clé API du fournisseur choisi est vide ou erronée. Ouvrez le fichier de configuration JSON et vérifiez la clé.

Les capacités qui distinguent PicoClaw

Voyons maintenant les fonctionnalités qui rendent PicoClaw à la fois unique et proche d'autres assistants IA personnels. 

Le système Heartbeat

PicoClaw dispose d'un fichier markdown « heartbeat » dans son répertoire de travail, que l'agent lit toutes les 30 minutes pour exécuter les instructions qui s'y trouvent. PicoClaw peut aussi lancer des sous-agents pour traiter des tâches en parallèle. 

Mémoire persistante

PicoClaw possède un fichier mémoire où sont stockées les informations importantes devant persister entre les sessions. Il enregistre vos préférences et compétences activées afin de disposer du contexte nécessaire sans repartir de zéro à chaque interaction. 

Mode cloisonné / hors ligne

PicoClaw peut fonctionner sans accès à Internet. C'est crucial pour traiter des données sensibles, notamment dans des secteurs réglementés comme la banque et la santé. Pour cela, vous devrez configurer un modèle local via Ollama. 

Multi-agents et repli sur autres modèles

Avec PicoClaw, chaque agent peut utiliser son propre fournisseur de LLM. Le load balancing est pris en charge : vous pouvez répartir les requêtes entre plusieurs modèles. Une fois configuré, PicoClaw fait tourner les modèles en round-robin.

Intégration matérielle

PicoClaw inclut des outils intégrés pour la communication I2C et SPI. L'agent peut ainsi dialoguer avec des périphériques sur les cartes compatibles : capteurs, écrans, contrôleurs de moteurs et une large gamme d'appareils physiques. 

PicoClaw en action : cas d'usage réels

Explorons quelques cas d'usage de PicoClaw. 

Parmi les idées intéressantes relevées en ligne lors de mes recherches : 

• Automatisation et supervision à domicile avec un Raspberry Pi de première génération 
• Recherches web automatisées, par exemple pour recevoir chaque matin des résumés sur Telegram 
• Alerte et monitoring depuis des appareils embarqués, par exemple à partir de données de capteurs 

Limitations et précautions avec PicoClaw

Avant de déployer PicoClaw sur votre réseau, gardez à l'esprit plusieurs limites importantes.

D'abord, PicoClaw est sûr par défaut : il est cantonné à son espace de travail et ne peut pas accéder à des dossiers ou fichiers en dehors de ce répertoire. 

Vous pouvez modifier ce comportement dans le fichier de configuration. 

Certaines commandes, comme rm, sont également restreintes pour éviter, par exemple, l'effacement complet de votre disque dur. 

Ainsi, j'ai tenté de lui faire supprimer mon dossier personnel : les garde-fous se sont déclenchés pour l'empêcher. 

En phase de développement précoce, PicoClaw présente encore des problèmes de sécurité réseau non résolus ; il est donc déconseillé de le déployer en production avant la version 1.0. 

Si vous cherchez un outil plus mûr, OpenClaw est une bonne option. Voyez s'il convient à votre flux de travail dans notre guide OpenClaw vs Claude Code. 

Perspectives

La possibilité d'exécuter des grands modèles de langage sur des appareils en périphérie a gagné du terrain ces derniers temps, notamment avec des modèles capables de tourner sur mobile et sur des dispositifs embarqués. Je pense que PicoClaw sera très utile dans des environnements contraints en ressources et là où la sensibilité des données est critique. En contexte de connectivité aléatoire, un outil comme PicoClaw s'impose. 

PicoClaw pourrait devenir un véritable concurrent de Nanobot et OpenClaw lorsqu'il sera prêt pour la production. Je parierais que PicoClaw sera l'outil qui permettra aux objets connectés de réaliser des workflows agentiques. Cela comporte aussi des risques sérieux si les modèles à l'origine de l'agent hallucinent ou si une injection de prompt les amène à des actions malveillantes, comme faire surchauffer un micro-ondes. 

PicoClaw entend également combler les fonctionnalités manquantes présentes dans d'autres agents, comme OpenClaw, selon leur feuille de route, notamment :

• Automatisation du navigateur
• Découverte de nouvelles compétences 
• Prise en charge MCP 

Conclusion

Lors du lancement d'OpenClaw, on a beaucoup parlé d'acheter des Mac Mini pour le faire tourner, alors que ce n'était pas indispensable. Un Mac Mini coûte plusieurs centaines de dollars. 

PicoClaw a été conçu pour battre en brèche cette idée, en permettant de déployer des agents puissants avec un budget de 10 $. Contrairement à OpenClaw, PicoClaw adopte une approche « security-first » : l'agent est restreint à son workspace et les commandes potentiellement destructrices sont désactivées lorsque le modèle sous-jacent hallucine ou qu'un prompt malveillant est injecté. 

Pour aller plus loin avec les outils d'IA, je vous recommande de consulter notre guide des meilleurs outils IA gratuits. Pour développer des compétences plus larges en code avec l'IA, essayez notre cours AI-Assisted Coding for Developers pour faire de l'IA un partenaire plus fiable dans votre flux de développement. 

Découvrez également comment créer des applications dopées à l'IA avec des LLM, des prompts, des chaînes et des agents dans LangChain grâce à notre cours Developing LLM Applications with LangChain.