README.Fr

<a href="https://picoclaw.io"></a>
<a href="https://docs.picoclaw.io/"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"></a>


<a href="https://x.com/SipeedIO"></a>
<a href="../../assets/wechat.png"></a>
<a href="https://discord.gg/V4sAZ9XWpN"></a>

中文 | 日本語 | 한국어 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | Malay | English

PicoClaw est un projet open-source indépendant initié par Sipeed, entièrement écrit en Go à partir de zéro — ce n'est pas un fork d'OpenClaw, de NanoBot ou de tout autre projet.

PicoClaw est un assistant personnel IA ultra-léger inspiré de NanoBot. Il a été entièrement reconstruit en Go via un processus d'auto-amorçage (self-bootstrapping) — l'Agent IA lui-même a piloté la migration architecturale et l'optimisation du code.

Fonctionne sur du matériel à $10 avec <10 Mo de RAM — c'est 99% de mémoire en moins qu'OpenClaw et 98% moins cher qu'un Mac mini !

[!CAUTION] Avis de sécurité

• PAS DE CRYPTO : PicoClaw n'a pas émis de tokens officiels ni de cryptomonnaie. Toute affirmation sur pump.fun ou d'autres plateformes de trading est une arnaque.
• DOMAINE OFFICIEL : Le SEUL site officiel est picoclaw.io, et le site de l'entreprise est sipeed.com
• ATTENTION : De nombreux domaines .ai/.org/.com/.net/... ont été enregistrés par des tiers. Ne leur faites pas confiance.
• NOTE : PicoClaw est en développement rapide précoce. Des problèmes de sécurité non résolus peuvent exister. Ne pas déployer en production avant la v1.0.
• NOTE : PicoClaw a récemment fusionné de nombreuses PRs. Les builds récents peuvent utiliser 10-20 Mo de RAM. L'optimisation des ressources est prévue après la stabilisation des fonctionnalités.

📢 Actualités

2026-03-31 📱 Support Android ! PicoClaw fonctionne maintenant sur Android ! Téléchargez l'APK sur picoclaw.io

2026-03-25 🚀 v0.2.4 publiée ! Refonte de l'architecture Agent (SubTurn, Hooks, Steering, EventBus), intégration WeChat/WeCom, renforcement de la sécurité (.security.yml, filtrage des données sensibles), nouveaux providers (AWS Bedrock, Azure, Xiaomi MiMo), et 35 corrections de bugs. PicoClaw a atteint 26K Stars !

2026-03-17 🚀 v0.2.3 publiée ! Interface system tray (Windows & Linux), requête de statut des sous-agents (spawn_status), rechargement à chaud expérimental du Gateway, sécurisation Cron, et 2 correctifs de sécurité. PicoClaw a atteint 25K Stars !

2026-03-09 🎉 v0.2.1 — Plus grande mise à jour à ce jour ! Support du protocole MCP, 4 nouveaux channels (Matrix/IRC/WeCom/Discord Proxy), 3 nouveaux providers (Kimi/Minimax/Avian), pipeline vision, stockage mémoire JSONL, routage de modèles.

2026-02-28 📦 v0.2.0 publiée avec support Docker Compose et Web UI Launcher.

2026-02-26 🎉 PicoClaw atteint 20K Stars en seulement 17 jours ! L'orchestration automatique des channels et les interfaces de capacités sont disponibles.

2026-02-16 🎉 PicoClaw dépasse 12K Stars en une semaine ! Rôles de mainteneurs communautaires et Roadmap officiellement lancés.

2026-02-13 🎉 PicoClaw dépasse 5000 Stars en 4 jours ! Roadmap du projet et groupes de développeurs en cours.

2026-02-09 🎉 PicoClaw publié ! Construit en 1 jour pour apporter les Agents IA sur du matériel à $10 avec <10 Mo de RAM. Let's Go, PicoClaw !

✨ Fonctionnalités

🪶 Ultra-léger : Empreinte mémoire du cœur <10 Mo — 99% plus petit qu'OpenClaw.*

