Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

Aide en ligne de commande pour zeroclaw

Ce document contient le contenu d’aide pour le programme en ligne de commande zeroclaw.

Aperçu de la commande :

zeroclaw

L’assistant IA le plus rapide et le plus léger.

Utilisation : zeroclaw [OPTIONS] <COMMAND>

Sous-commandes :

  • quickstart — Démarrage rapide — créez un agent fonctionnel de bout en bout. Remplace le flux d’intégration section par section par un parcours unique piloté par des préréglages. Interactif : les indicateurs ci-dessous préremplissent les sélecteurs de la liste de contrôle mais ne les ignorent pas ; un terminal est requis
  • onboard — Obsolète. Utilisez zeroclaw quickstart. Tout indicateur provoque une erreur
  • agent — Démarrer la boucle de l’agent IA
  • gateway — Démarrer/gérer le serveur gateway (webhooks, websockets)
  • acp — Démarrer le serveur ACP (Agent Control Protocol) via stdio
  • daemon — Démarrer un runtime autonome à long terme (passerelle + canaux + battement de cœur + planificateur)
  • service — Gérer le cycle de vie du service OS (service utilisateur launchd/systemd)
  • doctor — Exécuter des diagnostics pour la fraîcheur du daemon/planificateur/chaîne
  • status — Afficher l’état du système (détails complets)
  • estop —
  • cron — Configurer et gérer les tâches planifiées
  • models — Gérer les catalogues de modèles model_provider
  • providers — CRUD d’alias pour les fournisseurs ([providers.<category>.<family>.<alias>]). category est l’une des valeurs suivantes : models, tts, transcription
  • channel — Gérer les canaux (Telegram, Discord, Slack)
  • agents — Gérer les alias d’agents (créer/lister/renommer/supprimer). À distinguer de agent, qui exécute un agent
  • channels — Gérer les alias de canaux (créer/lister/renommer/supprimer)
  • integrations — Parcourez plus de 50 intégrations
  • skills — Gérer les compétences (capacités définies par l’utilisateur)
  • browse — Parcourir l’espace de travail partagé un répertoire à la fois
  • sop — Gérer les procédures opérationnelles standard (SOP)
  • migrate — Migrer les données depuis d’autres runtimes d’agents
  • auth — Gérer les profils d’authentification d’abonnement model_provider
  • hardware — Découvrir et analyser le matériel USB
  • peripheral — Gérer les périphériques matériels (STM32, GPIO RPi, etc.)
  • memory — Gérer la mémoire de l’agent (list, get, stats, clear)
  • config — Gérer la configuration
  • update — Vérifier et appliquer les mises à jour
  • self-test — Exécuter des tests d’automodiagnostic
  • completions — Générer le script de complétion de shell vers stdout
  • desktop — Lancer l’application de bureau associée, ou ouvrir sa page de téléchargement
  • locales — Récupère les fichiers de langue traduits (FTL) depuis le dépôt amont

Options :

  • --config-dir <CONFIG_DIR>

  • --log-level <LOG_LEVEL> — Sévérité minimale enregistrée dans la trace d’exécution (et la couche de capture). Immuable pour le processus. Priorité : ce flag > variable d’environnement RUST_LOG > valeur par défaut par commande

    Valeurs possibles : error, warn, info, debug, trace

  • -v, --verbose — Affiche les journaux enregistrés dans le terminal. Désactivé par défaut : les journaux sont écrits uniquement dans le fichier de trace et le terminal n’affiche que la sortie des commandes. Lorsqu’il est activé, le terminal affiche les événements jusqu’au niveau plancher enregistré. Immuable pour le processus

zeroclaw quickstart

Démarrage rapide — créez un agent fonctionnel de bout en bout. Remplace le flux d’intégration section par section par un parcours unique piloté par des préréglages. Interactif : les options ci-dessous pré-remplissent les sélecteurs de la checklist mais ne les ignorent pas ; un terminal est requis

Utilisation : zeroclaw quickstart [OPTIONS]

Options :

  • --model-provider <MODEL_PROVIDER> — Type de fournisseur (anthropic / openai / openrouter / ollama)
  • --model <MODEL> — Identifiant du modèle pour la nouvelle entrée de fournisseur
  • --api-key <API_KEY> — Clé API pour la nouvelle entrée de fournisseur (à omettre pour ollama / local)
  • --agent <AGENT> — Alias pour le nouvel agent. Par défaut, un nom de fournisseur normalisé

zeroclaw onboard

Obsolète. Utilisez zeroclaw quickstart. Toute option provoque une erreur

Utilisation : zeroclaw onboard [COMMAND]

Sous-commandes :

  • providers.models — Choisissez un fournisseur de modèles à configurer (Anthropic, OpenAI, OpenRouter, Ollama, passerelles personnalisées compatibles OpenAI, etc.). Plusieurs alias par fournisseur sont pris en charge — par exemple, anthropic.production et anthropic.dev peuvent coexister
  • model_routes — Indices de routage de modèles nommés (p. ex. reasoning, fast, code). Chaque route associe un indice à une combinaison spécifique fournisseur + modèle. Utilisez hint:<name> comme paramètre de modèle pour dispatcher via une route
  • embedding_routes — Indices de routage d’embedding nommés (p. ex. semantic, archive, faq). Chaque route associe un indice à une combinaison fournisseur + modèle capable d’embedding. Utilisez hint:<name> comme paramètre embedding_model
  • risk_profiles — Profils de risque nommés associant les listes d’autorisation, les listes de blocage et les seuils d’approbation. Les agents en référencent un via agents.<alias>.risk_profile
  • runtime_profiles — Profils nommés de réglage d’exécution (limites de tokens, politique de nouvelles tentatives, délais d’expiration). Les agents en référencent un via agents.<alias>.runtime_profile
  • storage — SQLite est le choix sûr par défaut pour les installations à nœud unique (basé sur fichiers, zéro configuration, aucun service supplémentaire). Choisissez Postgres pour les déploiements partagés ou multi-instances, Qdrant pour la recherche vectorielle, Markdown ou Lucid pour des fichiers lisibles par l’humain. Chaque backend prend en charge plusieurs instances avec alias ; les agents les référencent via memory.storage_ref
  • memory — Backend de mémoire persistante. SQLite est la valeur par défaut ; choisissez none pour désactiver entièrement la mémoire à long terme
  • skills — Paramètres de l’outil Skills — emplacement des fichiers markdown des skills sur le disque (par défaut, le répertoire de données), et comment le chargeur de skills gère les dépôts communautaires. Ajoutez des BUNDLES de skills sous skill-bundles ci-dessous
  • skill_bundles — Ensembles nommés de fichiers de compétences. Les agents référencent un ensemble pour charger un groupe de capacités au démarrage
  • mcp — Paramètres du Model Context Protocol. Activez/désactivez enabled et choisissez le chargement différé ou immédiat. Les serveurs MCP individuels se trouvent sous mcp.servers[]
  • mcp.servers — Serveurs Model Context Protocol individuels. Chaque entrée associe un transport (stdio, http, sse), la commande ou l’URL pour l’atteindre, des en-têtes optionnels et une limite tool_timeout_secs (≤ 600). Le name de chaque serveur est sa clé adressable — renommez-le via la page de section plutôt qu’en modifiant directement le champ. Regroupez les serveurs en bundles sous mcp_bundles ci-dessous
  • mcp_bundles — Bundles nommés de serveurs MCP, accordés aux agents qui listent le bundle dans leur mcp_bundles. Sécurisé par défaut : un agent n’obtient que les serveurs que ses bundles accordent ; sans bundle, il n’obtient aucun serveur MCP
  • knowledge_bundles — Lots nommés de sources de connaissances (index RAG, dossiers de documentation). Les agents référencent un lot pour faire remonter les extraits pertinents au moment de l’inférence
  • providers.tts — Fournisseurs de synthèse vocale (OpenAI, ElevenLabs, Google, Edge, Piper). Configurez-en un par voix / langue ; les agents les référencent par alias
  • providers.transcription — Fournisseurs de reconnaissance vocale (OpenAI Whisper, Groq, Deepgram, AssemblyAI, Google, Whisper local). Configurez-en un par pipeline ; les agents y font référence par alias
  • channels — Choisissez les plateformes de chat sur lesquelles ZeroClaw doit écouter. Les paramètres globaux des canaux se trouvent dans [channels] ; chaque plateforme configurée obtient toujours son propre alias
  • hardware — Optionnel : périphériques matériels (Arduino, STM32, GPIO, etc.). Ignorez si vous n’en avez pas besoin
  • agents — Un agent associe un fournisseur de modèle, des profils, des bundles et des canaux en une seule unité distribuable. Ajoutez-en un par persona ; réutilisez le même alias entre les canaux pour partager l’état
  • peer_groups — Groupes nommés liant un canal, des agents membres et des pairs externes. Adhésion mutuelle : deux agents deviennent pairs uniquement lorsque les deux figurent dans la liste agents du même groupe
  • cron — Tâches planifiées. Chaque entrée cron associe une expression de planification à une invite, un canal et une cible
  • tunnel — Optionnel : expose votre passerelle sur Internet via Cloudflare ou ngrok. Choisissez none pour la garder uniquement en localhost
  • onboard_state — État du cycle de vie du Quickstart. quickstart_completed passe à true une fois que le Quickstart termine une exécution réussie ; tant qu’il est à false, la passerelle web et la TUI lancent automatiquement le Quickstart au démarrage. completed_sections est un registre par section hérité, conservé pour la rétrocompatibilité avec les données antérieures

zeroclaw onboard providers.models

Choisissez un fournisseur de modèle à configurer (Anthropic, OpenAI, OpenRouter, Ollama, passerelles personnalisées compatibles OpenAI, etc.). Plusieurs alias par fournisseur sont pris en charge — par exemple, anthropic.production et anthropic.dev peuvent coexister

Utilisation : zeroclaw onboard providers.models

zeroclaw onboard model_routes

Indications de routage de modèles nommés (par ex. raisonnement, rapide, code). Chaque route associe une indication à une combinaison spécifique de fournisseur + modèle. Utilisez hint:<name> comme paramètre de modèle pour acheminer via une route.

Utilisation : zeroclaw onboard model_routes

zeroclaw onboard embedding_routes

Indications de routage d’embeddings nommés (par ex. semantic, archive, faq). Chaque route associe une indication à une combinaison fournisseur + modèle capable de générer des embeddings. Utilisez hint:<name> comme paramètre embedding_model

Utilisation : zeroclaw onboard embedding_routes

zeroclaw onboard risk_profiles

Profils de risque nommés associant des listes d’autorisation, des listes de refus et des seuils d’approbation. Les agents en référencent un via agents.<alias>.risk_profile

Utilisation : zeroclaw onboard risk_profiles

zeroclaw onboard runtime_profiles

Profils de réglage d’exécution nommés (limites de tokens, politique de nouvelle tentative, délais d’expiration). Les agents en référencent un via agents.<alias>.runtime_profile

Utilisation : zeroclaw onboard runtime_profiles

zeroclaw onboard storage

SQLite est le choix par défaut sûr pour les installations à nœud unique (basé sur fichiers, zéro configuration, aucun service supplémentaire). Choisissez Postgres pour les déploiements partagés ou multi-instances, Qdrant pour la recherche vectorielle, Markdown ou Lucid pour des fichiers lisibles par l’humain. Chaque backend prend en charge plusieurs instances avec alias ; les agents y font référence via memory.storage_ref

Utilisation : zeroclaw onboard storage

zeroclaw onboard memory

Backend de mémoire persistante. SQLite est l’option par défaut ; sélectionnez none pour désactiver entièrement la mémoire à long terme

