lzh/picoclaw
1
0
Fork 0
mirror of https://github.com/sipeed/picoclaw.git synced 2026-06-12 18:08:54 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
c48954d32d78ae25551e63aca0479e2c25ddbda3
picoclaw/README.fr.md
T
Administrator f7f27e237a merge: resolve conflicts between refactor/agent and main
2026-03-22 19:21:58 +08:00

34 KiB
Raw Blame History

PicoClaw

PicoClaw : Assistant IA Ultra-Efficace en Go

Matériel à $10 · <10 Mo de RAM · Démarrage en <1s · 皮皮虾，我们走！

Go Hardware License
Website Docs Wiki
Twitter Discord

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

PicoClaw est un projet open-source indépendant initié par Sipeed. Il est entièrement écrit en Go — 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, entièrement réécrit en Go via un processus d'auto-amorçage (self-bootstrapping) — où l'agent IA lui-même a piloté l'intégralité de la migration architecturale et de l'optimisation du code.

⚡️ Extrêmement léger : Fonctionne sur du matériel à seulement $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

🚨 SÉCURITÉ & CANAUX OFFICIELS

  • PAS DE CRYPTO : PicoClaw n'a AUCUN token/jeton officiel. Toute annonce 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/... sont enregistrés par des tiers.

  • Attention : PicoClaw est en phase de développement précoce et peut présenter des problèmes de sécurité réseau non résolus. Ne déployez pas en environnement de production avant la version v1.0.

  • Note : PicoClaw a récemment fusionné de nombreuses PR, ce qui peut entraîner une empreinte mémoire plus importante (10–20 Mo) dans les dernières versions. Nous prévoyons de prioriser l'optimisation des ressources dès que l'ensemble des fonctionnalités sera stabilisé.

📢 Actualités

2026-03-17 🚀 v0.2.3 publié ! Interface système tray (Windows & Linux), suivi de statut des sous-agents (spawn_status), rechargement à chaud expérimental du gateway, portes de sécurité cron, et 2 correctifs de sécurité. PicoClaw atteint 25K ⭐ !

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

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

2026-02-26 🎉 PicoClaw a atteint 20K étoiles en seulement 17 jours ! L'orchestration automatique des canaux et les interfaces de capacités sont arrivées.

Actualités précédentes...

2026-02-16 🎉 PicoClaw a atteint 12K étoiles en une semaine ! Les rôles de mainteneurs communautaires et la feuille de route sont officiellement publiés.

2026-02-13 🎉 PicoClaw a atteint 5000 étoiles en 4 jours ! La Feuille de Route du Projet et le Groupe de Développeurs sont en cours de mise en place.

2026-02-09 🎉 PicoClaw est lancé ! Construit en 1 jour pour apporter les Agents IA au matériel à $10 avec <10 Mo de RAM. 🦐 PicoClaw, c'est parti !

✨ Fonctionnalités

🪶 Ultra-Léger : Empreinte mémoire <10 Mo — 99% plus petit que les fonctionnalités essentielles d'OpenClaw.*

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

⚡️ Démarrage Éclair : Temps de démarrage 400X plus rapide, boot en <1 seconde même sur un cœur unique à 0,6 GHz.

🌍 Véritable Portabilité : Un seul binaire autonome pour RISC-V, ARM, MIPS et x86. Un clic et c'est parti !

🤖 Auto-Construit par l'IA : Implémentation native en Go de manière autonome — 95% du cœur généré par l'Agent avec affinement humain dans la 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 de Vision : Envoyez des images et fichiers directement à l'agent — encodage base64 automatique pour les LLM 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 versions récentes peuvent utiliser 10–20 Mo en raison des fusions rapides de fonctionnalités. L'optimisation des ressources est prévue. La comparaison de démarrage est basée sur des benchmarks à cœur unique 0,8 GHz (voir tableau ci-dessous).

