Démarrage rapide

Quickstart est l’assistant de configuration guidée qui vous mène d’une installation vierge à un agent fonctionnel en une seule passe. Il s’exécute sur trois interfaces : la CLI, l’interface de terminal zerocode et la passerelle web. Les trois pilotent le même flux sous-jacent, donc la configuration qu’elles produisent est identique. Utilisez celle qui convient le mieux à votre contexte.

Installer

Chemin rapide Unix

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh

Cette route est non interactive et n’ouvre pas de sélecteur.

Il privilégie un binaire précompilé correspondant et se rabat sur une compilation à partir des sources si nécessaire.

Une archive précompilée peut contenir zerocode ; un repli non interactif vers les sources installe l’application par défaut sans ouvrir de sélecteur.

La commande utilise un ensemble de fonctionnalités fixe.

Si une compilation à partir des sources est nécessaire, l’installateur peut installer Rust automatiquement s’il est absent.

Sous Unix, le programme d’installation met à jour le profil du shell si cela est autorisé ; rechargez le shell parent avant de vous fier au nouveau PATH.

L’installateur ignore la configuration et affiche zeroclaw quickstart comme étape suivante.

Parcours guidé Unix

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

Cette route est guidée et peut proposer des choix pris en charge.

Sur les cibles prises en charge, il propose une installation à partir de binaires précompilés ou une compilation depuis les sources.

Une archive précompilée peut contenir zerocode ; le choix de la source le sélectionne par défaut et permet de sélectionner l’application.

Le chemin source vous permet également de sélectionner des fonctionnalités Cargo facultatives.

Si une compilation à partir des sources est nécessaire, l’installateur peut installer Rust automatiquement s’il est absent.

Sous Unix, le programme d’installation met à jour le profil du shell si cela est autorisé ; rechargez le shell parent avant de vous fier au nouveau PATH.

Pour une installation non configurée, il propose zeroclaw quickstart ou le Quickstart dans le navigateur.

Chemin de la version précompilée pour Windows

Utilisez le bloc PowerShell du guide d’installation Windows. L’installation et la configuration du PATH sont idempotentes ; Quickstart s’exécute toujours.

Cette route est non interactive et n’ouvre pas de sélecteur.

Cette méthode installe une archive de version précompilée.

L’archive peut également contenir zerocode ; la disponibilité dépend de l’élément de version.

La commande utilise un ensemble de fonctionnalités fixe.

Cette route précompilée ne nécessite pas de chaîne d’outils Rust.

Sous Windows, le chemin PowerShell met à jour le processus actuel et le PATH utilisateur persistant.

Le bloc PowerShell se termine en exécutant automatiquement zeroclaw quickstart.

Chemin source avancé

Unix

./install.sh --source

Cette route est guidée et peut proposer des choix pris en charge.

Cette méthode compile toujours à partir des sources.

L’installation depuis les sources sélectionne zerocode par défaut et vous permet de modifier la sélection de l’application.

Le chemin source vous permet également de sélectionner des fonctionnalités Cargo facultatives.

Si une compilation à partir des sources est nécessaire, l’installateur peut installer Rust automatiquement s’il est absent.

Sous Unix, le programme d’installation met à jour le profil du shell si cela est autorisé ; rechargez le shell parent avant de vous fier au nouveau PATH.

Pour une installation non configurée, il propose zeroclaw quickstart ou le Quickstart dans le navigateur.

Windows

cargo install --locked --path .

Cette route est non interactive et n’ouvre pas de sélecteur.

Cette méthode compile toujours à partir des sources.

Cette commande installe le binaire principal zeroclaw ; elle n’installe pas les applications facultatives.

La commande utilise un ensemble de fonctionnalités fixe.

Une chaîne d’outils Rust est requise avant d’utiliser cette commande.

Cette commande Cargo ne modifie pas PATH ; assurez-vous que le répertoire bin de Cargo est déjà disponible dans votre shell.

Après l’installation, exécutez zeroclaw quickstart.

Les étapes