Usage : zeroclaw onboard memory

zeroclaw onboard skills

Paramètres de l’outil Skills — emplacement où les fichiers markdown des skills sont stockés sur le disque (par défaut dans le répertoire de données), et comment le chargeur de skills gère les dépôts communautaires. Ajoutez des BUNDLES de skills sous skill-bundles ci-dessous

Utilisation : zeroclaw onboard skills

zeroclaw onboard skill_bundles

Ensembles nommés de fichiers de compétences. Les agents référencent un ensemble pour charger un jeu de capacités au démarrage

Utilisation : zeroclaw onboard skill_bundles

zeroclaw onboard mcp

Paramètres du Model Context Protocol. Activez enabled et choisissez le chargement différé ou immédiat. Les serveurs MCP individuels se trouvent sous mcp.servers[]

Utilisation : zeroclaw onboard mcp

zeroclaw onboard mcp.servers

Serveurs Model Context Protocol individuels. Chaque entrée associe un transport (stdio, http, sse), la commande ou l’URL pour y accéder, des en-têtes facultatifs et une limite tool_timeout_secs (≤ 600). Le name de chaque serveur est sa clé d’adressage — renommez-le via la page de section plutôt qu’en modifiant directement le champ. Regroupez les serveurs en bundles sous mcp_bundles ci-dessous

Utilisation : zeroclaw onboard mcp.servers

zeroclaw onboard mcp_bundles

Groupes nommés de serveurs MCP, attribués aux agents qui listent ce groupe dans leur mcp_bundles. Sécurisé par défaut : un agent ne reçoit que les serveurs accordés par ses groupes ; en l’absence de groupe, il n’obtient aucun serveur MCP

Utilisation : zeroclaw onboard mcp_bundles

zeroclaw onboard knowledge_bundles

Ensembles nommés de sources de connaissances (index RAG, dossiers de documentation). Les agents référencent un ensemble pour faire remonter les extraits pertinents au moment de l’inférence

Utilisation : zeroclaw onboard knowledge_bundles

zeroclaw onboard providers.tts

Fournisseurs de synthèse vocale (OpenAI, ElevenLabs, Google, Edge, Piper). Configurez-en un par voix / langue ; les agents les référencent par alias

Utilisation : zeroclaw onboard providers.tts

zeroclaw onboard providers.transcription

Fournisseurs de reconnaissance vocale (OpenAI Whisper, Groq, Deepgram, AssemblyAI, Google, Whisper local). Configurez-en un par pipeline ; les agents y font référence par alias

Utilisation : zeroclaw onboard providers.transcription

zeroclaw onboard channels

Choisissez les plateformes de chat sur lesquelles ZeroClaw doit écouter. Les paramètres de canal globaux se trouvent dans [channels] ; chaque plateforme configurée dispose toujours de son propre alias

Utilisation : zeroclaw onboard channels

zeroclaw onboard hardware

Facultatif : périphériques matériels (Arduino, STM32, GPIO, etc.). Ignorez cette étape si vous n’en avez pas besoin

Utilisation : zeroclaw onboard hardware

zeroclaw onboard agents

Un agent associe un fournisseur de modèle, des profils, des bundles et des canaux en une seule unité distribuable. Ajoutez-en un par persona ; réutilisez le même alias entre les canaux pour partager l’état.

Usage : zeroclaw onboard agents

zeroclaw onboard peer_groups

Groupes nommés associant un canal, des agents membres et des pairs externes. Adhésion mutuelle : deux agents deviennent pairs uniquement lorsque les deux figurent dans la liste agents du même groupe

Utilisation : zeroclaw onboard peer_groups

zeroclaw onboard cron

Tâches planifiées. Chaque entrée cron associe une expression de planification à une invite, un canal et une cible

Utilisation : zeroclaw onboard cron

zeroclaw onboard tunnel

Facultatif : exposez votre passerelle sur l’internet public via Cloudflare ou ngrok. Choisissez none pour la conserver uniquement en localhost

Utilisation : zeroclaw onboard tunnel

zeroclaw onboard onboard_state

État du cycle de vie du Quickstart. quickstart_completed passe à true dès que le Quickstart termine une exécution réussie ; tant qu’il est à false, la passerelle web et la TUI lancent automatiquement le Quickstart au démarrage. completed_sections est un registre par section hérité, conservé pour la rétrocompatibilité avec les données antérieures

Utilisation : zeroclaw onboard onboard_state

zeroclaw agent

Démarrer la boucle de l’agent IA.

Lance une session de chat interactive avec le model_provider d’IA configuré. Utilisez –message pour des requêtes uniques sans entrer en mode interactif.

Exemples : zeroclaw agent -a assistant # session interactive zeroclaw agent -a assistant -m “Summarize today’s logs” # message unique zeroclaw agent -a assistant -p anthropic –model claude-sonnet-4-20250514 zeroclaw agent -a assistant –peripheral nucleo-f401re:/dev/ttyACM0

Utilisation : zeroclaw agent [OPTIONS] --agent <AGENT>

Options :

  • -a, --agent <AGENT> — Alias d’agent configuré sous lequel s’exécuter (doit correspondre à [agents.<alias>]). Obligatoire — il n’y a pas d’agent par défaut
  • -m, --message <MESSAGE> — Mode de message unique (ne pas entrer en mode interactif)
  • --session-state-file <SESSION_STATE_FILE> — Charger et enregistrer l’état de la session interactive dans ce fichier JSON
  • -p, --model-provider <MODEL_PROVIDER> — Fournisseur de modèle à utiliser (openrouter, anthropic, openai, openai-codex)
  • --model <MODEL> — Modèle à utiliser
  • -t, --temperature <TEMPERATURE> — Température (0.0 - 2.0, par défaut providers.models.<type>.<alias>.temperature)
  • --peripheral <PÉRIPHÉRIQUE> — Attacher un périphérique (carte:chemin, par exemple nucleo-f401re:/dev/ttyACM0)

zeroclaw gateway

Gérer le serveur de passerelle (webhooks, websockets).

Démarrer, redémarrer ou inspecter la passerelle HTTP/WebSocket qui accepte les événements webhook entrants et les connexions WebSocket.

Exemples : zeroclaw gateway start # démarrer la passerelle zeroclaw gateway restart # redémarrer la passerelle zeroclaw gateway get-paircode # afficher le code d’appariement

Utilisation : zeroclaw gateway [COMMAND]

Sous-commandes :

  • start — Démarrer le serveur de passerelle (par défaut si aucune sous-commande n’est spécifiée)
  • restart — Redémarrer le serveur de passerelle
  • get-paircode — Afficher ou générer le code d’appairage sans redémarrer

zeroclaw gateway start

Démarrer le serveur de passerelle (webhooks, websockets).

Exécute la passerelle HTTP/WebSocket qui accepte les événements webhook entrants et les connexions WebSocket. L’adresse de liaison par défaut correspond aux valeurs définies dans votre fichier de configuration (gateway.host / gateway.port).

Exemples : zeroclaw gateway start # utiliser les valeurs par défaut de la configuration zeroclaw gateway start -p 8080 # écouter sur le port 8080 zeroclaw gateway start –host 0.0.0.0 # nécessite [gateway].allow_public_bind=true ou un tunnel zeroclaw gateway start -p 0 # port aléatoire disponible

Utilisation : zeroclaw gateway start [OPTIONS]

Options :

  • -p, --port <PORT> — Port d’écoute (utilisez 0 pour un port aléatoire disponible) ; par défaut, utilise la valeur de gateway.port dans la configuration.
  • --host <HOST> — Hôte auquel se lier ; par défaut, utilise la valeur gateway.host de la configuration. Remarque : La liaison à 0.0.0.0 nécessite gateway.allow_public_bind = true dans la configuration.
  • --allow-degraded-security — Démarrer même lorsque des sections de configuration critiques pour la sécurité ont été ramenées à leurs valeurs par défaut lors du chargement (posture de sécurité affaiblie). Désactivé par défaut

zeroclaw gateway restart

Redémarrez le serveur de passerelle.

Arrête le gateway en cours d’exécution, s’il est présent, puis démarre une nouvelle instance avec la configuration actuelle.

Exemples : zeroclaw gateway restart # redémarrer avec les valeurs par défaut de la configuration zeroclaw gateway restart -p 8080 # redémarrer sur le port 8080

Utilisation : zeroclaw gateway restart [OPTIONS]

Options :

  • -p, --port <PORT> — Port d’écoute (utilisez 0 pour un port aléatoire disponible) ; par défaut, utilise la valeur de gateway.port dans la configuration.
  • --host <HOST> — Hôte auquel se lier ; par défaut, utilise la valeur gateway.host de la configuration. Remarque : La liaison à 0.0.0.0 nécessite gateway.allow_public_bind = true dans la configuration.
  • --allow-degraded-security — Démarrer même lorsque des sections de configuration critiques pour la sécurité ont été ramenées à leurs valeurs par défaut lors du chargement (posture de sécurité affaiblie). Désactivé par défaut

zeroclaw gateway get-paircode

Afficher ou générer le code d’appairage de la passerelle.

Affiche le code d’appairage pour connecter de nouveaux clients sans redémarrer la passerelle. La passerelle doit être en cours d’exécution.

Avec –new, génère un nouveau code d’appairage même si la passerelle a déjà été appairée (utile pour ajouter des clients supplémentaires). Cela ne révoque PAS les jetons existants.

Avec –rotate, révoque TOUS les jetons bearer appairés, efface le registre des appareils et émet un nouveau code. Utilisez cette option après une fuite de jeton suspectée lorsque vous ne savez pas quel jeton a été compromis ; chaque client doit se réappairer.

Avec –rotate-device ID, révoque uniquement le jeton bearer de cet appareil et émet un nouveau code pour réapparier cet appareil.

Exemples : zeroclaw gateway get-paircode # afficher le code d’appairage actuel zeroclaw gateway get-paircode –new # ajouter un autre client (sans révocation) zeroclaw gateway get-paircode –rotate # révoquer TOUS les jetons, puis émettre un code zeroclaw gateway get-paircode –rotate-device dash-1 # révoquer le jeton d’un appareil zeroclaw gateway get-paircode –new –port 3001 # cibler la passerelle sur un port alternatif

Utilisation : zeroclaw gateway get-paircode [OPTIONS]

Options :

  • --new — Génère un nouveau code d’appairage pour ajouter un client (ne révoque pas les jetons existants)
  • --rotate — Révoque TOUS les jetons appairés et efface le registre des appareils, puis émet un nouveau code
  • --rotate-device <DEVICE_ID> — Révoque le jeton porteur d’un seul appareil par identifiant, puis émet un nouveau code
  • -p, --port <PORT> — Port de la passerelle en cours d’exécution à interroger ; par défaut config gateway.port
  • --host <HOST> — Hôte de la passerelle en cours d’exécution à interroger ; par défaut config gateway.host

zeroclaw acp

Démarrer le serveur ACP (JSON-RPC 2.0 via stdio).

Démarre un serveur JSON-RPC 2.0 sur stdin/stdout pour l’intégration avec les IDE et les outils. Prend en charge la gestion de session et le streaming des réponses de l’agent sous forme de notifications.

Méthodes : initialize, session/new, session/prompt, session/stop.

Exemples : zeroclaw acp # démarrer le serveur ACP zeroclaw acp –max-sessions 5 # limiter les sessions simultanées

Utilisation : zeroclaw acp [OPTIONS]

Options :

  • --max-sessions <MAX_SESSIONS> — Nombre maximal de sessions simultanées (par défaut : 10)
  • --session-timeout <SESSION_TIMEOUT> — Délai d’inactivité de la session en secondes (par défaut : 3600)

