Guide d'installation et de configuration de PicoClaw : déployez votre assistant IA personnel en trois étapes

10 min de lecture

Des prérequis système à la configuration des bots multiplateformes, en passant par le déploiement Docker et la gestion des tâches planifiées, ce guide complet couvre tous les scénarios d'utilisation de PicoClaw.

Prérequis système

PicoClaw a des exigences matérielles très faibles :

  • Système d'exploitation : Linux / macOS / Windows (WSL2)
  • Architecture : x86_64 / ARM64 / RISC-V
  • Mémoire minimale : 64 Mo (512 Mo ou plus recommandés)
  • Dépendances : Clé API LLM (indispensable pour les conversations IA)

Plateformes supportées : macOS, Linux, Windows (WSL2), Raspberry Pi, Docker

Étape 1 : Cloner le dépôt de code

Ouvrez votre terminal et exécutez la commande suivante :

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

Une fois le clonage terminé, accédez au répertoire du projet :

bash
cd picoclaw

Étape 2 : Initialisation de la configuration

Exécutez la commande onboard pour initialiser le système :

bash
picoclaw onboard

Suivez les instructions pour terminer la configuration :

  1. Clé API LLM : Saisissez la clé API de votre fournisseur LLM.
  2. Préférences de modèle : Choisissez le modèle d'IA à utiliser par défaut.
  3. Jeton (Token) de messagerie (optionnel) : Pour activer l'intégration avec Telegram, Discord, QQ ou DingTalk, saisissez les jetons de bot correspondants.

Le fichier de configuration est enregistré localement ; toutes vos données restent sur votre appareil et ne sont jamais envoyées dans le cloud.

Étape 3 : Lancer la conversation

Une fois la configuration terminée, vous pouvez commencer à discuter avec l'IA.

Mode interactif

bash
picoclaw agent

Lance l'interface de conversation interactive pour envoyer des messages et recevoir des réponses en continu.

Mode requête unique

bash
picoclaw agent -m "Bonjour, peux-tu te présenter ?"

Envoie un message unique et quitte après avoir reçu la réponse, idéal pour une utilisation dans des scripts.

Lancer le service passerelle (Gateway)

Pour une utilisation sur des plateformes comme Telegram ou QQ :

bash
picoclaw gateway

Une fois lancé, vous pouvez interagir avec PicoClaw via les bots de vos plateformes préférées.

Configuration des bots multiplateformes

Telegram Bot

Sur Telegram, contactez @BotFather, envoyez /newbot pour créer votre bot et obtenir un jeton. Insérez ce jeton dans votre fichier de configuration, puis lancez picoclaw gateway.

Discord Bot

Créez une application sur le portail développeur Discord, récupérez le jeton dans les paramètres du bot, invitez le bot sur votre serveur et ajoutez le jeton à votre configuration.

QQ Bot

Référez-vous à la documentation de la plateforme ouverte QQ pour enregistrer un bot, obtenir l'AppID et le jeton, puis renseignez-les dans le fichier de configuration.

DingTalk Bot

Créez une application robot sur la plateforme ouverte DingTalk, récupérez l'URL Webhook et la clé secrète, puis ajoutez-les à votre configuration.

Déploiement Docker

PicoClaw supporte le déploiement via Docker, idéal pour les serveurs ou les environnements sans interface graphique :

bash
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d   --name picoclaw   -v /path/to/config:/config   -e PICOCLAW_API_KEY=your_key   ghcr.io/sipeed/picoclaw:latest

Configuration des tâches planifiées

PicoClaw intègre un support cron, géré via le fichier de configuration.

Rappel unique

yaml
tasks:  - type: reminder    time: "1h"    message: "Rappel de réunion : réunion d'équipe hebdomadaire"

Tâches périodiques

yaml
tasks:  - type: cron    schedule: "0 8 * * *"    message: "Générer le résumé de travail du jour"

Foire aux questions

PicoClaw nécessite-t-il une connexion Internet ?

PicoClaw peut fonctionner hors ligne, mais l'appel aux API LLM et l'intégration aux plateformes de messagerie nécessitent une connexion Internet.

Quels fournisseurs LLM sont supportés ?

Il supporte OpenRouter, Zhipu AI, Anthropic, OpenAI, DeepSeek, Groq, etc., interchangeables via le fichier de configuration.

Comment mettre à jour PicoClaw ?

Accédez au répertoire du projet, exécutez git pull pour récupérer le code le plus récent, puis recompilez.

Où sont stockées les données ?

Tous les historiques de conversation et les fichiers de configuration sont stockés sur votre système de fichiers local, sous votre contrôle total.

Quelle est la taille de l'image Docker ?

L'image Docker de PicoClaw pèse environ 15 Mo, bien moins que les 350 Mo+ des solutions concurrentes.

Est-ce compatible avec Raspberry Pi ?

Oui, PicoClaw supporte l'architecture ARM64. Un Raspberry Pi 4 (4 Go+) suffit pour une exécution fluide.

Comment configurer plusieurs bots simultanément ?

Ajoutez simplement les jetons et les configurations de chaque plateforme dans votre fichier de configuration, puis lancez picoclaw gateway pour activer tous les bots en même temps.