Important : si l’un de ces termes ne vous est pas familier, consultez d’abord Getting Started → Concepts. Il définit en un seul endroit le fournisseur de modèle, le profil de risque, l’alias et le reste.

Chaque surface suit la même liste de contrôle et écrit la même configuration ; seule l’étape facultative Plugins est actuellement réservée à la CLI. Les étapes obligatoires doivent être satisfaites avant que l’agent puisse être créé ; les étapes facultatives peuvent être ignorées.

Le profil d’exécution est défini automatiquement. Quickstart installe le préréglage unbounded pour le nouvel agent. Ajustez ensuite les budgets et les délais d’expiration en modifiant [runtime_profiles.<alias>] (voir Référence → Config).

CLI

Le chemin le plus rapide sur une machine sans interface graphique ou via SSH :

zeroclaw quickstart

Vous répondez à une invite par étape dans le terminal. Le canal intégré cli fonctionne immédiatement, donc les sections Channels et Peer groups peuvent être ignorées. Pour une configuration entièrement par défaut, sans approbations, consultez le mode YOLO.

OpenAI Codex auth d’abonnement

Le démarrage rapide peut configurer le chemin d’abonnement OpenAI Codex sans clé API. Authentifiez-vous une fois, puis choisissez OpenAI comme fournisseur et définissez Authentification sur codex lorsque vous y êtes invité :

# Si vous êtes déjà connecté avec le Codex CLI :
zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json

# Ou lancer le flux de connexion OpenAI Codex propre à ZeroClaw :
zeroclaw auth login --model-provider openai-codex

Pour une configuration scriptée, openai-codex est accepté comme alias de saisie pour le démarrage rapide et génère l’entrée canonique [providers.models.openai.<alias>] :

zeroclaw quickstart --model-provider openai-codex --model gpt-5.4 --agent assistant

Authentification setup-token abonnement Claude

Le démarrage rapide peut également configurer Claude/Anthropic avec une clé API Console normale ou un token généré par Claude Max :

claude setup-token
zeroclaw quickstart --model-provider anthropic --model claude-sonnet-4-5 --agent assistant

Choisissez Anthropic, définissez Authentification sur setup_token, puis collez le jeton issu de claude setup-token dans l’invite de clé API/jeton. La saisie scriptée peut utiliser --model-provider claude comme alias. Quickstart conserve toujours l’entrée canonique [providers.models.anthropic.<alias>] ; le jeton est stocké via le même chemin d’identifiants que api_key.

Plugins

Les builds avec prise en charge des plugins WASM ajoutent une ligne Plugins facultative à la liste de contrôle de la CLI, après Groupes de pairs. La ligne n’apparaît que si le binaire est compilé avec la fonctionnalité plugins-wasm. Les archives de version actuelles sont compilées sans cette fonctionnalité, donc leur liste de contrôle ne contient pas de ligne Plugins ; une compilation depuis les sources avec --preset full et l’image de conteneur all-features l’incluent. Seul le Démarrage rapide de la CLI propose la ligne pour l’instant : le Démarrage rapide de zerocode et de la passerelle web ne listent pas encore les plugins. Laisser la ligne non cochée ne change rien.

L’ouverture de la ligne récupère l’index du registre de plugins, le même que celui utilisé par zeroclaw plugin search (définissez ZEROCLAW_PLUGIN_REGISTRY_URL pour utiliser un autre registre), et affiche tous les plugins d’outils que le registre propose ou que cette machine possède déjà, en marquant ceux qui sont installés. Si l’index du registre ne peut pas être récupéré, vous pouvez réessayer ou continuer sans plugins. Choisir des plugins ne télécharge aucun paquet et ne modifie aucune configuration. L’ouverture de la ligne écrit uniquement le cache de l’index du registre dans le répertoire de données, comme le fait zeroclaw plugin search, et crée le répertoire des plugins s’il est absent.

Si Quickstart n’a pas pu lire la section [plugins] du fichier de configuration, parce que cette section ou le fichier entier est mal formé, la ligne l’indique au lieu d’interroger le registre. Elle ne propose rien à sélectionner, et Créer n’installe aucun plugin. Corrigez le fichier, puis relancez Quickstart pour installer les plugins.