zeroclaw daemon

Démarrer le démon autonome à longue exécution.

Démarre l’exécution complète du runtime ZeroClaw : serveur gateway, tous les canaux configurés (Telegram, Discord, Slack, etc.), moniteur de battement de cœur et planificateur cron. C’est la méthode recommandée pour exécuter ZeroClaw en production ou en tant qu’assistant toujours actif.

Utilisez ‘zeroclaw service install’ pour enregistrer le daemon en tant que service du système d’exploitation (systemd/launchd) afin qu’il se lance automatiquement au démarrage.

Exemples : zeroclaw daemon # utiliser les valeurs par défaut de la configuration zeroclaw daemon -p 9090 # passerelle sur le port 9090 zeroclaw daemon –host 127.0.0.1 # uniquement localhost

Utilisation : zeroclaw daemon [OPTIONS]

Options :

  • -p, --port <PORT> — Port d’écoute (utilisez 0 pour un port aléatoire disponible) ; par défaut, utilise la valeur de gateway.port dans la configuration.
  • --host <HOST> — Hôte auquel se lier ; par défaut, utilise la valeur gateway.host de la configuration
  • --ephemeral — S’arrête automatiquement après la déconnexion de tous les clients socket (avec un délai de grâce)
  • --allow-degraded-security — Démarre même lorsque des sections de configuration critiques pour la sécurité ont été réinitialisées à leurs valeurs par défaut lors du chargement. Sans cette option, le démon refuse de démarrer avec une posture affaiblie ; avec elle, le démon démarre afin que l’opérateur puisse accéder aux interfaces de réparation, en émettant un avertissement répété

zeroclaw service

Gérer le cycle de vie des services OS (service utilisateur launchd/systemd)

Utilisation : zeroclaw service [OPTIONS] <COMMAND>

Sous-commandes :

  • install — Installer l’unité de service du démon pour le démarrage automatique et le redémarrage
  • start — Démarrer le service daemon
  • stop — Arrêter le service du démon
  • restart — Redémarrer le service du démon pour appliquer la dernière configuration
  • status — Vérifier l’état du service daemon
  • uninstall — Désinstaller l’unité de service du démon
  • logs — Affiche les journaux du service daemon

Options :

  • --service-init <SERVICE_INIT> — Système d’initialisation à utiliser : auto (détection), systemd ou openrc

    Valeur par défaut : auto

    Valeurs possibles : auto, systemd, openrc

zeroclaw service install

Installer l’unité de service daemon pour le démarrage automatique et le redémarrage

Utilisation : zeroclaw service install

zeroclaw service start

Démarrer le service daemon

Utilisation : zeroclaw service start

zeroclaw service stop

Arrêter le service du démon

Utilisation : zeroclaw service stop

zeroclaw service restart

Redémarrez le service du daemon pour appliquer la dernière configuration.

Utilisation : zeroclaw service restart

zeroclaw service status

Vérifier l’état du service daemon

Utilisation : zeroclaw service status

zeroclaw service uninstall

Désinstaller l’unité de service du démon

Utilisation : zeroclaw service uninstall

zeroclaw service logs

Afficher les journaux du service daemon en temps réel

Utilisation : zeroclaw service logs [OPTIONS]

Options :

  • -n, --lines <LINES> — Nombre de lignes à afficher (par défaut : 50)

    Valeur par défaut : 50

  • -f, --follow — Suivre la sortie du journal (comme tail -f)

zeroclaw doctor

Exécuter les diagnostics pour la fraîcheur du daemon/planificateur/canal

Utilisation : zeroclaw doctor [COMMAND]

Sous-commandes :

  • models — Sonde les catalogues de modèles dans les model_providers et signale la disponibilité
  • traces — Interroger les événements de trace d’exécution (diagnostics d’outils et réponses du modèle)
  • update-context-windows — Mettre à jour context_window dans config.toml à partir des endpoints /models du fournisseur

zeroclaw doctor models

Sonder les catalogues de modèles dans model_providers et signaler la disponibilité

Utilisation : zeroclaw doctor models [OPTIONS]

Options :

  • --model-provider <MODEL_PROVIDER> — Tester uniquement un model_provider spécifique (par défaut : tous les model_providers connus)
  • --use-cache — Privilégier les catalogues mis en cache lorsqu’ils sont disponibles (ignorer le rafraîchissement forcé en direct)

zeroclaw doctor traces

Interroger les événements de trace d’exécution (diagnostics de l’outil et réponses du modèle)

Utilisation : zeroclaw doctor traces [OPTIONS]

Options :

  • --id <ID> — Afficher un événement de trace spécifique par son identifiant

  • --event <EVENT> — Filtrer la liste des sorties par type d’événement

  • --contains <CONTAINS> — Correspondance de texte insensible à la casse dans le message/le contenu

  • --limit <LIMIT> — Nombre maximum d’événements à afficher

    Valeur par défaut : 20

zeroclaw doctor update-context-windows

Mettre à jour context_window dans config.toml à partir des points de terminaison /models du fournisseur

Utilisation : zeroclaw doctor update-context-windows [OPTIONS]

Options :

  • --model-provider <MODEL_PROVIDER> — Mettre à jour uniquement un model_provider spécifique (par défaut : tous les model_providers connus)
  • --dry-run — Affiche ce qui serait mis à jour sans écrire dans la config

zeroclaw status

Afficher l’état du système (détails complets)

Utilisation : zeroclaw status [OPTIONS]

Options :

  • --format <FORMAT> — Format de sortie : « exit-code » renvoie 0 si l’état est sain, 1 sinon (pour Docker HEALTHCHECK)

zeroclaw estop

Utilisation : zeroclaw estop [OPTIONS] [COMMAND]

Sous-commandes :

  • status — Afficher l’état actuel de l’arrêt d’urgence
  • resume — Reprendre depuis un niveau d’estop activé

Options :

  • --level <LEVEL> — Niveau utilisé lors de l’activation de l’arrêt d’urgence via zeroclaw estop

    Valeurs possibles : kill-all, network-kill, domain-block, tool-freeze

  • --domain <DOMAINS> — Motif(s) de domaine pour domain-block (répétable)

  • --tool <OUTILS> — Nom(s) de l’outil pour tool-freeze (répétable)

zeroclaw estop status

Afficher l’état actuel de l’arrêt d’urgence

Utilisation : zeroclaw estop status

zeroclaw estop resume

Reprendre depuis un niveau d’arrêt d’urgence activé

Utilisation : zeroclaw estop resume [OPTIONS]

Options :

  • --network — Reprendre uniquement la suppression du réseau
  • --domain <DOMAINS> — Reprendre un ou plusieurs motifs de domaines bloqués
  • --tool <OUTILS> — Reprendre un ou plusieurs outils gelés
  • --otp <OTP> — Code OTP. Si ce paramètre est omis et qu’un code OTP est requis, une invite sera affichée.

zeroclaw cron

Configurer et gérer les tâches planifiées.

Planifiez des tâches récurrentes, ponctuelles ou à intervalles à l’aide d’expressions cron, d’horodatages RFC3339 avec Z explicite ou décalages, de durées ou d’intervalles fixes.

Les expressions cron utilisent le format standard à 5 champs : ‘min hour day month weekday’. Lorsque –tz est omis, les planifications cron utilisent le fuseau horaire local de l’environnement d’exécution. Pour les planifications destinées aux utilisateurs, passez –tz avec un fuseau horaire IANA explicite.

Exemples : zeroclaw cron list zeroclaw cron add ‘0 9 * * 1-5’ ‘Good morning’ –agent sentinel –prompt –tz America/New_York zeroclaw cron add ‘*/30 * * * ’ ‘Check system health’ –agent sentinel –prompt zeroclaw cron add ‘/5 * * * *’ ‘echo ok’ –agent sentinel zeroclaw cron add-at 2099-01-15T14:00:00Z ‘Send reminder’ –agent sentinel –prompt zeroclaw cron add-every 60000 ‘Ping heartbeat’ –agent sentinel –prompt zeroclaw cron once 30m ‘Run backup in 30 minutes’ –agent sentinel –prompt zeroclaw cron pause TASK_ID zeroclaw cron update TASK_ID –expression ‘0 8 * * *’ –tz Europe/London

Utilisation : zeroclaw cron <COMMAND>

Sous-commandes :

  • list — Afficher toutes les tâches planifiées
  • add — Ajouter une nouvelle tâche planifiée
  • add-at — Ajouter une tâche planifiée à exécution unique à un horodatage RFC3339 avec Z explicite ou décalage
  • add-every — Ajouter une tâche planifiée à intervalle fixe
  • once — Ajouter une tâche retardée à exécution unique (par exemple, “30m”, “2h”, “1d”)
  • remove — Supprimer une tâche planifiée
  • update — Mettre à jour une tâche planifiée
  • pause — Mettre en pause une tâche planifiée
  • resume — Reprendre une tâche en pause

zeroclaw cron list

Liste toutes les tâches planifiées

Utilisation : zeroclaw cron list

zeroclaw cron add

Ajouter une nouvelle tâche planifiée récurrente.

Utilise la syntaxe cron standard à 5 champs : ‘min hour day month weekday’. Lorsque –tz est omis, les planifications cron utilisent le fuseau horaire local de l’environnement d’exécution. Pour les planifications destinées aux utilisateurs, passez –tz avec un fuseau horaire IANA explicite.

Exemples : zeroclaw cron add ‘0 9 * * 1-5’ ‘Good morning’ –agent sentinel –prompt –tz America/New_York zeroclaw cron add ‘*/30 * * * ’ ‘Check system health’ –agent sentinel –prompt zeroclaw cron add ‘/5 * * * *’ ‘echo ok’ –agent sentinel

Utilisation : zeroclaw cron add [OPTIONS] --agent <AGENT_ALIAS> <EXPRESSION> <COMMAND>

Arguments :

  • <EXPRESSION> — Expression Cron
  • <COMMAND> — Commande (shell) ou invite (avec –prompt) à exécuter

Options :

  • -a, --agent <AGENT_ALIAS> — Alias de l’agent configuré sous lequel la tâche cron s’exécute. Obligatoire — il n’y a pas d’agent par défaut

  • --tz <TZ> — Fuseau horaire IANA optionnel (par exemple, America/Los_Angeles)

  • --prompt — Traite l’argument comme une invite d’agent au lieu d’une commande shell

  • --allowed-tool <ALLOWED_TOOLS> — Limite les tâches cron de l’agent aux noms d’outils spécifiés (répétable, prompt uniquement)

  • --uses-memory <USES_MEMORY> — Si false, désactive le rappel de mémoire pour cette tâche cron d’agent (par défaut : true). Définir sur false pour les tâches de digeste/rapport sans état qui ne doivent pas accumuler ou consommer de mémoire

    Valeurs possibles : true, false

  • --channel <DELIVERY_CHANNEL> — Annoncer la sortie du job sur ce canal (p. ex. telegram, discord, slack)

  • --to <DELIVERY_TO> — ID du chat/destinataire cible pour le canal (par ex. un ID de chat Telegram).

    allow_hyphen_values est requis, car les destinataires pris en charge commencent par un tiret : les identifiants des groupes et des canaux Telegram sont négatifs (-100…), et une cible de sujet de forum est chat:thread (-100…:42), ce qui commence par un tiret sans être un nombre. Sans cette option, clap traite la valeur comme une option et quitte avant l’exécution de la moindre validation de livraison, ne laissant fonctionner que la forme non documentée --to=<value>.

    allow_negative_numbers ne suffit pas : il accepte -100…, mais rejette toujours la forme chat:thread. Ce paramètre plus permissif, à lui seul, permettrait à une valeur oubliée d’absorber l’option suivante ; parse_delivery_recipient rejette donc les valeurs ---préfixées et nomme le jeton fautif.

  • --thread <DELIVERY_THREAD> — Identifiant facultatif du fil de discussion ou de la conversation, pour les canaux qui l’utilisent pour le routage (webhook)

  • --no-best-effort — Échoue la tâche si la livraison échoue (par défaut : les erreurs de livraison ne sont pas fatales)

  • --best-effort — Permet à la tâche d’aboutir même si la livraison échoue. Restaure le comportement par défaut après un précédent --no-best-effort