💰 Coût minimal : Suffisamment efficace pour fonctionner sur du matériel à $10 — 98% moins cher qu'un Mac mini.

⚡️ Démarrage ultra-rapide : 400x plus rapide au démarrage. Démarre en <1s même sur un processeur monocœur à 0,6 GHz.

🌍 Vraiment portable : Binaire unique pour les architectures RISC-V, ARM, MIPS et x86. Un seul binaire, fonctionne partout !

🤖 Auto-amorcé par IA : Implémentation native pure Go — 95% du code principal a été généré par un Agent et affiné via une révision humaine en boucle.

🔌 Support MCP : Intégration native du Model Context Protocol — connectez n'importe quel serveur MCP pour étendre les capacités de l'Agent.

👁️ Pipeline vision : Envoyez des images et des fichiers directement à l'Agent — encodage base64 automatique pour les LLMs multimodaux.

🧠 Routage intelligent : Routage de modèles basé sur des règles — les requêtes simples vont vers des modèles légers, économisant les coûts API.

*Les builds récents peuvent utiliser 10-20 Mo en raison des fusions rapides de PRs. L'optimisation des ressources est prévue. Comparaison de vitesse de démarrage basée sur des benchmarks monocœur à 0,8 GHz (voir tableau ci-dessous).

Liste de compatibilité matérielle — Voir toutes les cartes testées, du RISC-V à $5 au Raspberry Pi en passant par les téléphones Android. Votre carte n'est pas listée ? Soumettez une PR !

🦾 Démonstration

🛠️ Flux de travail standard de l'assistant

🐜 Déploiement innovant à faible empreinte

PicoClaw peut être déployé sur pratiquement n'importe quel appareil Linux !

• $9,9 LicheeRV-Nano édition E(Ethernet) ou W(WiFi6), pour un assistant domestique minimal
• $30~50 NanoKVM, ou $100 NanoKVM-Pro, pour des opérations serveur automatisées
• $50 MaixCAM ou $100 MaixCAM2, pour la surveillance intelligente

https://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4

🌟 D'autres cas de déploiement vous attendent !

📦 Installation

Télécharger depuis picoclaw.io (Recommandé)

Visitez picoclaw.io — le site officiel détecte automatiquement votre plateforme et fournit un téléchargement en un clic. Pas besoin de choisir manuellement une architecture.

Télécharger le binaire précompilé

Vous pouvez aussi télécharger le binaire pour votre plateforme depuis la page GitHub Releases.

Compiler depuis les sources (pour le développement)

Prérequis :

• Go 1.25+
• Node.js 22+ et pnpm 10.33.0+ pour les builds Web UI / launcher

git clone https://github.com/sipeed/picoclaw.git

cd picoclaw
make deps

# Installer les dépendances frontend
(cd web/frontend && pnpm install --frozen-lockfile)

# Compiler le binaire principal
make build

# Compiler le Web UI Launcher (requis pour le mode WebUI)
make build-launcher

# Compiler les binaires core pour toutes les plateformes gérées par le Makefile
make build-all

# Compiler pour Raspberry Pi Zero 2 W (32 bits : make build-linux-arm ; 64 bits : make build-linux-arm64)
make build-pi-zero

# Compiler et installer
make install

Raspberry Pi Zero 2 W : Utilisez le binaire correspondant à votre OS : Raspberry Pi OS 32 bits -> make build-linux-arm ; 64 bits -> make build-linux-arm64. Ou exécutez make build-pi-zero pour compiler les deux.

🚀 Guide de démarrage rapide

🌐 WebUI Launcher (Recommandé pour le bureau)

Le WebUI Launcher fournit une interface basée sur navigateur pour la configuration et le chat. C'est la façon la plus simple de démarrer — aucune connaissance de la ligne de commande requise.

Option 1 : Double-clic (Bureau)

Après téléchargement depuis picoclaw.io, double-cliquez sur picoclaw-launcher (ou picoclaw-launcher.exe sous Windows). Votre navigateur s'ouvrira automatiquement sur http://localhost:18800.