Si le fichier de configuration a été écrit par une version plus ancienne de ZeroClaw, Create s’arrête avant d’installer le moindre plugin ou de créer l’agent, et affiche la commande zeroclaw config migrate qui met à jour le fichier, comme le fait zeroclaw plugin bind. Exécutez cette commande, puis relancez Quickstart. Enregistrer les paramètres des plugins dans l’ancien fichier le marquerait comme à jour sans déplacer ses anciens paramètres, que les exécutions suivantes cesseraient alors de lire.

Lorsque vous choisissez Create, Quickstart installe les plugins sélectionnés avant de créer l’agent. Il vérifie d’abord le reste de vos choix, ainsi que la configuration dans laquelle ils seront enregistrés, de la même manière que le fera l’étape de l’agent, y compris la vérification d’autorisation que cette étape effectue avant d’écrire quoi que ce soit. Si l’étape de l’agent refuserait ces choix, par exemple parce qu’un profil de permissions désigne un agent qui n’existe plus, Quickstart signale les problèmes et s’arrête avant que le moindre plugin ne soit téléchargé ou écrit. Il installe ensuite les plugins un par un, via le pipeline utilisé par zeroclaw plugin install :

1. Il résout le paquet depuis le registre et refuse une entrée de registre qui n’a pas de condensat sha256 pour son archive, avant de demander l’archive. zeroclaw plugin install ne vérifie le condensat que lorsque le registre en fournit un ; le démarrage rapide l’exige.
2. Il télécharge et vérifie l’archive, confirme que le manifeste fournit un outil, admet le paquet, vérifie que son entrée de configuration peut être initialisée, puis exécute la vérification de chargement à l’installation. Si l’une de ces étapes échoue, Quickstart le signale, n’écrit rien pour ce plugin et passe au suivant. La vérification de l’entrée de configuration échoue, par exemple, lorsque la configuration contient encore l’entrée pré-1.0 du plugin, nommée uniquement d’après le paquet, que zeroclaw plugin remove conserve : zeroclaw plugin install refuse alors de créer une entrée à côté, et Quickstart signale la même raison avant de poser la moindre question sur le plugin. Quickstart n’a pas de --no-verify : pour un plugin qui échoue à la vérification de chargement, il affiche la commande zeroclaw plugin install <name> --no-verify, qui installe un plugin que le démon ignore ensuite au démarrage. Cette commande relève de la CLI du plugin, et non de Quickstart : elle ne pose ni question de signature ni question d’accès réseau, et une entrée de configuration qu’elle crée est initialisée avec les destinations que le manifeste déclare pour http_client.
3. Il affiche ce qu’est le plugin et ce qu’il demande : nom, version, auteur, description, capacités, autorisations et destinations réseau déclarées dans son manifeste. Le texte fourni par l’éditeur est d’abord débarrassé des séquences de contrôle du terminal.
4. Il vérifie la signature du manifeste par rapport à plugins.security.trusted_publisher_keys, quelle que soit la valeur de plugins.security.signature_mode, et ajoute une seule ligne à ce résumé : vérifiée, avec les 16 premiers caractères de la clé de confiance ; non signée ; signée avec une clé non fiable ; ou invalide. Sauf si la signature est vérifiée, la ligne de l’auteur est marquée comme étant la déclaration propre de l’éditeur, et Quickstart demande s’il faut tout de même installer le plugin avant toute autre question à son sujet. La réponse par défaut est non, ce qui ignore le plugin et n’écrit rien. signature_mode détermine toujours ce que l’admission refuse : en mode strict, un tel plugin est refusé à l’étape 2 à la place. Lorsque Quickstart peut lire le répertoire des plugins, un plugin choisi déjà installé affiche la même ligne, sans la question.
5. Pour un plugin qui demande http_client et déclare des destinations, vous choisissez entre accorder les destinations déclarées, installer sans accès réseau ou ignorer le plugin. Le choix se porte par défaut sur l’installation sans accès réseau ; l’accepter tel quel n’accorde donc rien. L’installation sans accès réseau crée l’entrée de configuration du plugin avec un egress_hosts vide, de sorte que le plugin n’atteint aucune destination, et affiche la commande zeroclaw config set exacte qui accordera ultérieurement les destinations déclarées. C’est la décision qu’enregistre zeroclaw plugin bind --egress none pour une instance de canal, et cette commande affiche la même commande. Un plugin qui demande un accès réseau sans déclarer de destinations ne pose aucune question ; après son installation, Quickstart affiche une commande zeroclaw config set --no-interactive pour egress_hosts de l’entrée, sans valeur : ajoutez-y les hôtes utilisés par votre déploiement, sous forme d’une valeur unique séparée par des virgules. Exécutée telle qu’affichée, cette commande est refusée faute de valeur et n’écrit rien. Un plugin qui déclare des destinations et demande websocket_client ou socket_client, mais pas http_client, ne pose pas davantage de question : son entrée de configuration n’accorde aucun de ces accès, et Quickstart affiche la commande zeroclaw config set qui accorde exactement ces destinations.
6. Pour un plugin dont le manifeste contient un config_schema, Quickstart demande les paramètres décrits par le schéma : d’abord les propriétés obligatoires, et les propriétés facultatives seulement si vous les demandez. Les propriétés marquées x-secret sont masquées pendant la saisie, et les espaces ou sauts de ligne entourant une valeur secrète sont supprimés, comme le fait zeroclaw config set. Une valeur choisie dans une liste est enregistrée exactement telle que le schéma la liste, y compris une chaîne vide, tandis qu’une réponse saisie vide laisse un paramètre facultatif non défini. Les valeurs sont vérifiées par rapport au schéma avant toute écriture ; après un échec de vérification, vous disposez d’une seule tentative supplémentaire, puis Quickstart demande s’il faut installer le plugin sans elles. Appuyer sur Échap à un paramètre obligatoire qui est secret ou choisi dans une liste ignore le plugin. Quickstart ne demande que les propriétés dont le nom respecte la grammaire de clés portable (jusqu’à 128 lettres ASCII, chiffres, ., - et _). Il nomme les autres afin que vous puissiez les définir plus tard avec zeroclaw config set. Lorsqu’une propriété obligatoire fait partie de ces derniers, ou qu’un nom requis par le schéma n’y est pas déclaré, aucune réponse ne pourrait passer la vérification ; Quickstart ne demande donc aucun paramètre et passe directement à la question d’installation du plugin sans elles. Lorsque le schéma exige un nom qu’il ne déclare pas, aucune entrée de configuration ne peut le satisfaire, quelle que soit la valeur écrite par zeroclaw config set ; la question indique alors que l’outil du plugin ne serait pas utilisable et demande s’il faut l’installer quand même.
7. Il publie le paquet et initialise son entrée de configuration dans la même transaction que zeroclaw plugin install, puis enregistre les paramètres de la même manière que zeroclaw config set. Si l’initialisation de l’entrée échoue, la transaction supprime à nouveau le paquet. Si cette suppression échoue également, Quickstart indique que le plugin est toujours installé et affiche la commande zeroclaw plugin remove correspondante. Si l’enregistrement des paramètres échoue, le plugin reste installé, et Quickstart affiche la commande zeroclaw config set pour chaque paramètre, qui demande la valeur. Un plugin qui fournit aussi un canal reçoit ce qu’affiche zeroclaw plugin install pour lui : les commandes zeroclaw plugin bind qui lient une instance, ou l’état de préparation des alias qui lient déjà le paquet. Quickstart ne lie lui-même aucune instance de canal.