zeroclaw cron add-at

Ajoutez une tâche ponctuelle qui se déclenche à un horodatage RFC3339 spécifique avec un Z explicite ou un décalage.

L’horodatage doit inclure un Z explicite ou un décalage numérique (p. ex. 2099-01-15T14:00:00Z ou 2099-01-15T09:00:00-05:00).

Exemples : zeroclaw cron add-at –agent morning-shift –prompt 2099-01-15T14:00:00Z ‘Envoyer un rappel’ zeroclaw cron add-at –agent morning-shift –prompt 2099-12-31T23:59:00Z ‘Bonne année !’

Usage : zeroclaw cron add-at [OPTIONS] --agent <AGENT_ALIAS> <AT> <COMMAND>

Arguments :

  • <AT> — Horodatage RFC3339 ponctuel avec Z explicite ou décalage
  • <COMMAND> — Commande (shell) ou invite (avec –prompt) à exécuter

Options :

  • -a, --agent <AGENT_ALIAS> — Alias de l’agent configuré sous lequel la tâche cron s’exécute

  • --prompt — Traite l’argument comme une invite d’agent au lieu d’une commande shell

  • --allowed-tool <ALLOWED_TOOLS> — Limite les tâches cron de l’agent aux noms d’outils spécifiés (répétable, prompt uniquement)

  • --uses-memory <USES_MEMORY> — Si false, désactive le rappel de mémoire pour cette tâche cron de l’agent (par défaut : true)

    Valeurs possibles : true, false

  • --channel <DELIVERY_CHANNEL> — Annoncer la sortie du job sur ce canal (p. ex. telegram, discord, slack)

  • --to <DELIVERY_TO> — ID du chat/destinataire cible pour le canal (par ex. un ID de chat Telegram).

    allow_hyphen_values est requis, car les destinataires pris en charge commencent par un tiret : les identifiants des groupes et des canaux Telegram sont négatifs (-100…), et une cible de sujet de forum est chat:thread (-100…:42), ce qui commence par un tiret sans être un nombre. Sans cette option, clap traite la valeur comme une option et quitte avant l’exécution de la moindre validation de livraison, ne laissant fonctionner que la forme non documentée --to=<value>.

    allow_negative_numbers ne suffit pas : il accepte -100…, mais rejette toujours la forme chat:thread. Ce paramètre plus permissif, à lui seul, permettrait à une valeur oubliée d’absorber l’option suivante ; parse_delivery_recipient rejette donc les valeurs ---préfixées et nomme le jeton fautif.

  • --thread <DELIVERY_THREAD> — Identifiant facultatif du fil de discussion ou de la conversation, pour les canaux qui l’utilisent pour le routage (webhook)

  • --no-best-effort — Échoue la tâche si la livraison échoue (par défaut : les erreurs de livraison ne sont pas fatales)

  • --best-effort — Permet à la tâche d’aboutir même si la livraison échoue. Restaure le comportement par défaut après un précédent --no-best-effort

zeroclaw cron add-every

Ajouter une tâche qui se répète à un intervalle fixe.

L’intervalle est spécifié en millisecondes. Par exemple, 60000 = 1 minute.

Exemples : zeroclaw cron add-every –agent triage –prompt 60000 ‘Ping heartbeat’ zeroclaw cron add-every –agent triage –prompt 3600000 ‘Hourly report’

Utilisation : zeroclaw cron add-every [OPTIONS] --agent <AGENT_ALIAS> <EVERY_MS> <COMMAND>

Arguments :

  • <EVERY_MS> — Intervalle en millisecondes
  • <COMMAND> — Commande (shell) ou invite (avec –prompt) à exécuter

Options :

  • -a, --agent <AGENT_ALIAS> — Alias de l’agent configuré sous lequel la tâche cron s’exécute

  • --prompt — Traite l’argument comme une invite d’agent au lieu d’une commande shell

  • --allowed-tool <ALLOWED_TOOLS> — Limite les tâches cron de l’agent aux noms d’outils spécifiés (répétable, prompt uniquement)

  • --uses-memory <USES_MEMORY> — Si false, désactive le rappel de mémoire pour cette tâche cron de l’agent (par défaut : true)

    Valeurs possibles : true, false

  • --channel <DELIVERY_CHANNEL> — Annoncer la sortie du job sur ce canal (p. ex. telegram, discord, slack)

  • --to <DELIVERY_TO> — ID du chat/destinataire cible pour le canal (par ex. un ID de chat Telegram).

    allow_hyphen_values est requis, car les destinataires pris en charge commencent par un tiret : les identifiants des groupes et des canaux Telegram sont négatifs (-100…), et une cible de sujet de forum est chat:thread (-100…:42), ce qui commence par un tiret sans être un nombre. Sans cette option, clap traite la valeur comme une option et quitte avant l’exécution de la moindre validation de livraison, ne laissant fonctionner que la forme non documentée --to=<value>.

    allow_negative_numbers ne suffit pas : il accepte -100…, mais rejette toujours la forme chat:thread. Ce paramètre plus permissif, à lui seul, permettrait à une valeur oubliée d’absorber l’option suivante ; parse_delivery_recipient rejette donc les valeurs ---préfixées et nomme le jeton fautif.

  • --thread <DELIVERY_THREAD> — Identifiant facultatif du fil de discussion ou de la conversation, pour les canaux qui l’utilisent pour le routage (webhook)

  • --no-best-effort — Échoue la tâche si la livraison échoue (par défaut : les erreurs de livraison ne sont pas fatales)

  • --best-effort — Permet à la tâche d’aboutir même si la livraison échoue. Restaure le comportement par défaut après un précédent --no-best-effort

zeroclaw cron once

Ajoutez une tâche unique qui se déclenche après un délai à partir de maintenant.

Accepte les durées lisibles par l’homme : s (secondes), m (minutes), h (heures), d (jours).

Exemples : zeroclaw cron once –agent ops-bot –prompt 30m ‘Run backup in 30 minutes’ zeroclaw cron once –agent researcher –prompt 2h ‘Follow up on deployment’

Utilisation : zeroclaw cron once [OPTIONS] --agent <AGENT_ALIAS> <DELAY> <COMMAND>

Arguments :

  • <DELAY> — Durée du délai
  • <COMMAND> — Commande (shell) ou invite (avec –prompt) à exécuter

Options :

  • -a, --agent <AGENT_ALIAS> — Alias de l’agent configuré sous lequel la tâche cron s’exécute

  • --prompt — Traite l’argument comme une invite d’agent au lieu d’une commande shell

  • --allowed-tool <ALLOWED_TOOLS> — Limite les tâches cron de l’agent aux noms d’outils spécifiés (répétable, prompt uniquement)

  • --uses-memory <USES_MEMORY> — Si false, désactive le rappel de mémoire pour cette tâche cron de l’agent (par défaut : true)

    Valeurs possibles : true, false

  • --channel <DELIVERY_CHANNEL> — Annoncer la sortie du job sur ce canal (p. ex. telegram, discord, slack)

  • --to <DELIVERY_TO> — ID du chat/destinataire cible pour le canal (par ex. un ID de chat Telegram).

    allow_hyphen_values est requis, car les destinataires pris en charge commencent par un tiret : les identifiants des groupes et des canaux Telegram sont négatifs (-100…), et une cible de sujet de forum est chat:thread (-100…:42), ce qui commence par un tiret sans être un nombre. Sans cette option, clap traite la valeur comme une option et quitte avant l’exécution de la moindre validation de livraison, ne laissant fonctionner que la forme non documentée --to=<value>.

    allow_negative_numbers ne suffit pas : il accepte -100…, mais rejette toujours la forme chat:thread. Ce paramètre plus permissif, à lui seul, permettrait à une valeur oubliée d’absorber l’option suivante ; parse_delivery_recipient rejette donc les valeurs ---préfixées et nomme le jeton fautif.

  • --thread <DELIVERY_THREAD> — Identifiant facultatif du fil de discussion ou de la conversation, pour les canaux qui l’utilisent pour le routage (webhook)

  • --no-best-effort — Échoue la tâche si la livraison échoue (par défaut : les erreurs de livraison ne sont pas fatales)

  • --best-effort — Permet à la tâche d’aboutir même si la livraison échoue. Restaure le comportement par défaut après un précédent --no-best-effort

zeroclaw cron remove

Supprimer une tâche planifiée

Utilisation : zeroclaw cron remove <ID>

Arguments :

  • <ID> — ID de la tâche

zeroclaw cron update

Mettre à jour un ou plusieurs champs d’une tâche planifiée existante.

Seuls les champs que vous spécifiez sont modifiés ; les autres restent inchangés.

Exemples : zeroclaw cron update TASK_ID –expression ‘0 8 * * *’ zeroclaw cron update TASK_ID –tz Europe/London –name ‘Morning check’ zeroclaw cron update TASK_ID –command ‘Updated message’

Utilisation : zeroclaw cron update [OPTIONS] --agent <AGENT_ALIAS> <ID>

Arguments :

  • <ID> — ID de la tâche

Options :

  • -a, --agent <AGENT_ALIAS> — Alias d’agent configuré. Obligatoire. Le profil de risque de l’alias contrôle les commandes shell pour les tâches shell.

  • --expression <EXPRESSION> — Nouvelle expression cron

  • --tz <TZ> — Nouveau fuseau horaire IANA

  • --command <COMMAND> — Nouvelle commande shell ou nouvelle invite de l’agent lorsque la tâche est une tâche d’agent

  • --name <NAME> — Nouveau nom de tâche

  • --allowed-tool <ALLOWED_TOOLS> — Remplacez la liste autorisée des outils du job agent par les noms d’outils spécifiés (répétable)

  • --uses-memory <USES_MEMORY> — Si false, désactive le rappel de mémoire pour cette tâche cron de l’agent (par défaut : true)

    Valeurs possibles : true, false

  • --channel <DELIVERY_CHANNEL> — Annoncer la sortie du job sur ce canal (p. ex. telegram, discord, slack)

  • --to <DELIVERY_TO> — ID du chat/destinataire cible pour le canal (par ex. un ID de chat Telegram).

    allow_hyphen_values est requis, car les destinataires pris en charge commencent par un tiret : les identifiants des groupes et des canaux Telegram sont négatifs (-100…), et une cible de sujet de forum est chat:thread (-100…:42), ce qui commence par un tiret sans être un nombre. Sans cette option, clap traite la valeur comme une option et quitte avant l’exécution de la moindre validation de livraison, ne laissant fonctionner que la forme non documentée --to=<value>.

    allow_negative_numbers ne suffit pas : il accepte -100…, mais rejette toujours la forme chat:thread. Ce paramètre plus permissif, à lui seul, permettrait à une valeur oubliée d’absorber l’option suivante ; parse_delivery_recipient rejette donc les valeurs ---préfixées et nomme le jeton fautif.

  • --thread <DELIVERY_THREAD> — Identifiant facultatif du fil de discussion ou de la conversation, pour les canaux qui l’utilisent pour le routage (webhook)

  • --no-best-effort — Échoue la tâche si la livraison échoue (par défaut : les erreurs de livraison ne sont pas fatales)

  • --best-effort — Permet à la tâche d’aboutir même si la livraison échoue. Restaure le comportement par défaut après un précédent --no-best-effort