Option 2 : Ligne de commande

picoclaw-launcher
# Ouvrez http://localhost:18800 dans votre navigateur

[!TIP] Accès distant / Docker / VM : Ajoutez le flag -public pour écouter sur toutes les interfaces :

bashCopy

picoclaw-launcher -public

Pour commencer :

Ouvrez le WebUI, puis : 1) Configurez un Provider (ajoutez votre clé API LLM) -> 2) Configurez un Channel (ex. Telegram) -> 3) Démarrez le Gateway -> 4) Chattez !

Pour la documentation détaillée du WebUI, voir docs.picoclaw.io.

# 1. Cloner ce dépôt
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. Premier lancement — génère automatiquement docker/data/config.json puis s'arrête
#    (se déclenche uniquement quand config.json et workspace/ sont tous deux absents)
docker compose -f docker/docker-compose.yml --profile launcher up
# Le conteneur affiche "First-run setup complete." et s'arrête.

# 3. Définir vos clés API
vim docker/data/config.json

# 4. Démarrer
docker compose -f docker/docker-compose.yml --profile launcher up -d
# Ouvrez http://localhost:18800

Utilisateurs Docker / VM : Le Gateway écoute sur 127.0.0.1 par défaut. Définissez PICOCLAW_GATEWAY_HOST=0.0.0.0 ou utilisez le flag -public pour le rendre accessible depuis l'hôte.

# Vérifier les logs
docker compose -f docker/docker-compose.yml logs -f

# Arrêter
docker compose -f docker/docker-compose.yml --profile launcher down

# Mettre à jour
docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile launcher up -d

macOS peut bloquer picoclaw-launcher au premier lancement car il est téléchargé depuis Internet et n'est pas notarisé via le Mac App Store.

Étape 1 : Double-cliquez sur picoclaw-launcher. Un avertissement de sécurité s'affiche :

"picoclaw-launcher" n'a pas pu être ouvert — Apple n'a pas pu vérifier que "picoclaw-launcher" ne contient pas de logiciel malveillant susceptible de nuire à votre Mac ou de compromettre votre confidentialité.

Étape 2 : Ouvrez Réglages Système → Confidentialité et sécurité → faites défiler jusqu'à la section Sécurité → cliquez sur Ouvrir quand même → confirmez en cliquant sur Ouvrir quand même dans la boîte de dialogue.

Après cette étape unique, picoclaw-launcher s'ouvrira normalement lors des lancements suivants.

<a id="-run-on-old-android-phones"></a>

📱 Android

Donnez une seconde vie à votre téléphone vieux de dix ans ! Transformez-le en assistant IA intelligent avec PicoClaw.

Option 1 : Installation APK

Aperçu :

Téléchargez l'APK depuis picoclaw.io et installez-le directement. Pas besoin de Termux !

Option 2 : Termux

1. Installez Termux (téléchargez depuis GitHub Releases, ou cherchez dans F-Droid / Google Play)
2. Exécutez les commandes suivantes :

# Télécharger la dernière version
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard   # chroot fournit une arborescence Linux standard

Suivez ensuite la section Terminal Launcher ci-dessous pour terminer la configuration.

Pour les environnements minimaux où seul le binaire principal picoclaw est disponible (sans Launcher UI), vous pouvez tout configurer via la ligne de commande et un fichier de configuration JSON.

1. Initialiser

picoclaw onboard

Cela crée ~/.picoclaw/config.json et le répertoire workspace.

2. Configurer (~/.picoclaw/config.json)

{
  "agents": {
    "defaults": {
      "model_name": "gpt-5.4"
    }
  },
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "sk-your-api-key"
    }
  ]
}

Voir config/config.example.json dans le dépôt pour un modèle de configuration complet avec toutes les options disponibles.

3. Chatter

# Question ponctuelle
picoclaw agent -m "What is 2+2?"

# Mode interactif
picoclaw agent

# Démarrer le gateway pour l'intégration d'applications de chat
picoclaw gateway