Les valeurs que vous saisissez pour les paramètres non marqués x-secret sont affichées à l’invite, et une valeur par défaut issue du schéma y est pré-remplie. Les valeurs des paramètres ne sont jamais écrites dans les journaux ni dans les lignes d’état qu’affiche Quickstart ; celles-ci ne nomment que les paramètres.

Un plugin déjà installé n’est ni téléchargé, ni mis à niveau, ni invité à nouveau à saisir ses paramètres. Quickstart ne crée son entrée de configuration que lorsque cette entrée est absente. Une nouvelle entrée constitue une nouvelle autorisation : pour un plugin qui demande http_client et déclare des destinations, vous voyez d’abord ce qu’est le plugin et faites le même choix que pour une installation neuve : accorder les destinations déclarées, créer l’entrée sans accès réseau, ou ignorer, ce qui laisse l’entrée absente et affiche la commande qui la créera plus tard. Cette commande crée l’entrée sans accès réseau. La commande qui accorde les destinations déclarées est affichée sur sa propre ligne, à exécuter après la précédente, afin que l’exécution d’une commande affichée n’accorde jamais ce que vous avez refusé. Toute autre entrée absente est initialisée comme le fait zeroclaw plugin install. Une entrée existante n’est jamais modifiée, qu’elle appartienne à un plugin installé ou qu’elle ait été laissée par une installation antérieure ; son autorisation de sortie réseau et ses paramètres restent donc exactement tels quels. Relancer Quickstart avec les mêmes choix ne télécharge donc rien et laisse ces entrées intactes. Si Quickstart ne peut pas terminer la configuration d’un plugin déjà installé, par exemple parce que la configuration contient encore une entrée pré-1.0 nommée uniquement d’après le paquet ou parce que l’enregistrement de la nouvelle entrée échoue, il n’écrit rien pour ce plugin et indique que le plugin reste installé, en précisant la raison.