zeroclaw cron pause

Mettre en pause une tâche planifiée

Utilisation : zeroclaw cron pause <ID>

Arguments :

  • <ID> — ID de la tâche

zeroclaw cron resume

Reprendre une tâche en pause

Utilisation : zeroclaw cron resume <ID>

Arguments :

  • <ID> — ID de la tâche

zeroclaw models

Gérer les catalogues de modèles model_provider

Utilisation : zeroclaw models <COMMAND>

Sous-commandes :

  • refresh — Actualiser et mettre en cache les modèles model_provider
  • list — Liste les modèles configurés dans config.toml
  • set — Définir le modèle par défaut dans la configuration
  • status — Afficher la configuration actuelle du modèle et l’état du cache

zeroclaw models refresh

Actualiser et mettre en cache les modèles model_provider

Utilisation : zeroclaw models refresh [OPTIONS]

Options :

  • --model-provider <MODEL_PROVIDER> — Nom du ModelProvider (par défaut, le model_provider configuré par défaut)
  • --all — Actualiser tous les model_providers prenant en charge la découverte de modèles en direct
  • --force — Forcer l’actualisation en direct et ignorer le cache frais

zeroclaw models list

Lister les modèles configurés dans config.toml

Utilisation : zeroclaw models list [OPTIONS]

Options :

  • --model-provider <MODEL_PROVIDER> — Nom du ModelProvider (par défaut, toutes les entrées configurées)
  • --check — Vérifier chaque modèle configuré par rapport au catalogue en direct du fournisseur

zeroclaw models set

Définir le modèle par défaut dans la configuration

Utilisation : zeroclaw models set <MODEL>

Arguments :

  • <MODEL> — Nom du modèle à définir par défaut

zeroclaw models status

Afficher la configuration actuelle du modèle et l’état du cache

Utilisation : zeroclaw models status

zeroclaw providers

CRUD d’alias pour les fournisseurs ([providers.<category>.<family>.<alias>]). category est l’un des éléments suivants : models, tts, transcription

Utilisation : zeroclaw providers [COMMAND]

Sous-commandes :

  • list — Lister les alias de fournisseurs (filtrés par catégorie en option)
  • create — Créer un nouvel alias de fournisseur avec la configuration par défaut
  • rename — Renommer un alias de fournisseur, en réécrivant chaque référence
  • delete — Supprimer un alias de fournisseur, en effaçant les références

zeroclaw providers list

Lister les alias de fournisseurs (éventuellement filtrés par catégorie)

Utilisation : zeroclaw providers list [OPTIONS]

Options :

  • --category <CATEGORY> — Catégorie : models | tts | transcription

zeroclaw providers create

Créer un nouvel alias de fournisseur avec la configuration par défaut

Utilisation : zeroclaw providers create <CATEGORY> <FAMILY> <ALIAS>

Arguments :

  • <CATEGORY> — Catégorie : models | tts | transcription
  • <FAMILY> — Famille de fournisseur (par ex. anthropic, openai, elevenlabs)
  • <ALIAS> — Nouvel alias

zeroclaw providers rename

Renommer un alias de fournisseur, en réécrivant toutes les références

Utilisation : zeroclaw providers rename <CATEGORY> <FAMILY> <FROM> <TO>

Arguments :

  • <CATEGORY>
  • <FAMILY>
  • <FROM>
  • <TO>

zeroclaw providers delete

Supprimer un alias de fournisseur, en nettoyant les références

Utilisation : zeroclaw providers delete [OPTIONS] <CATEGORY> <FAMILY> <ALIAS>

Arguments :

  • <CATEGORY>
  • <FAMILY>
  • <ALIAS>

Options :

  • --dry-run
  • --yes

zeroclaw channel

Gérer les canaux de communication.

Ajouter, supprimer, lister, envoyer et vérifier l’état des canaux qui connectent ZeroClaw aux plateformes de messagerie. Types de canaux pris en charge : telegram, discord, slack, whatsapp, matrix, imessage, email.

Exemples : zeroclaw channel list zeroclaw channel doctor zeroclaw channel add telegram ‘{“bot_token”:“…”,“name”:“my-bot”}’ zeroclaw channel remove my-bot zeroclaw channel bind-telegram zeroclaw_user zeroclaw channel send ‘Alert!’ –channel-id telegram –recipient 123456789

Utilisation : zeroclaw channel <COMMAND>

Sous-commandes :

  • list — Afficher tous les canaux configurés
  • start — Démarrer tous les canaux configurés (géré dans main.rs pour l’asynchrone)
  • doctor — Exécuter des vérifications de santé pour les canaux configurés (géré dans main.rs pour l’asynchrone)
  • add — Ajouter une nouvelle configuration de canal
  • remove — Supprimer une configuration de canal
  • bind-telegram — Associer une identité Telegram (nom d’utilisateur ou identifiant numérique) à la liste d’autorisation
  • send — Envoyer un message à un canal configuré

zeroclaw channel list

Liste tous les canaux configurés

Utilisation : zeroclaw channel list

zeroclaw channel start

Démarrer tous les canaux configurés (gérés dans main.rs pour l’asynchrone)

Utilisation : zeroclaw channel start

zeroclaw channel doctor

Exécuter les vérifications de santé pour les canaux configurés (géré dans main.rs pour l’asynchrone)

Utilisation : zeroclaw channel doctor

zeroclaw channel add

Ajouter une nouvelle configuration de canal.

Fournissez le type de canal et un objet JSON contenant les clés de configuration requises pour ce type de canal.

Types pris en charge : telegram, discord, slack, whatsapp, matrix, imessage, email.

Exemples : zeroclaw channel add telegram ‘{“bot_token”:“…”,“name”:“my-bot”}’ zeroclaw channel add discord ‘{“bot_token”:“…”,“name”:“my-discord”}’

Utilisation : zeroclaw channel add <TYPE_DE_CANAL> <CONFIG>

Arguments :

  • <CHANNEL_TYPE> — Type de canal (telegram, discord, slack, whatsapp, matrix, imessage, email)
  • <CONFIG> — Configuration optionnelle en JSON

zeroclaw channel remove

Supprimer la configuration d’une chaîne

Utilisation : zeroclaw channel remove <NAME>

Arguments :

  • <NAME> — Nom de la chaîne à supprimer

zeroclaw channel bind-telegram

Associer une identité Telegram à la liste d’autorisation.

Ajoute un nom d’utilisateur Telegram (sans le préfixe ‘@’) ou un identifiant numérique d’utilisateur à la liste autorisée du canal, afin que l’agent réponde aux messages provenant de cette identité.

Utilisez –alias pour cibler un canal Telegram non par défaut — il doit correspondre à l’alias dans la section channels.telegram.<alias> utilisée par l’agent. Sans cela, l’identité est liée à l’alias default et un agent non par défaut continuera à demander une approbation.

Exemples : zeroclaw channel bind-telegram zeroclaw_user zeroclaw channel bind-telegram 123456789 zeroclaw channel bind-telegram 123456789 –alias alerts

Utilisation : zeroclaw channel bind-telegram [OPTIONS] <IDENTITY>

Arguments :

  • <IDENTITY> — Identité Telegram à autoriser (nom d’utilisateur sans ‘@’ ou identifiant numérique d’utilisateur)

Options :

  • --alias <ALIAS> — Alias du canal Telegram à lier (le <alias> dans channels.telegram.<alias>). Par défaut : default

    Valeur par défaut : default

zeroclaw channel send

Envoyer un message unique à un canal configuré.

Envoie un message texte via le canal spécifié sans démarrer la boucle complète de l’agent. Utile pour les notifications scriptées, les alertes des capteurs matériels et les pipelines d’automatisation.

L’option --channel-id sélectionne le canal par son nom de section de configuration (par exemple, ‘telegram’, ‘discord’, ‘slack’). L’option --recipient correspond à la destination spécifique à la plateforme (par exemple, un ID de chat Telegram).

Exemples : zeroclaw channel send ‘Quelqu’un est près de votre appareil.’ –channel-id telegram –recipient 123456789 zeroclaw channel send ‘La construction a réussi !’ –channel-id discord –recipient 987654321

Utilisation : zeroclaw channel send --channel-id <CHANNEL_ID> --recipient <RECIPIENT> <MESSAGE>

Arguments :

  • <MESSAGE> — Texte du message à envoyer

Options :

  • --channel-id <CHANNEL_ID> — Nom de la configuration du canal (par exemple, telegram, discord, slack)
  • --recipient <RECIPIENT> — Identifiant du destinataire (spécifique à la plateforme, par exemple l’ID de chat Telegram)

zeroclaw agents

Gérer les alias d’agent (créer/lister/renommer/supprimer). Distinct de agent, qui exécute un agent

Utilisation : zeroclaw agents <COMMAND>

Sous-commandes :

  • list — Lister les alias d’agent configurés
  • create — Créer un nouvel alias d’agent avec la configuration par défaut
  • rename — Renommer un alias d’agent, en réécrivant chaque référence à celui-ci
  • delete — Supprime un alias d’agent, en nettoyant les références et en propageant la suppression de l’état possédé

zeroclaw agents list

Lister les alias d’agent configurés

Utilisation : zeroclaw agents list

zeroclaw agents create

Créer un nouvel alias d’agent avec la configuration par défaut

Utilisation : zeroclaw agents create <ALIAS>

Arguments :

  • <ALIAS> — Nouvel alias d’agent (alphanumérique en minuscules + underscore unique)

zeroclaw agents rename

Renommer un alias d’agent, en réécrivant chaque référence à celui-ci

Utilisation : zeroclaw agents rename <FROM> <TO>

Arguments :

  • <FROM> — Alias actuel
  • <TO> — Nouvel alias

zeroclaw agents delete

Supprimer un alias d’agent, en nettoyant les références et en propageant la suppression de l’état détenu

Utilisation : zeroclaw agents delete [OPTIONS] <ALIAS>

Arguments :

  • <ALIAS> — Alias à supprimer

Options :

  • --dry-run — Affiche l’impact (références qui seraient nettoyées) sans supprimer
  • --yes — Ignore l’invite de confirmation

zeroclaw channels

Gérer les alias de canaux (créer/lister/renommer/supprimer)

Utilisation : zeroclaw channels <COMMAND>

Sous-commandes :

  • list — Répertorier les alias de canaux (filtrés par type en option)
  • create — Créer un nouvel alias de canal avec la configuration par défaut
  • rename — Renommer un alias de canal, en réécrivant chaque référence
  • delete — Supprimer un alias de canal en nettoyant les références

zeroclaw channels list

Lister les alias de canaux (éventuellement filtrés par type)

Utilisation : zeroclaw channels list [OPTIONS]

Options :

  • --channel-type <CHANNEL_TYPE> — Type de canal, par ex. discord, telegram

zeroclaw channels create

Créer un nouvel alias de canal avec la configuration par défaut

Utilisation : zeroclaw channels create <CHANNEL_TYPE> <ALIAS>

Arguments :

  • <CHANNEL_TYPE> — Type de canal (discord, telegram, slack, …)
  • <ALIAS> — Nouvel alias

zeroclaw channels rename

Renommer un alias de canal, en réécrivant toutes les références

Utilisation : zeroclaw channels rename <CHANNEL_TYPE> <FROM> <TO>

Arguments :

  • <CHANNEL_TYPE>
  • <FROM>
  • <TO>

zeroclaw channels delete

Supprimer un alias de canal, en nettoyant les références

Usage : zeroclaw channels delete [OPTIONS] <CHANNEL_TYPE> <ALIAS>