🔌 Providers (LLM)

PicoClaw supporte plus de 30 providers LLM via la configuration model_list. Utilisez le format protocole/modèle :

Ollama :

{
  "model_list": [
    {
      "model_name": "local-llama",
      "model": "ollama/llama3.1:8b",
      "api_base": "http://localhost:11434/v1"
    }
  ]
}

vLLM :

{
  "model_list": [
    {
      "model_name": "local-vllm",
      "model": "vllm/your-model",
      "api_base": "http://localhost:8000/v1"
    }
  ]
}

Pour les détails complets de configuration des providers, voir Providers & Models.

💬 Channels (Applications de chat)

Parlez à votre PicoClaw via plus de 17 plateformes de messagerie :

Tous les channels basés sur webhook partagent un seul serveur HTTP Gateway (gateway.host:gateway.port, par défaut 127.0.0.1:18790). Feishu utilise le mode WebSocket/SDK et n'utilise pas le serveur HTTP partagé.

La verbosité des logs est contrôlée par gateway.log_level (par défaut : warn). Valeurs supportées : debug, info, warn, error, fatal. Peut aussi être défini via PICOCLAW_LOG_LEVEL. Voir Configuration pour plus de détails.

Pour les instructions détaillées de configuration des channels, voir Configuration des applications de chat.

🔧 Outils

🔍 Recherche Web

PicoClaw peut effectuer des recherches sur le web pour fournir des informations à jour. Configurez dans tools.web :

⚙️ Autres outils

PicoClaw inclut des outils intégrés pour les opérations sur fichiers, l'exécution de code, la planification et plus encore. Voir Configuration des outils pour les détails.

🎯 Skills

Les Skills sont des capacités modulaires qui étendent votre Agent. Elles sont chargées depuis les fichiers SKILL.md dans votre workspace.

Installer des Skills depuis ClawHub :

picoclaw skills search "web scraping"
picoclaw skills install <skill-name>

Configurer le token ClawHub (optionnel, pour des limites de débit plus élevées) :

Ajoutez à votre config.json :

{
  "tools": {
    "skills": {
      "registries": {
        "clawhub": {
          "auth_token": "your-clawhub-token"
        }
      }
    }
  }
}

Pour plus de détails, voir Configuration des outils - Skills.

🔗 MCP (Model Context Protocol)

PicoClaw supporte nativement MCP — connectez n'importe quel serveur MCP pour étendre les capacités de votre Agent avec des outils et sources de données externes.

{
  "tools": {
    "mcp": {
      "enabled": true,
      "servers": {
        "filesystem": {
          "enabled": true,
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
        }
      }
    }
  }
}

Pour la configuration MCP complète (transports stdio, SSE, HTTP, Tool Discovery), voir Configuration des outils - MCP.

Rejoignez le réseau social des Agents

Connectez PicoClaw au réseau social des Agents simplement en envoyant un seul message via le CLI ou n'importe quelle application de chat intégrée.

Lisez https://clawdchat.ai/skill.md et suivez les instructions pour rejoindre ClawdChat.ai

🖥️ Référence CLI

⏰ Tâches planifiées / Rappels

PicoClaw supporte les rappels planifiés et les tâches récurrentes via l'outil cron :

• Rappels ponctuels : "Rappelle-moi dans 10 minutes" -> se déclenche une fois après 10 min
• Tâches récurrentes : "Rappelle-moi toutes les 2 heures" -> se déclenche toutes les 2 heures
• Expressions cron : "Rappelle-moi à 9h chaque jour" -> utilise une expression cron

📚 Documentation

Pour des guides détaillés au-delà de ce README :

🤝 Contribuer & Roadmap

Les PRs sont les bienvenues ! Le code source est intentionnellement petit et lisible.

Consultez notre Roadmap communautaire et CONTRIBUTING.md pour les directives.

Groupe de développeurs en construction, rejoignez-le après votre première PR fusionnée !

Groupes d'utilisateurs :

Discord : https://discord.gg/V4sAZ9XWpN

WeChat :