OpenClaw NanoBot PicoClaw
Langage TypeScript Python Go
RAM >1 Go >100 Mo < 10 Mo*
Démarrage
(cœur 0,8 GHz)		 >500s >30s <1s
Coût Mac Mini $599 La plupart des SBC Linux
~$50		 N'importe quelle carte Linux
À partir de $10
PicoClaw

📋 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

🧩 Ingénieur Full-Stack

🗂️ Gestion des Logs & Planification

🔎 Recherche Web & Apprentissage

Développer • Déployer • Mettre à l'échelle Planifier • Automatiser • Mémoriser Découvrir • Analyser • Tendances

📱 Utiliser sur d'anciens téléphones Android

Donnez une seconde vie à votre téléphone d'il y a dix ans ! Transformez-le en assistant IA intelligent avec PicoClaw. Démarrage rapide :

  1. Installez Termux (Téléchargez depuis GitHub Releases, ou recherchez sur F-Droid / Google Play).
  2. Exécutez les commandes
# Téléchargez la dernière version depuis https://github.com/sipeed/picoclaw/releases
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 disposition standard du système de fichiers Linux

Puis suivez les instructions de la section « Démarrage Rapide » pour terminer la configuration !

PicoClaw

🐜 Déploiement Innovant à Faible Empreinte

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

  • 9,9$ LicheeRV-Nano version E (Ethernet) ou W (WiFi6), pour un Assistant Domotique Minimaliste
  • 30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), ou 100 NanoKVM-Pro pour la Maintenance Automatisée de Serveurs
  • 50$ MaixCAM ou 100$ MaixCAM2 pour la Surveillance Intelligente

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

🌟 Encore plus de scénarios 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 propose 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)

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

cd picoclaw
make deps

# Compiler, pas besoin d'installer
make build

# Compiler pour plusieurs plateformes
make build-all

# Compiler pour Raspberry Pi Zero 2 W (32-bit : make build-linux-arm ; 64-bit : 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-bit → make build-linux-arm ; 64-bit → make build-linux-arm64. Ou exécutez make build-pi-zero pour compiler les deux.

📚 Documentation

Pour des guides détaillés, consultez la documentation ci-dessous. Ce README ne couvre que le démarrage rapide.

Sujet Description
🐳 Docker & Démarrage Rapide Configuration Docker Compose, modes Launcher/Agent, configuration rapide
💬 Applications de Chat Telegram, Discord, WhatsApp, Matrix, QQ, Slack, IRC, DingTalk, LINE, Feishu, WeCom, et plus
⚙️ Configuration Variables d'environnement, structure du workspace, sources de compétences, bac à sable de sécurité, heartbeat
🔌 Fournisseurs & Modèles 20+ fournisseurs LLM, routage de modèles, configuration model_list, architecture des fournisseurs
🔄 Spawn & Tâches Asynchrones Tâches rapides, tâches longues avec spawn, orchestration asynchrone de sous-agents
🐛 Dépannage Problèmes courants et solutions
🔧 Configuration des Outils Activation/désactivation par outil, politiques exec
📋 Compatibilité Matérielle Cartes testées, exigences minimales, comment ajouter votre carte

ClawdChat Rejoignez le Réseau Social d'Agents

Connectez PicoClaw au Réseau Social d'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

<<<<<<< HEAD

🖥️ Référence CLI

Commande Description
picoclaw onboard Initialiser la config & le workspace
picoclaw agent -m "..." Discuter avec l'agent
picoclaw agent Mode chat interactif
picoclaw gateway Démarrer le gateway
picoclaw status Afficher le statut
picoclaw version Afficher les infos de version
picoclaw cron list Lister les tâches planifiées
picoclaw cron add ... Ajouter une tâche planifiée
picoclaw cron disable Désactiver une tâche planifiée
picoclaw cron remove Supprimer une tâche planifiée
picoclaw skills list Lister les compétences installées
picoclaw skills install Installer une compétence
picoclaw migrate Migrer les données des anciennes versions
picoclaw auth login S'authentifier auprès des fournisseurs
picoclaw model Voir ou changer le modèle par défaut