Arguments :

  • <CHANNEL_TYPE>
  • <ALIAS>

Options :

  • --dry-run
  • --yes

zeroclaw integrations

Parcourez plus de 50 intégrations

Utilisation : zeroclaw integrations <COMMAND>

Sous-commandes :

  • info — Afficher les détails d’une intégration spécifique

zeroclaw integrations info

Afficher les détails d’une intégration spécifique

Utilisation : zeroclaw integrations info <NAME>

Arguments :

  • <NAME> — Nom de l’intégration

zeroclaw skills

Gérer les compétences (capacités définies par l’utilisateur)

Utilisation : zeroclaw skills <COMMAND>

Sous-commandes :

  • list — Liste toutes les compétences installées
  • add — Générer un nouveau skill à partir de zéro (SKILL.md canonique + sous-répertoires optionnels)
  • edit — Ouvre le fichier SKILL.md d’une compétence (ou un fichier adjacent) dans $EDITOR
  • bundle — Gérer les bundles de skills (les répertoires nommés dans lesquels résident les skills)
  • audit — Vérifier un répertoire source de compétence ou un nom de compétence installé
  • install — Installer une nouvelle compétence à partir d’une URL ou d’un chemin local
  • remove — Supprimer une compétence installée
  • test — Exécuter la validation TEST.sh pour une compétence (ou toutes les compétences)

zeroclaw skills list

Liste des compétences installées

Utilisation : zeroclaw skills list [OPTIONS]

Options :

  • --agent <AGENT> — Affiche exactement ce que cet agent charge à l’exécution (son workspace + open-skills + plugins + bundles assignés). –bundle a la priorité lorsque les deux sont passés
  • --bundle <BUNDLE> — Restreindre à un seul bundle. Omettre pour lister sur tous les bundles

zeroclaw skills add

Génère la structure d’une nouvelle skill dans un bundle de skills. Écrit <bundle.directory>/<name>/SKILL.md ainsi que les sous-répertoires optionnels canoniques (scripts/, references/, assets/). Le nom doit être en minuscules + tirets ; la description est obligatoire (demandée sur TTY si omise).

Exemples : zeroclaw skills add code-review –bundle official –description “Review PRs.” zeroclaw skills add ops-runbook –description “Triage prod incidents.” –edit

Utilisation : zeroclaw skills add [OPTIONS] <NAME>

Arguments :

  • <NAME> — Nom de la compétence (minuscules et traits d’union uniquement)

Options :

  • --bundle <BUNDLE> — Alias du bundle cible. Facultatif lorsqu’un seul bundle est configuré
  • --description <DESCRIPTION> — Ce que fait la compétence et quand l’utiliser (frontmatter description). Obligatoire ; demandé sur TTY si manquant
  • --license <LICENSE> — Identifiant de licence SPDX (par ex. MIT)
  • --author <AUTHOR> — Identifiant de l’auteur de la compétence
  • --version <VERSION> — Version SemVer (par défaut 0.1.0)
  • --category <CATEGORY> — Catégorie de compétence pour le regroupement dans le registre
  • --no-scaffold — Ignorer la génération des dossiers scripts/, references/, assets/
  • --edit — Ouvrir SKILL.md dans $EDITOR après génération du squelette

zeroclaw skills edit

Ouvrir le fichier SKILL.md d’une compétence (ou un fichier adjacent) dans $EDITOR

Utilisation : zeroclaw skills edit [OPTIONS] <NAME>

Arguments :

  • <NAME> — Nom de la compétence

Options :

  • --bundle <BUNDLE> — Alias du bundle cible. Facultatif lorsque le nom est unique parmi tous les bundles
  • --file <FILE> — Modifier un fichier voisin au lieu de SKILL.md (par ex. scripts/runner.sh)

zeroclaw skills bundle

Gérer les bundles de compétences (les répertoires nommés dans lesquels résident les compétences)

Utilisation : zeroclaw skills bundle <COMMAND>

Sous-commandes :

  • list — Répertorie les bundles de skills configurés et leurs répertoires résolus
  • add — Ajouter un nouveau bundle de compétences. Le répertoire est par défaut shared/skills/<alias>/
  • remove — Supprime un bundle de compétences configuré (archive son répertoire + le retire de la liste skill_bundles de chaque agent)
  • rename — Renommer un bundle de compétences (déplace son répertoire + réécrit les références d’agent)
  • show — Afficher les métadonnées et la liste des compétences d’un bundle

zeroclaw skills bundle list

Lister les bundles de compétences configurés et leurs répertoires résolus

Utilisation : zeroclaw skills bundle list

zeroclaw skills bundle add

Ajouter un nouveau bundle de compétences. Le répertoire par défaut est shared/skills/<alias>/

Utilisation : zeroclaw skills bundle add [OPTIONS] <ALIAS>

Arguments :

  • <ALIAS> — Alias du bundle (minuscules + traits d’union ; même convention que les agents/canaux)

Options :

  • --directory <DIRECTORY> — Remplace le répertoire (relatif à la racine d’installation ou absolu). Doit se résoudre à l’intérieur de <install>/shared/

zeroclaw skills bundle remove

Supprime un bundle de compétences configuré (archive son répertoire + le retire de la liste skill_bundles de chaque agent)

Utilisation : zeroclaw skills bundle remove [OPTIONS] <ALIAS>

Arguments :

  • <ALIAS> — Alias de bundle

Options :

  • --yes — Ignore l’invite de confirmation

zeroclaw skills bundle rename

Renommer un bundle de skills (déplace son répertoire + réécrit les références d’agent)

Utilisation : zeroclaw skills bundle rename <FROM> <TO>

Arguments :

  • <FROM> — Alias actuel
  • <TO> — Nouvel alias

zeroclaw skills bundle show

Afficher les métadonnées + la liste des compétences d’un bundle

Utilisation : zeroclaw skills bundle show <ALIAS>

Arguments :

  • <ALIAS> — Alias de bundle

zeroclaw skills audit

Auditer un répertoire de source de compétence ou un nom de compétence installé

Utilisation : zeroclaw skills audit <SOURCE>

Arguments :

  • <SOURCE> — Chemin de compétence ou nom de compétence installée

zeroclaw skills install

Installer une nouvelle compétence depuis une URL ou un chemin local

Utilisation : zeroclaw skills install [OPTIONS] <SOURCE>

Arguments :

  • <SOURCE> — URL source ou chemin local

Options :

  • --agent <AGENT> — Installer dans le bundle assigné à cet agent (par défaut l’agent actif). Lorsque l’agent n’a pas de bundle, se rabat sur le répertoire global
  • --bundle <BUNDLE> — Installer directement dans ce bundle. Prend le pas sur –agent
  • --no-tier-banner — Supprime uniquement la bannière de niveau affichée lors de l’installation ; les autres messages de progression de l’installation (résolution, installation, audit) ne sont pas affectés
  • --skill <SKILL> — Installe une compétence nommée unique depuis un dépôt de catalogue git (son répertoire skills/<name>/)

zeroclaw skills remove

Supprimer une compétence installée

Utilisation : zeroclaw skills remove [OPTIONS] <NAME>

Arguments :

  • <NAME> — Nom de la compétence à supprimer

Options :

  • --agent <AGENT> — Limiter la recherche aux bundles assignés à cet agent
  • --bundle <BUNDLE> — Supprimer de ce bundle directement (désambiguïse les doublons)

zeroclaw skills test

Exécuter la validation TEST.sh pour une compétence (ou toutes les compétences)

Utilisation : zeroclaw skills test [OPTIONS] [NAME]

Arguments :

  • <NAME> — Nom de la compétence à tester ; omettez pour toutes les compétences

Options :

  • --verbose — Afficher les détails

zeroclaw browse

Liste les enfants d’un répertoire sous <install>/shared/. Les chemins sont relatifs à la racine de l’espace de travail partagé ; la traversée par .. qui sort de la racine est rejetée. Utilisé par le sélecteur de répertoire de bundles de compétences du tableau de bord et par les opérateurs qui souhaitent inspecter ce qui est installé.

Examples : zeroclaw browse # lister la racine shared/ zeroclaw browse skills # lister shared/skills/ zeroclaw browse skills/coding # lister shared/skills/coding/

Utilisation : zeroclaw browse [PATH]

Arguments :

  • <PATH> — Chemin relatif à <install>/shared/. Vide = racine

    Valeur par défaut : ``

zeroclaw sop

Gérer les procédures opérationnelles standard (SOP)

Utilisation : zeroclaw sop <COMMAND>

Sous-commandes :

  • list — Liste les SOP chargés
  • validate — Valider les définitions SOP
  • show — Afficher les détails d’un SOP
  • approve — Approuver une exécution SOP en attente d’approbation hors bande (communique avec le démon en cours d’exécution)
  • deny — Refuser (annuler) une exécution SOP en attente d’approbation (communique avec le démon en cours d’exécution)
  • pending — Liste les exécutions SOP actuellement en attente d’approbation (communique avec le démon en cours d’exécution)
  • graph — Rendre le graphe de nœuds d’un SOP sous forme de texte
  • delete — Supprimer une définition SOP du disque

zeroclaw sop list

Liste des SOP chargés

Utilisation : zeroclaw sop list

zeroclaw sop validate

Valider les définitions des procédures opérationnelles standard (SOP)

Utilisation : zeroclaw sop validate [NAME]

Arguments :

  • <NAME> — Nom de SOP à valider (tous si omis)

zeroclaw sop show

Afficher les détails d’une SOP

Utilisation : zeroclaw sop show <NAME>

Arguments :

  • <NAME> — Nom du SOP à afficher

zeroclaw sop approve

Approuver une exécution SOP en attente d’approbation hors bande (communique avec le daemon en cours d’exécution)

Utilisation : zeroclaw sop approve <RUN_ID>

Arguments :

  • <RUN_ID> — L’ID d’exécution à approuver

zeroclaw sop deny

Rejeter (annuler) une exécution SOP en attente d’approbation (communique avec le daemon en cours d’exécution)

Utilisation : zeroclaw sop deny <RUN_ID> [REASON]

Arguments :

  • <RUN_ID> — L’ID d’exécution à refuser
  • <REASON> — Raison optionnelle enregistrée dans le registre d’approbation

zeroclaw sop pending

Lister les exécutions SOP actuellement en attente d’approbation (communique avec le daemon en cours d’exécution)

Utilisation : zeroclaw sop pending

zeroclaw sop graph

Rendre le graphe de nœuds d’un SOP en texte

Utilisation : zeroclaw sop graph [OPTIONS] <NAME>

Arguments :

  • <NAME> — Nom de la SOP à rendre

Options :

  • --format <FORMAT> — Format de sortie

    Valeur par défaut : outline

    Valeurs possibles :

    • outline : Une ligne par nœud avec ses arêtes de flux sortantes
    • adjacency: from -> to [role] adjacence, une arête par ligne
    • json: JSON formaté de la projection entière

zeroclaw sop delete

Supprimer une définition SOP du disque

Utilisation : zeroclaw sop delete <NAME>

Arguments :

  • <NAME> — Nom du SOP à supprimer

zeroclaw migrate

Migrer les données depuis d’autres runtimes d’agents

Utilisation : zeroclaw migrate <COMMAND>

Sous-commandes :

  • openclaw — Importer la mémoire d’un espace de travail OpenClaw dans cet espace de travail ZeroClaw

zeroclaw migrate openclaw

Importer la mémoire depuis un espace de travail OpenClaw vers cet espace de travail ZeroClaw

Utilisation : zeroclaw migrate openclaw [OPTIONS]