Après le dernier plugin, si au moins un plugin sélectionné est installé et que plugins.enabled ou plugins.auto_discover est désactivé, Quickstart demande une seule fois si l’activation des plugins doit être activée. Il affiche d’abord la liste des paramètres qui seraient modifiés et de tout ce qui deviendrait actif en conséquence : chaque plugin d’outil et de compétence installé, y compris les plugins installés avant cette exécution, et, lorsque plugins.enabled est désactivé, chaque canal [channels.plugin.<alias>] activé. La liste est lue depuis le répertoire des plugins, tel qu’un démon le chargerait à son prochain démarrage ; elle mentionne donc aussi un plugin dont l’installation échouée n’a pas pu être annulée. Chaque plugin listé dont la signature n’est pas vérifiée est suivi de sa ligne de signature de l’étape 4, y compris un plugin que cette exécution n’a pas sélectionné. La réponse vaut oui par défaut lorsque la liste correspond aux plugins que cette exécution a installés ou conservés, et non par défaut lorsqu’elle activerait autre chose, y compris un plugin installé dont l’entrée de configuration manquante a été ignorée sur votre choix ou que Quickstart n’a pas pu configurer entièrement. Si le répertoire des plugins ne peut pas être lu, Quickstart indique que la liste peut être incomplète et la réponse vaut non par défaut. Refuser laisse les deux paramètres inchangés et affiche les commandes zeroclaw config set permettant de les activer plus tard. Lorsque les deux paramètres sont déjà activés, il n’y a rien à demander.