=======

⚙️ Configuration

Fichier de configuration : ~/.picoclaw/config.json

Variables d'Environnement

Vous pouvez remplacer les chemins par défaut à l'aide de variables d'environnement. Ceci est utile pour les installations portables, les déploiements conteneurisés ou l'exécution de picoclaw en tant que service système. Ces variables sont indépendantes et contrôlent différents chemins.

Variable Description Chemin par Défaut
PICOCLAW_CONFIG Remplace le chemin du fichier de configuration. Cela indique directement à picoclaw quel config.json charger, en ignorant tous les autres emplacements. ~/.picoclaw/config.json
PICOCLAW_HOME Remplace le répertoire racine des données picoclaw. Cela modifie l'emplacement par défaut du workspace et des autres répertoires de données. ~/.picoclaw

Exemples :

# Exécuter picoclaw en utilisant un fichier de configuration spécifique
# Le chemin du workspace sera lu à partir de ce fichier de configuration
PICOCLAW_CONFIG=/etc/picoclaw/production.json picoclaw gateway

# Exécuter picoclaw avec toutes ses données stockées dans /opt/picoclaw
# La configuration sera chargée à partir du fichier par défaut ~/.picoclaw/config.json
# Le workspace sera créé dans /opt/picoclaw/workspace
PICOCLAW_HOME=/opt/picoclaw picoclaw agent

# Utiliser les deux pour une configuration entièrement personnalisée
PICOCLAW_HOME=/srv/picoclaw PICOCLAW_CONFIG=/srv/picoclaw/main.json picoclaw gateway

Structure du Workspace

PicoClaw stocke les données dans votre workspace configuré (par défaut : ~/.picoclaw/workspace) :

~/.picoclaw/workspace/
├── sessions/          # Sessions de conversation et historique
├── memory/           # Mémoire à long terme (MEMORY.md)
├── state/            # État persistant (dernier canal, etc.)
├── cron/             # Base de données des tâches planifiées
├── skills/           # Compétences personnalisées
├── AGENT.md          # Définition structurée de l'agent et prompt système
├── HEARTBEAT.md      # Invites de tâches périodiques (vérifiées toutes les 30 min)
├── SOUL.md           # Âme de l'Agent
└── ...

🔒 Bac à Sable de Sécurité

PicoClaw s'exécute dans un environnement sandboxé par défaut. L'agent ne peut accéder aux fichiers et exécuter des commandes qu'au sein du workspace configuré.

Configuration par Défaut

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "restrict_to_workspace": true
    }
  }
}
Option Par défaut Description
workspace ~/.picoclaw/workspace Répertoire de travail de l'agent
restrict_to_workspace true Restreindre l'accès fichiers/commandes au workspace

Outils Protégés

Lorsque restrict_to_workspace: true, les outils suivants sont restreints au bac à sable :

Outil Fonction Restriction
read_file Lire des fichiers Uniquement les fichiers dans le workspace
write_file Écrire des fichiers Uniquement les fichiers dans le workspace
list_dir Lister des répertoires Uniquement les répertoires dans le workspace
edit_file Éditer des fichiers Uniquement les fichiers dans le workspace
append_file Ajouter à des fichiers Uniquement les fichiers dans le workspace
exec Exécuter des commandes Les chemins doivent être dans le workspace

Protection Supplémentaire d'Exec

Même avec restrict_to_workspace: false, l'outil exec bloque ces commandes dangereuses :

  • rm -rf, del /f, rmdir /s — Suppression en masse
  • format, mkfs, diskpart — Formatage de disque
  • dd if= — Écriture d'image disque
  • Écriture vers /dev/sd[a-z] — Écriture directe sur le disque
  • shutdown, reboot, poweroff — Arrêt du système
  • Fork bomb :(){ :|:& };:

Exemples d'Erreurs

[ERROR] tool: Tool execution failed
{tool=exec, error=Command blocked by safety guard (path outside working dir)}

[ERROR] tool: Tool execution failed
{tool=exec, error=Command blocked by safety guard (dangerous pattern detected)}

Désactiver les Restrictions (Risque de Sécurité)

Si vous avez besoin que l'agent accède à des chemins en dehors du workspace :

Méthode 1 : Fichier de configuration

{
  "agents": {
    "defaults": {
      "restrict_to_workspace": false
    }
  }
}

Méthode 2 : Variable d'environnement

export PICOCLAW_AGENTS_DEFAULTS_RESTRICT_TO_WORKSPACE=false

⚠️ Attention : Désactiver cette restriction permet à l'agent d'accéder à n'importe quel chemin sur votre système. À utiliser avec précaution uniquement dans des environnements contrôlés.

Cohérence du Périmètre de Sécurité

Le paramètre restrict_to_workspace s'applique de manière cohérente sur tous les chemins d'exécution :

Chemin d'Exécution Périmètre de Sécurité
Agent Principal restrict_to_workspace ✅
Sous-agent / Spawn Hérite de la même restriction ✅
Tâches Heartbeat Hérite de la même restriction ✅

Tous les chemins partagent la même restriction de workspace — il est impossible de contourner le périmètre de sécurité via des sous-agents ou des tâches planifiées.

Heartbeat (Tâches Périodiques)

PicoClaw peut exécuter des tâches périodiques automatiquement. Créez un fichier HEARTBEAT.md dans votre workspace :

# Tâches Périodiques

- Vérifier mes e-mails pour les messages importants
- Consulter mon agenda pour les événements à venir
- Vérifier les prévisions météo

L'agent lira ce fichier toutes les 30 minutes (configurable) et exécutera les tâches à l'aide des outils disponibles.

Tâches Asynchrones avec Spawn

Pour les tâches de longue durée (recherche web, appels API), utilisez l'outil spawn pour créer un sous-agent :

# Tâches Périodiques

## Tâches Rapides (réponse directe)
- Indiquer l'heure actuelle

## Tâches Longues (utiliser spawn pour l'asynchrone)
- Rechercher les actualités IA sur le web et les résumer
- Vérifier les e-mails et signaler les messages importants

Comportements clés :

Fonctionnalité Description
spawn Crée un sous-agent asynchrone, ne bloque pas le heartbeat
Contexte indépendant Le sous-agent a son propre contexte, sans historique de session
Outil message Le sous-agent communique directement avec l'utilisateur via l'outil message
Non-bloquant Après le spawn, le heartbeat continue vers la tâche suivante

Fonctionnement de la Communication du Sous-agent

Le Heartbeat se déclenche
    ↓
L'Agent lit HEARTBEAT.md
    ↓
Pour une tâche longue : spawn d'un sous-agent
    ↓                           ↓
Continue la tâche suivante   Le sous-agent travaille indépendamment
    ↓                           ↓
Toutes les tâches terminées  Le sous-agent utilise l'outil "message"
    ↓                           ↓
Répond HEARTBEAT_OK          L'utilisateur reçoit le résultat directement

Le sous-agent a accès aux outils (message, web_search, etc.) et peut communiquer avec l'utilisateur indépendamment sans passer par l'agent principal.

Configuration :

{
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}
Option Par défaut Description
enabled true Activer/désactiver le heartbeat
interval 30 Intervalle de vérification en minutes (min : 5)

Variables d'environnement :

  • PICOCLAW_HEARTBEAT_ENABLED=false pour désactiver
  • PICOCLAW_HEARTBEAT_INTERVAL=60 pour modifier l'intervalle

Fournisseurs

Note

Groq fournit la transcription vocale gratuite via Whisper. Si configuré, les messages audio de n'importe quel canal seront automatiquement transcrits au niveau de l'agent.