Options :

  • --source <SOURCE> — Chemin optionnel vers l’espace de travail OpenClaw (par défaut : ~/.openclaw/workspace)
  • --dry-run — Valider et afficher un aperçu de la migration sans écrire de données
  • --reindex — Reconstruire les index du backend après l’importation des entrées

zeroclaw auth

Gérer les profils d’authentification d’abonnement model_provider

Utilisation : zeroclaw auth <COMMAND>

Sous-commandes :

  • login — Se connecter avec OAuth (OpenAI Codex, Gemini ou xAI)
  • paste-redirect — Finalisez l’authentification OAuth en collant l’URL de redirection ou le code d’authentification
  • paste-token — Coller le jeton de configuration / jeton d’authentification (pour l’authentification par abonnement Anthropic)
  • setup-token — Alias de paste-token (interactif par défaut)
  • refresh — Rafraîchir le jeton d’accès OAuth à l’aide du jeton de rafraîchissement
  • logout — Supprimer le profil d’authentification
  • use — Définir le profil actif pour un model_provider
  • list — Liste des profils d’authentification
  • status — Afficher l’état d’authentification avec le profil actif et les informations d’expiration du jeton
  • email-login — Authentifier un canal e-mail via le flux de code d’appareil OAuth2

zeroclaw auth login

Se connecter avec OAuth (OpenAI Codex, Gemini ou xAI)

Utilisation : zeroclaw auth login [OPTIONS] --model-provider <MODEL_PROVIDER>

Options :

  • --model-provider <MODEL_PROVIDER> — ModelProvider (openai-codex, gemini ou xai)

  • --profile <PROFILE> — Nom du profil (par défaut : default)

    Valeur par défaut : default

  • --device-code — Utiliser le flux OAuth de code d’appareil

  • --import <PATH> — Importe un fichier auth.json existant au lieu de démarrer un nouveau flux de connexion. Prend en charge openai-codex (~/.codex/auth.json) et xai (~/.grok/auth.json)

zeroclaw auth paste-redirect

Terminez l’authentification OAuth en collant l’URL de redirection ou le code d’authentification

Utilisation : zeroclaw auth paste-redirect [OPTIONS] --model-provider <MODEL_PROVIDER>

Options :

  • --model-provider <MODEL_PROVIDER> — ModelProvider (openai-codex, gemini ou xai)

  • --profile <PROFILE> — Nom du profil (par défaut : default)

    Valeur par défaut : default

  • --input <INPUT> — URL de redirection complète ou code OAuth brut

zeroclaw auth paste-token

Collez le jeton de configuration / jeton d’authentification (pour l’authentification d’abonnement Anthropic)

Utilisation : zeroclaw auth paste-token [OPTIONS] --model-provider <MODEL_PROVIDER>

Options :

  • --model-provider <MODEL_PROVIDER> — ModelProvider (anthropic)

  • --profile <PROFILE> — Nom du profil (par défaut : default)

    Valeur par défaut : default

  • --token <TOKEN> — Valeur du jeton (si omis, lecture interactive)

  • --auth-kind <AUTH_KIND> — Remplacement du type d’authentification (authorization ou api-key)

zeroclaw auth setup-token

Alias de paste-token (interactif par défaut)

Usage : zeroclaw auth setup-token [OPTIONS] --model-provider <MODEL_PROVIDER>

Options :

  • --model-provider <MODEL_PROVIDER> — ModelProvider (anthropic)

  • --profile <PROFILE> — Nom du profil (par défaut : default)

    Valeur par défaut : default

zeroclaw auth refresh

Actualiser le jeton d’accès OAuth à l’aide du jeton d’actualisation

Utilisation : zeroclaw auth refresh [OPTIONS] --model-provider <MODEL_PROVIDER>

Options :

  • --model-provider <MODEL_PROVIDER> — ModelProvider (openai-codex, gemini ou xai)
  • --profile <PROFILE> — Nom ou identifiant du profil

zeroclaw auth logout

Supprimer le profil d’authentification

Utilisation : zeroclaw auth logout [OPTIONS] --model-provider <MODEL_PROVIDER>

Options :

  • --model-provider <MODEL_PROVIDER> — ModelProvider

  • --profile <PROFILE> — Nom du profil (par défaut : default)

    Valeur par défaut : default

zeroclaw auth use

Définir le profil actif pour un model_provider

Utilisation : zeroclaw auth use --model-provider <MODEL_PROVIDER> --profile <PROFILE>

Options :

  • --model-provider <MODEL_PROVIDER> — ModelProvider
  • --profile <PROFILE> — Nom du profil ou identifiant complet du profil

zeroclaw auth list

Liste des profils d’authentification

Utilisation : zeroclaw auth list

zeroclaw auth status

Afficher l’état d’authentification avec le profil actif et les informations d’expiration du jeton

Utilisation : zeroclaw auth status

zeroclaw auth email-login

Authentifier un canal e-mail via le flux de code d’appareil OAuth2

Utilisation : zeroclaw auth email-login [OPTIONS] --channel <CHANNEL>

Options :

  • --channel <CHANNEL> — Alias de canal email depuis [channels.email.<alias>] (ex. ‘hotmail’)

  • --profile <PROFILE> — Nom du profil (par défaut : default)

    Valeur par défaut : default

zeroclaw hardware

Découvrir et inspecter le matériel USB.

Énumérer les périphériques USB connectés, identifier les cartes de développement connues (STM32 Nucleo, Arduino, ESP32) et récupérer les informations du microcontrôleur via probe-rs / ST-Link.

Exemples : zeroclaw hardware discover zeroclaw hardware introspect /dev/ttyACM0 zeroclaw hardware info –chip STM32F401RETx

Utilisation : zeroclaw hardware <COMMAND>

Sous-commandes :

  • discover — Répertorier les périphériques USB (VID/PID) et afficher les cartes connues
  • introspect — Introspecter un périphérique par chemin (par exemple /dev/ttyACM0)
  • info — Obtenir les informations de la puce via USB (probe-rs via ST-Link). Aucun firmware requis sur la cible

zeroclaw hardware discover

Énumérer les périphériques USB et afficher les cartes connues.

Analyse les périphériques USB connectés par VID/PID et les compare aux cartes de développement connues (STM32 Nucleo, Arduino, ESP32).

Examples: zeroclaw hardware discover

Utilisation : zeroclaw hardware discover

zeroclaw hardware introspect

Inspecter un appareil par son numéro de série ou son chemin d’appareil.

Ouvre le chemin de périphérique spécifié et interroge les informations de la carte, la version du firmware et les capacités prises en charge.

Exemples : zeroclaw hardware introspect /dev/ttyACM0 zeroclaw hardware introspect COM3

Utilisation : zeroclaw hardware introspect <PATH>

Arguments :

  • <PATH> — Chemin série ou chemin de périphérique

zeroclaw hardware info

Obtenir les informations de la puce via USB en utilisant probe-rs sur ST-Link.

Interroge directement le MCU cible via la sonde de debug sans nécessiter de firmware sur la carte cible.

Exemples : zeroclaw hardware info zeroclaw hardware info –chip STM32F401RETx

Utilisation : zeroclaw hardware info [OPTIONS]

Options :

  • --chip <CHIP> — Nom de la puce (par exemple STM32F401RETx). Par défaut : STM32F401RETx pour Nucleo-F401RE

    Valeur par défaut : STM32F401RETx

zeroclaw peripheral

Gérer les périphériques matériels.

Ajouter, lister, afficher et configurer les cartes matérielles qui exposent des outils à l’agent (GPIO, capteurs, actionneurs). Cartes prises en charge : nucleo-f401re, rpi-gpio, esp32, arduino-uno.

Examples: zeroclaw peripheral list zeroclaw peripheral add nucleo-f401re /dev/ttyACM0 zeroclaw peripheral add rpi-gpio native zeroclaw peripheral flash –port /dev/cu.usbmodem12345 zeroclaw peripheral flash-nucleo

Utilisation : zeroclaw peripheral <COMMAND>

Sous-commandes :

  • list — Liste les périphériques configurés
  • add — Ajouter un périphérique (chemin de la carte, par exemple nucleo-f401re /dev/ttyACM0)
  • flash — Flasher le firmware ZeroClaw sur Arduino (crée un fichier .ino, installe arduino-cli si nécessaire, téléverse)
  • setup-uno-q — Configurer l’application de pont Arduino Uno Q (déployer le pont GPIO pour le contrôle de l’agent)
  • flash-nucleo — Flasher le firmware ZeroClaw sur un Nucleo-F401RE (compilation + exécution avec probe-rs)

zeroclaw peripheral list

Liste des périphériques configurés

Utilisation : zeroclaw peripheral list

zeroclaw peripheral add

Ajouter une périphérique par type de carte et chemin de transport.

Enregistre une carte matérielle afin que l’agent puisse utiliser ses outils (GPIO, capteurs, actionneurs). Utilisez ‘native’ comme chemin pour le GPIO local sur les ordinateurs monocartes comme le Raspberry Pi.

Cartes prises en charge : nucleo-f401re, rpi-gpio, esp32, arduino-uno.

Exemples : zeroclaw peripheral add nucleo-f401re /dev/ttyACM0 zeroclaw peripheral add rpi-gpio native zeroclaw peripheral add esp32 /dev/ttyUSB0

Utilisation : zeroclaw peripheral add <BOARD> <PATH>

Arguments :

  • <BOARD> — Type de carte (nucleo-f401re, rpi-gpio, esp32)
  • <PATH> — Chemin pour le transport série (/dev/ttyACM0) ou « native » pour GPIO local

zeroclaw peripheral flash

Flasher le firmware ZeroClaw sur une carte Arduino.

Génère le croquis .ino, installe arduino-cli s’il n’est pas déjà disponible, compile et télécharge le firmware.

Examples: zeroclaw peripheral flash zeroclaw peripheral flash –port /dev/cu.usbmodem12345 zeroclaw peripheral flash -p COM3

Utilisation : zeroclaw peripheral flash [OPTIONS]

Options :

  • -p, --port <PORT> — Port série (par exemple /dev/cu.usbmodem12345). Si omis, utilise le premier arduino-uno de la configuration.

zeroclaw peripheral setup-uno-q

Configurer l’application Arduino Uno Q Bridge (déployer le pont GPIO pour le contrôle de l’agent)

Utilisation : zeroclaw peripheral setup-uno-q [OPTIONS]

Options :

  • --host <HOST> — IP de Uno Q (par exemple 192.168.0.48). Si omis, suppose que le programme s’exécute SUR Uno Q.

zeroclaw peripheral flash-nucleo

Flasher le firmware ZeroClaw sur le Nucleo-F401RE (builds + exécution avec probe-rs)

Utilisation : zeroclaw peripheral flash-nucleo

zeroclaw memory

Gérer les entrées de mémoire de l’agent.

Lister, inspecter et effacer les entrées de mémoire stockées par l’agent. Prend en charge le filtrage par catégorie et session, la pagination, ainsi que l’effacement par lots avec confirmation.

Exemples : zeroclaw memory stats zeroclaw memory list zeroclaw memory list –category core –limit 10 zeroclaw memory get KEY zeroclaw memory clear –category conversation –yes

Utilisation : zeroclaw memory <COMMAND>

Sous-commandes :

  • list — Liste les entrées de mémoire avec des filtres optionnels
  • get — Récupérer une entrée de mémoire spécifique par clé
  • stats — Afficher les statistiques et l’état de santé du backend de mémoire
  • clear — Effacer les mémoires par catégorie, par clé ou effacer toutes les mémoires
  • reindex —

zeroclaw memory list

Liste des entrées de mémoire avec des filtres optionnels

Utilisation : zeroclaw memory list [OPTIONS]

