Concepts

Ce sont les termes que le guide de démarrage rapide et la référence de configuration tiennent pour acquis. Chacun dispose d’une page plus détaillée, accessible via le lien à la fin de sa définition.

Alias. Un alias est le nom que vous attribuez à une instance configurée, puis que vous référencez ailleurs pour la désigner. Vous choisissez le nom librement ; d’autres parties de la configuration relient les éléments entre eux par ce nom. Les alias sont composés de lettres ASCII minuscules, de chiffres et de tirets bas simples, doivent commencer et se terminer par une lettre ou un chiffre, et ne peuvent pas contenir __ ni de traits d’union. Dans la configuration, ils apparaissent comme le segment <alias> d’un en-tête de section, tel que [agents.<alias>] ou [providers.models.<type>.<alias>]. Voir Référence → Variables d’environnement → Grammaire des alias.

Fournisseur de modèles. Un fournisseur de modèles est l’abstraction de ZeroClaw au-dessus d’un point de terminaison LLM. Chaque requête de complétion de chat passe par un fournisseur, que la cible soit une API distante, un serveur auto-hébergé ou un modèle Ollama local. Les fournisseurs sont typés par famille d’éditeur, et vous pouvez exécuter plusieurs instances nommées de la même famille. Dans la configuration, chacun se trouve sous [providers.models.<type>.<alias>]. Voir Fournisseurs de modèles → Vue d’ensemble.

Profil de risque. Un profil de risque est une posture nommée d’autonomie et de sandbox. Son niveau est readonly, supervised (la valeur par défaut) ou full, et contrôle si les outils s’exécutent automatiquement, demandent une approbation ou sont bloqués. Chaque agent référence exactement un profil de risque. Dans la configuration, il se trouve sous [risk_profiles.<alias>]. Voir Sécurité → Niveaux d’autonomie.

Profil d’exécution. Un profil d’exécution est un réglage opérationnel réutilisable : mode agentique, plafonds d’itérations d’outils, budgets d’actions et de coûts, délais d’expiration, limites de contexte et politique de délégation. Il est distinct du profil de risque, qui régit l’autonomie. Quickstart installe le préréglage unbounded pour les nouveaux agents ; ajustez les champs ensuite. Dans la configuration, il se trouve sous [runtime_profiles.<alias>]. Voir Reference → Config.

Multi-agent. ZeroClaw exécute plusieurs agents à partir d’une seule installation. Chaque agent possède son propre ensemble de références (profil de risque, fournisseur de modèle, canaux), son propre répertoire d’espace de travail et son propre backend de mémoire. Un agent peut générer un SubAgent éphémère qui hérite de l’identité et de la politique de sécurité de son parent, et les agents peuvent communiquer entre eux lorsqu’ils partagent un peer group. Dans la configuration, chaque agent est un bloc [agents.<alias>]. Voir Agents → Runtime internals.

Groupe de pairs. Un groupe de pairs déclare un ensemble de communication inter-agents avec adhésion explicite sur un canal unique. L’appartenance est mutuelle : deux agents ne sont pairs que lorsque les deux figurent dans la liste des membres du même groupe. Dans la configuration, il se trouve sous [peer_groups.<name>]. Voir Agents → Fonctionnement interne du runtime.

Lot de compétences (skill bundle). Un lot de compétences est un groupe réutilisable de compétences attaché à un agent ou à un canal par alias. Il contrôle quelles compétences sont chargées et depuis quel emplacement : un répertoire source ainsi que des listes d’inclusion et d’exclusion facultatives. Les compétences elles-mêmes sont des instructions réutilisables et des définitions d’outils facultatives. Dans la configuration, un lot se trouve à [skill_bundles.<alias>]. Voir Tools → Skills.