Fournisseur Utilisation Obtenir une Clé API
gemini LLM (Gemini direct) aistudio.google.com
zhipu LLM (Zhipu direct) bigmodel.cn
volcengine LLM(Volcengine direct) volcengine.com
openrouter (À tester) LLM (recommandé, accès à tous les modèles) openrouter.ai
anthropic (À tester) LLM (Claude direct) console.anthropic.com
openai (À tester) LLM (GPT direct) platform.openai.com
deepseek (À tester) LLM (DeepSeek direct) platform.deepseek.com
qwen LLM (Alibaba Qwen) dashscope.aliyuncs.com
cerebras LLM (Cerebras) cerebras.ai
groq LLM + Transcription vocale (Whisper) console.groq.com
Configuration Zhipu

1. Obtenir la clé API

2. Configurer

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "glm-4.7",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "zhipu": {
      "api_key": "Votre Clé API",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  }
}

3. Lancer

picoclaw agent -m "Bonjour, comment ça va ?"
Exemple de configuration complète 
{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx"
    },
    "groq": {
      "api_key": "gsk_xxx"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456:ABC...",
      "allow_from": ["123456789"]
    },
    "discord": {
      "enabled": true,
      "token": "",
      "allow_from": [""]
    },
    "whatsapp": {
      "enabled": false
    },
    "feishu": {
      "enabled": false,
      "app_id": "cli_xxx",
      "app_secret": "xxx",
      "encrypt_key": "",
      "verification_token": "",
      "allow_from": []
    },
    "qq": {
      "enabled": false,
      "app_id": "",
      "app_secret": "",
      "allow_from": []
    }
  },
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "BSA...",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    },
    "cron": {
      "exec_timeout_minutes": 5
    }
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

Configuration de Modèle (model_list)

Nouveau ! PicoClaw utilise désormais une approche de configuration centrée sur le modèle. Spécifiez simplement le format fournisseur/modèle (par exemple, zhipu/glm-4.7) pour ajouter de nouveaux fournisseurs—aucune modification de code requise !

Cette conception permet également le support multi-agent avec une sélection flexible de fournisseurs :

  • Différents agents, différents fournisseurs : Chaque agent peut utiliser son propre fournisseur LLM
  • Modèles de secours (Fallbacks) : Configurez des modèles primaires et de secours pour la résilience
  • Équilibrage de charge : Répartissez les requêtes sur plusieurs points de terminaison
  • Configuration centralisée : Gérez tous les fournisseurs en un seul endroit

📋 Tous les Fournisseurs Supportés

Fournisseur Préfixe model API Base par Défaut Protocole Clé API
OpenAI openai/ https://api.openai.com/v1 OpenAI Obtenir Clé
Anthropic anthropic/ https://api.anthropic.com/v1 Anthropic Obtenir Clé
Zhipu AI (GLM) zhipu/ https://open.bigmodel.cn/api/paas/v4 OpenAI Obtenir Clé
DeepSeek deepseek/ https://api.deepseek.com/v1 OpenAI Obtenir Clé
Google Gemini gemini/ https://generativelanguage.googleapis.com/v1beta OpenAI Obtenir Clé
Groq groq/ https://api.groq.com/openai/v1 OpenAI Obtenir Clé
Moonshot moonshot/ https://api.moonshot.cn/v1 OpenAI Obtenir Clé
Qwen (Alibaba) qwen/ https://dashscope.aliyuncs.com/compatible-mode/v1 OpenAI Obtenir Clé
NVIDIA nvidia/ https://integrate.api.nvidia.com/v1 OpenAI Obtenir Clé
Ollama ollama/ http://localhost:11434/v1 OpenAI Local (pas de clé nécessaire)
OpenRouter openrouter/ https://openrouter.ai/api/v1 OpenAI Obtenir Clé
VLLM vllm/ http://localhost:8000/v1 OpenAI Local
Cerebras cerebras/ https://api.cerebras.ai/v1 OpenAI Obtenir Clé
VolcEngine (Doubao) volcengine/ https://ark.cn-beijing.volces.com/api/v3 OpenAI Obtenir Clé
ShengsuanYun shengsuanyun/ https://router.shengsuanyun.com/api/v1 OpenAI -
BytePlus byteplus/ https://ark.ap-southeast.bytepluses.com/api/v3 OpenAI Obtenir Clé
LongCat longcat/ https://api.longcat.chat/openai OpenAI Obtenir une clé
ModelScope (魔搭) modelscope/ https://api-inference.modelscope.cn/v1 OpenAI Obtenir un Token
Antigravity antigravity/ Google Cloud Custom OAuth uniquement
GitHub Copilot github-copilot/ localhost:4321 gRPC -