Options :

  • --category <CATEGORY>

  • --session <SESSION>

  • --limit <LIMIT>

    Valeur par défaut : 50

  • --offset <OFFSET>

    Valeur par défaut : 0

zeroclaw memory get

Obtenir une entrée de mémoire spécifique par clé

Utilisation : zeroclaw memory get <KEY>

Arguments :

  • <KEY>

zeroclaw memory stats

Afficher les statistiques et l’état de santé du backend de mémoire

Utilisation : zeroclaw memory stats

zeroclaw memory clear

Effacer les mémoires par catégorie, par clé, ou tout effacer

Utilisation : zeroclaw memory clear [OPTIONS]

Options :

  • --key <KEY> — Supprimer une seule entrée par clé (prend en charge la correspondance de préfixe)
  • --category <CATEGORY>
  • --yes — Ignorer l’invite de confirmation

zeroclaw memory reindex

Utilisation : zeroclaw memory reindex

zeroclaw config

Gérer la configuration de ZeroClaw.

Afficher, définir ou initialiser les propriétés de configuration via un chemin pointé. Utilisez « schema » pour afficher le schéma JSON complet du fichier de configuration.

Les propriétés sont adressées par un chemin pointé (par exemple, channels.matrix.mention-only). Les champs secrets (clés API, jetons) utilisent automatiquement une saisie masquée. Les champs énumérés offrent une sélection interactive lorsque la valeur est omise.

Exemples : zeroclaw config list # lister toutes les propriétés zeroclaw config list –secrets # lister uniquement les secrets zeroclaw config list –filter channels.matrix # filtrer par préfixe zeroclaw config get channels.matrix.mention-only # obtenir une valeur zeroclaw config set channels.matrix.mention-only true # définir une valeur zeroclaw config set channels.matrix.access-token # secret : saisie masquée zeroclaw config set channels.matrix.stream-mode # enum : sélection interactive zeroclaw config init channels.matrix # initialiser une section avec les valeurs par défaut zeroclaw config init risk_profiles.strict # créer un nouvel alias dynamic-map zeroclaw config schema # afficher le schéma JSON sur stdout zeroclaw config schema > schema.json

La complétion des chemins de propriété est incluse automatiquement dans zeroclaw completions <shell>.

Utilisation : zeroclaw config <COMMAND>

Sous-commandes :

  • schema — Affiche le schéma JSON complet de la configuration sur stdout. Avec --path, renvoie uniquement le fragment de schéma pour cette propriété — même contenu que celui renvoyé par OPTIONS /api/config/prop?path=... via HTTP
  • list — Affiche toutes les propriétés de configuration avec leurs valeurs actuelles
  • get — Obtenir la valeur d’une propriété de configuration
  • set — Définir une propriété de configuration (les champs secrets demandent automatiquement une saisie masquée)
  • init — Initialiser les sections non configurées avec les valeurs par défaut (enabled=false)
  • migrate — Migre la configuration sur disque vers la version actuelle du schéma (préserve les commentaires)
  • patch — Applique un document JSON Patch (RFC 6902) de manière atomique. Correspond à PATCH /api/config. Lit les opérations depuis le fichier donné, ou depuis stdin quand le chemin est - ou omis. Ops supportées : add, replace, remove, test. move et copy sont rejetées
  • docs — Affiche l’URL de l’explorateur d’API (plus un indice si le démon n’est pas en cours d’exécution)
  • generate —

zeroclaw config schema

Affiche le schéma JSON complet de la configuration sur stdout. Avec --path, renvoie uniquement le fragment de schéma correspondant à cette propriété — c’est la même charge utile que OPTIONS /api/config/prop?path=... renvoie via HTTP

Utilisation : zeroclaw config schema [OPTIONS]

Options :

  • --path <PATH> — Chemin de propriété pour délimiter l’export du schéma (par exemple agents.researcher.model_provider). Sans cela, exporte le schéma de la configuration complète

zeroclaw config list

Liste toutes les propriétés de configuration avec leurs valeurs actuelles

Utilisation : zeroclaw config list [OPTIONS]

Options :

  • -f, --filter <FILTER> — Filtrer par préfixe de chemin (par ex. « channels.telegram »)
  • --secrets — Afficher uniquement les champs secrets (chiffrés)

zeroclaw config get

Obtenir la valeur d’une propriété de configuration

Utilisation : zeroclaw config get [OPTIONS] <PATH>

Arguments :

  • <PATH> — Chemin de propriété (par exemple, channels.telegram.mention-only)

Options :

  • --json — Émet une enveloppe JSON structurée ({path, value} ou {path, populated}) au lieu de texte brut

zeroclaw config set

Définir une propriété de configuration (les champs secrets demandent automatiquement une saisie masquée)

Utilisation : zeroclaw config set [OPTIONS] <PATH> [VALUE]

Arguments :

  • <PATH> — Chemin de propriété
  • <VALUE> — Nouvelle valeur (omettez pour les champs de secret afin d’obtenir une entrée masquée)

Options :

  • --no-interactive — Ignorer les invites interactives — exiger une valeur en ligne de commande, accepter des chaînes brutes pour les énumérations
  • --comment <COMMENT> — Commentaire facultatif à écrire à côté de la valeur dans TOML (conservé lors des futures modifications)
  • --json — Émet une enveloppe JSON structurée en cas de succès

zeroclaw config init

Initialiser les sections non configurées avec les valeurs par défaut (enabled=false)

Utilisation : zeroclaw config init [OPTIONS] [SECTION]

Arguments :

  • <SECTION> — Préfixe de section (par exemple channels.matrix), ou <section>.<alias> pour créer un nouvel alias de mappage dynamique (par exemple risk_profiles.strict). À omettre pour tout initialiser

Options :

  • --json — Émet une enveloppe JSON structurée ({initialized: […]}) au lieu de texte brut

zeroclaw config migrate

Migrer la configuration sur disque vers la version actuelle du schéma (préserve les commentaires)

Utilisation : zeroclaw config migrate [OPTIONS]

Options :

  • --json — Émettre une enveloppe JSON structurée ({migrated, backup_path?, schema_version, valid?, error?}) au lieu de texte brut

zeroclaw config patch

Applique un document JSON Patch (RFC 6902) de manière atomique. Reflète PATCH /api/config. Lit les opérations depuis le fichier indiqué, ou depuis stdin lorsque le chemin est - ou omis. Opérations prises en charge : add, replace, remove, test. move et copy sont rejetées

Utilisation : zeroclaw config patch [OPTIONS] [INPUT]

Arguments :

  • <INPUT> — Chemin vers un document JSON Patch, ou - pour stdin (par défaut)

Options :

  • --json — Affiche les résultats au format JSON (un objet par opération appliquée) au lieu d’un texte lisible

zeroclaw config docs

Affiche l’URL de l’explorateur d’API (avec un indice si le daemon n’est pas en cours d’exécution)

Utilisation : zeroclaw config docs

zeroclaw config generate

Utilisation : zeroclaw config generate [OPTIONS] [VERSION]

Arguments :

  • <VERSION> — Version de schéma cible (par ex. 1, 2, 3). Par défaut, la version actuelle

Options :

  • --encrypt — Chiffre les valeurs de chaîne contenant des secrets dans la sortie (api_key, bot_token, access_token, password, refresh_token, etc.). Fonctionne avec toutes les versions de schéma via un parcours basé sur le nom des clés. Utilise le fichier .secret_key du config-dir résolu (en crée un s’il est absent)

zeroclaw update

Vérifier et appliquer les mises à jour de ZeroClaw.

Par défaut, télécharge et installe la dernière version en utilisant un pipeline en 6 phases : préflight, téléchargement, sauvegarde, validation, échange et test de fumée. Rollback automatique en cas d’échec.

Utilisez --check pour vérifier les mises à jour sans les installer. Utilisez --force pour ignorer l’invite de confirmation. Utilisez --version pour cibler une version spécifique au lieu de la dernière.

Exemples : zeroclaw update # télécharger et installer la dernière mise à jour de zeroclaw zeroclaw update –check # vérifier uniquement, ne pas installer zeroclaw update –force # installer sans confirmation zeroclaw update –version 0.6.0 # installer une version spécifique

Utilisation : zeroclaw update [OPTIONS]

Options :

  • --check — Vérifier uniquement les mises à jour, sans installer
  • --force — Installer même si la cible n’est pas plus récente (réinstaller ou rétrograder/épingler à –version)
  • --version <VERSION> — Version cible (par défaut : dernière version)
  • --json — Avec –check, produit du JSON exploitable par une machine au lieu de texte lisible

zeroclaw self-test

Exécuter les tests d’automatisation pour vérifier l’installation de ZeroClaw.

Par défaut, exécute l’ensemble complet des tests, y compris les vérifications réseau (état du pont, aller-retour de la mémoire). Utilisez l’option –quick pour ignorer les vérifications réseau et accélérer la validation hors ligne.

Exemples : zeroclaw self-test # suite complète
zeroclaw self-test –quick # vérifications rapides uniquement (sans réseau)

Utilisation : zeroclaw self-test [OPTIONS]

Options :

  • --quick — Exécuter uniquement les vérifications rapides (sans réseau)

zeroclaw completions

Générez des scripts de complétion de shell pour zeroclaw.

Le script est affiché sur stdout afin qu’il puisse être source directement :

Exemples (shells Unix) : source <(zeroclaw completions bash) zeroclaw completions zsh > ~/.zfunc/_zeroclaw zeroclaw completions fish > ~/.config/fish/completions/zeroclaw.fish

Exemples (Windows PowerShell) : zeroclaw completions powershell | Out-String | Invoke-Expression zeroclaw completions powershell > $PROFILE.CurrentUserAllHosts

Utilisation : zeroclaw completions <SHELL>

Arguments :

  • <SHELL> — Shell cible

    Valeurs possibles : bash, fish, zsh, powershell, elvish

zeroclaw desktop

Lancez l’application de bureau compagnon ZeroClaw.

L’application compagnon est une application légère de barre de menus / zone de notification qui se connecte au même gateway que la CLI. Elle offre un accès rapide au tableau de bord, à la surveillance de l’état et à l’appairage des appareils.

Utilisez –install pour ouvrir la page de téléchargement correspondant à votre plateforme. Cette option n’installe rien elle-même.

Exemples : zeroclaw desktop # lancer l’application compagnon zeroclaw desktop –install # ouvrir la page de téléchargement

Utilisation : zeroclaw desktop [OPTIONS]

Options :

  • --install — Ouvrir la page de téléchargement de l’application compagnon

zeroclaw locales

Récupère les catalogues Fluent (.ftl) traduits pour une locale depuis le dépôt amont et les installe sous <config-dir>/data/ftl/<locale>/, où les chargeurs runtime et zerocode les lisent.

Transmettez une seule locale. Par défaut, tous les catalogues sont récupérés ; restreignez avec –catalog (séparés par des virgules) : cli, tools, zerocode.

Exemples : zeroclaw locales fetch ja zeroclaw locales fetch fr –catalog cli,tools zeroclaw locales fetch zh-CN –catalog zerocode

Utilisation : zeroclaw locales <COMMAND>

Sous-commandes :

  • fetch — Télécharger les fichiers FTL traduits pour une locale depuis le dépôt amont

zeroclaw locales fetch

Télécharger les fichiers FTL traduits pour une locale depuis le dépôt amont

Utilisation : zeroclaw locales fetch [OPTIONS] <LOCALE>

Arguments :

  • <LOCALE> — Code de locale à récupérer (par ex. ja, fr, zh-CN)

Options :

  • --catalog <CATALOG> — Catalogues à récupérer, séparés par des virgules : cli, tools, zerocode. Omettre pour les récupérer tous

Ce document a été généré automatiquement par clap-markdown.