Une fois l’agent créé, Quickstart affiche l’état de chaque plugin sélectionné et installé : admis en tant qu’outil, avec la clé de son entrée de configuration, ou la raison de son refus, par exemple plugins.enabled ou plugins.auto_discover désactivé, ou la limite plugins.max_active_instances atteinte. Un plugin n’est signalé comme admis que si son entrée de configuration passe la vérification des paramètres que le runtime applique à chaque appel. Être admis ne signifie pas encore être enregistré : le registre d’outils enregistre le plugin lors de sa prochaine construction, et il refuse toujours un paquet dont le nom entre en conflit avec un outil déjà enregistré, comme un outil intégré, ou dont il ne peut pas lire la description de l’outil. Le journal d’exécution enregistre ces refus. Si la vérification des paramètres échoue, par exemple lorsque vous avez installé le plugin sans ses paramètres requis, son état affiche la raison donnée par la vérification, nomme les paramètres requis manquants et affiche la commande zeroclaw config set qui demande chaque valeur. Quickstart n’affiche de commandes que pour les noms de paramètres conformes à la grammaire portable des clés, qui peuvent être affichés et collés dans un shell sans risque. Un paramètre requis dont le nom ne respecte pas cette grammaire est nommé sans commande : définissez-le dans le fichier de configuration, ou avec une commande zeroclaw config set que vous citez vous-même. Un nom requis que le schéma du plugin ne déclare pas est également nommé, car aucune entrée de configuration ne peut satisfaire ce schéma tant que l’éditeur du plugin ne l’a pas corrigé. Un plugin dont l’entrée de configuration est absente, par exemple parce que vous avez ignoré sa création, n’est pas non plus signalé comme actif : zeroclaw config set ne modifie que les entrées existantes ; son état affiche donc la commande qui crée l’entrée à la place. Cette commande n’accorde aucun accès réseau ; pour un plugin qui demande http_client et déclare des destinations, une ligne distincte donne la commande qui les accorde une fois l’entrée existante. Lorsque la configuration contient encore l’entrée pré-1.0 du plugin, nommée uniquement d’après le paquet, son état n’affiche aucune des deux commandes, car une nouvelle entrée à côté de l’ancienne laisserait les paramètres et l’accès réseau de l’ancienne entrée en place. Il indique plutôt la clé d’instance vers laquelle renommer l’ancienne entrée. Lorsque zeroclaw plugin list affiche les étapes de mise à jour de cette entrée, ce qu’il fait pour un plugin qui demande http_client, sauf si le déploiement refuse l’accès réseau de tous les plugins, l’état donne aussi cette commande : ses étapes incluent tout accès réseau que l’entrée renommée requiert encore. Un plugin sans rien à configurer ni accès réseau n’a pas besoin d’entrée de configuration.

Un plugin déjà installé et choisi n’a peut-être jamais passé la vérification de chargement, par exemple lorsqu’il a été installé avec zeroclaw plugin install --no-verify. Quickstart exécute donc la vérification que lance zeroclaw plugin info avant d’afficher le plugin. Si le plugin ne se charge pas sur cet hôte, ZeroClaw l’ignore au démarrage : son statut l’indique au lieu de le présenter comme actif, et donne la commande zeroclaw plugin info qui permet de voir pourquoi.

Quickstart écrit le fichier de configuration et n’envoie jamais de signal à un démon en cours d’exécution. Un démon déjà lancé conserve la configuration qu’il a chargée : les entrées de configuration, paramètres, autorisations réseau et modifications d’activation des plugins écrits par une exécution de Quickstart ne lui parviennent donc qu’après son redémarrage ou le rechargement de sa configuration. Si l’activation des plugins était déjà active dans la configuration chargée par le démon, celui-ci peut charger un plugin nouvellement installé plus tôt, lors de la prochaine construction de son registre d’outils (par exemple pour une nouvelle session). Il exécute alors le plugin avec l’entrée de configuration qu’il avait chargée pour ce plugin, jamais avec une entrée écrite par l’exécution : sans entrée, le plugin n’a ni paramètres ni autorisation réseau, et une entrée plus ancienne, telle que celle que zeroclaw plugin remove a conservée lors d’une installation précédente, s’applique avec ses paramètres et son autorisation réseau. Le statut se termine par la commande zeroclaw service restart, adressée au même répertoire de configuration, qui redémarre un démon exécuté en tant que service installé. zeroclaw agent et les autres commandes ponctuelles prennent les modifications en compte à leur prochain démarrage.

Ctrl+C ne se comporte pas de la même façon partout dans l’étape des plugins. Sur un paramètre secret, il agit comme Échap : sur un paramètre obligatoire, il annule les réglages de ce plugin, qui est alors ignoré ; sur un paramètre facultatif, il laisse le paramètre non défini. Quickstart poursuit ensuite. Partout ailleurs dans l’étape, Ctrl+C met fin immédiatement à Quickstart, sans récapitulatif de ce qui a déjà été fait. Un plugin dont l’installation s’est terminée reste installé et configuré, et zeroclaw plugin list l’affiche. Un plugin interrompu après son installation mais avant l’écriture de son entrée de configuration reste installé sans cette entrée ; relancer Quickstart avec le même choix crée l’entrée, en demandant d’abord confirmation si elle doit accorder des destinations réseau.