Configuration de Base

{
  "model_list": [
    {
      "model_name": "ark-code-latest",
      "model": "volcengine/ark-code-latest",
      "api_key": "sk-your-api-key"
    },
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "sk-your-openai-key"
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "sk-ant-your-key"
    },
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-zhipu-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gpt-5.4"
    }
  }
}

Exemples par Fournisseur

OpenAI

{
  "model_name": "gpt-5.4",
  "model": "openai/gpt-5.4",
  "api_key": "sk-..."
}

VolcEngine (Doubao)

{
  "model_name": "ark-code-latest",
  "model": "volcengine/ark-code-latest",
  "api_key": "sk-..."
}

Zhipu AI (GLM)

{
  "model_name": "glm-4.7",
  "model": "zhipu/glm-4.7",
  "api_key": "your-key"
}

Anthropic (avec OAuth)

{
  "model_name": "claude-sonnet-4.6",
  "model": "anthropic/claude-sonnet-4.6",
  "auth_method": "oauth"
}

Exécutez picoclaw auth login --provider anthropic pour configurer les identifiants OAuth.

Proxy/API personnalisée

{
  "model_name": "my-custom-model",
  "model": "openai/custom-model",
  "api_base": "https://my-proxy.com/v1",
  "api_key": "sk-...",
  "request_timeout": 300
}

Équilibrage de Charge

Configurez plusieurs points de terminaison pour le même nom de modèle—PicoClaw utilisera automatiquement le round-robin entre eux :

{
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_base": "https://api1.example.com/v1",
      "api_key": "sk-key1"
    },
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_base": "https://api2.example.com/v1",
      "api_key": "sk-key2"
    }
  ]
}

Migration depuis l'Ancienne Configuration providers

L'ancienne configuration providers est dépréciée mais toujours supportée pour la rétrocompatibilité.

Ancienne Configuration (dépréciée) :

{
  "providers": {
    "zhipu": {
      "api_key": "your-key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  },
  "agents": {
    "defaults": {
      "provider": "zhipu",
      "model": "glm-4.7"
    }
  }
}

Nouvelle Configuration (recommandée) :

{
  "model_list": [
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "glm-4.7"
    }
  }
}

Pour le guide de migration détaillé, voir docs/migration/model-list-migration.md.

Référence CLI

Commande Description
picoclaw onboard Initialiser la configuration & le workspace
picoclaw agent -m "..." Discuter avec l'agent
picoclaw agent Mode de discussion interactif
picoclaw gateway Démarrer la passerelle
picoclaw status Afficher le statut
picoclaw cron list Lister toutes les tâches planifiées
picoclaw cron add ... Ajouter une tâche planifiée

refactor/agent

Tâches Planifiées / Rappels

PicoClaw prend en charge 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

🤝 Contribuer & Feuille de Route

Les PR sont les bienvenues ! Le code est intentionnellement petit et lisible. 🤗

Consultez notre Feuille de Route Communautaire complète.

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

Groupes d'utilisateurs :

discord : https://discord.gg/V4sAZ9XWpN

PicoClaw
Reference in New Issue View Git Blame Copy Permalink