Si l’étape de l’agent échoue encore alors que l’étape des plugins a modifié quelque chose, Quickstart n’affirme pas qu’aucune modification n’a été effectuée. Il indique les plugins qui restent installés, configurés ou activés, et affiche la commande zeroclaw plugin remove pour chaque plugin installé lors de cette exécution, y compris celui dont l’installation échouée n’a pas pu être annulée et qui reste donc dans le répertoire des plugins. Relancer Quickstart ne réinstalle pas ces plugins.

La feuille de route d’architecture (FND-001, RFC #5574, livrable D4) demande que zeroclaw onboard installe des plugins. zeroclaw quickstart, la commande maintenue vers laquelle zeroclaw onboard pointe désormais, assure cela pour les plugins d’outils, dans les builds avec prise en charge des plugins. L’installation de plugins de canal pendant l’onboarding et la livraison d’artefacts de version avec prise en charge des plugins sont des livrables distincts.

zerocode

Dans l’interface de terminal zerocode, le panneau Quickstart est l’un des onglets. Pilotez-le avec le clavier :

Basculez vers le volet Quickstart :

You can also choose » Quickstart in the agent sidebar. Pressing Esc returns to the pane that opened Quickstart, whether you entered from the keyboard mode bar, a mode-bar click, or the sidebar launcher.

Wait, I need to translate this to French, not return it unchanged. Here is the translation:

Vous pouvez également choisir » Quickstart dans la barre latérale de l’agent. Appuyer sur Esc revient au volet qui a ouvert Quickstart, que vous y soyez entré depuis la barre de modes du clavier, un clic sur la barre de modes ou le lanceur de la barre latérale.

À l’intérieur du volet :

La souris fonctionne aussi : cliquez sur un onglet dans la barre de mode pour changer de volet, cliquez sur une étape pour la sélectionner et l’ouvrir, et faites défiler pour parcourir la liste.

Chaque étape ouvre une fenêtre modale qui reflète la liste de vérification ci-dessus, avec une option « Use existing » qui répertorie les alias correspondants déjà présents dans votre configuration.

Passerelle Web

Avec le démon en cours d’exécution, ouvrez le tableau de bord dans un navigateur :

zeroclaw daemon

zeroclaw daemon exécute le runtime complet : la passerelle, vos canaux configurés, le planificateur et le moniteur de heartbeat. (zeroclaw gateway démarre uniquement la passerelle HTTP si c’est tout ce dont vous avez besoin.)

Visitez ensuite http://127.0.0.1:42617/quickstart. Une nouvelle installation sans agents configurés y redirige automatiquement ; vous pourrez ensuite toujours y accéder depuis la navigation du tableau de bord.

Le formulaire web présente les mêmes étapes sous forme de cartes. Lors de l’envoi, il applique votre soumission via le démon (POST /api/quickstart/apply), qui renvoie une liste d’erreurs structurée si quelque chose est invalide, puis recharge le démon sur place afin que le nouvel agent soit actif sans redémarrage. Un point de terminaison distinct POST /api/quickstart/validate exécute les mêmes vérifications sans les appliquer, pour les clients qui souhaitent valider au préalable.

Après le démarrage rapide

• Pilotez-le depuis zerocode : l’interface en terminal est le meilleur moyen de discuter, consulter les journaux en direct, gérer la configuration et surveiller le démon, le tout au même endroit. Exécutez simplement zerocode.
• Petite commande ponctuelle depuis le shell : zeroclaw agent -a <alias> -m "your message".
• Exécution permanente : zeroclaw service install && zeroclaw service start.
• Ajouter des canaux plus tard : Canaux → Vue d’ensemble.
• Ajuster l’autonomie et les budgets : Référence → Config.