Onboarding
A first run does not open the wizard. OpenCrabs goes straight to the chat, with its built-in provider already provisioned and the agent greeting you. The onboarding wizard is opt-in: run opencrabs --onboard, or /onboard from inside a session.
Les vidéos pas à pas se trouvent sur la page Vidéos d’onboarding.
Démarrage rapide (3 minutes)
La voie rapide vous permet de discuter avec l’agent en moins de 3 minutes.
| Étape | Action |
|---|---|
| 1. Mode | Appuyez sur Enter sur QuickStart |
| 2. Espace de travail | Appuyez sur Enter pour accepter le chemin par défaut |
| 3. Provider | Utilisez les flèches pour aller à votre provider (par ex. z.ai), puis appuyez sur Enter. Utilisez la flèche bas pour choisir un forfait (par ex. Coding), puis appuyez sur Enter |
| 4. Clé API | Collez votre clé (Cmd+V / Ctrl+V / Cmd+Shift+V / Ctrl+Shift+V), puis appuyez sur Enter. La liste des models se charge en direct |
| 5. Model | Utilisez les flèches pour aller à votre model (par ex. gemini-2.5-pro), puis appuyez sur Enter |
| 6. Daemon | Utilisez les flèches pour choisir si OpenCrabs doit tourner en daemon en arrière-plan, puis appuyez sur Enter |
| 7. Vibe Check | Toutes les vérifications doivent afficher ✅. Appuyez sur Enter |
| 8. À propos de vous | Écrivez quelques lignes sur vous. Plus l’agent en sait, mieux c’est. Appuyez sur Enter |
| 9. À propos de l’agent | Décrivez la personnalité de l’agent. Appuyez sur Enter |
| 10. Chat | Vous êtes prêt. Commencez à parler à votre agent |
Configuration avancée (7 minutes)
Configuration complète avec Telegram, la voix locale, la vision et la génération d’images.
| Étape | Action |
|---|---|
| 1. Mode | Appuyez sur Enter sur QuickStart |
| 2. Espace de travail | Appuyez sur Enter pour accepter le chemin par défaut |
| 3. Provider | Utilisez les flèches pour aller à votre provider (par ex. z.ai), puis appuyez sur Enter. Utilisez la flèche bas pour choisir un forfait, puis appuyez sur Enter |
| 4. Clé API | Collez votre clé, puis appuyez sur Enter. La liste des models se charge en direct |
| 5. Model | Utilisez les flèches pour aller à votre model, puis appuyez sur Enter |
| 6. Channels | Utilisez les flèches pour aller à Other, appuyez sur Space pour sélectionner Telegram, puis sur Enter. Collez votre token de bot, suivez les instructions pour obtenir votre chat ID, puis appuyez sur Enter. Choisissez le mode mention, puis appuyez sur Enter. Une fois que Connected s’affiche, appuyez de nouveau sur Enter. Utilisez la flèche bas pour aller à Continue, puis appuyez sur Enter |
| 7. STT | Sélectionnez Local, puis appuyez sur Enter. Choisissez la taille du model (par ex. tiny pour la vitesse), puis appuyez sur Enter |
| 8. TTS | Sélectionnez de nouveau Local, puis appuyez sur Enter. Choisissez une voix (par ex. Ryan), puis appuyez sur Enter. Attendez la fin du téléchargement du model, utilisez la flèche bas pour aller à Continue, puis appuyez sur Enter |
| 9. Image | Appuyez sur Space pour sélectionner Vision et Génération d’images, puis appuyez sur Enter. Collez votre clé API Gemini, puis appuyez sur Enter |
| 10. Daemon | Utilisez les flèches pour choisir si OpenCrabs doit tourner en daemon en arrière-plan, puis appuyez sur Enter |
| 11. Vibe Check | Toutes les vérifications doivent afficher ✅. Appuyez sur Enter |
| 12. À propos de vous | Écrivez quelques lignes sur vous. Plus l’agent en sait, mieux c’est. Appuyez sur Enter |
| 13. À propos de l’agent | Décrivez la personnalité de l’agent. Appuyez sur Enter |
| 14. Chat | Vous êtes prêt. Commencez à parler à votre agent |
Déroulement de l’onboarding
L’assistant est une interface TUI pilotée au clavier, en 8 étapes. Naviguez avec les flèches, Tab pour avancer et Esc pour revenir en arrière.
| Étape | Écran | Ce que vous faites |
|---|---|---|
| 1 | Choix du mode | Choisissez QuickStart (sans les channels) ou Advanced |
| 2 | Espace de travail | Choisissez un répertoire de travail pour les opérations sur les fichiers |
| 3 | Provider et authentification | Choisissez le provider → collez la clé API → choisissez le model (récupéré en direct) |
| 4 | Channels | Space pour activer ou désactiver les channels → Enter sur chacun pour le configurer |
| 5 | Voix | Provider STT (Groq, Whisper local ou désactivé) + voix TTS |
| 6 | Image | Activation de la vision + model de génération + clé API |
| 7 | Daemon | Installer le daemon en arrière-plan (facultatif) |
| 8 | Configuration du brain | Générer automatiquement SOUL.md à partir de votre profil |
Configuration des channels (étape 4)
L’écran des channels liste 5 intégrations : Telegram, Discord, WhatsApp, Slack, Trello.
Spaceactive ou désactive un channelEntersur un channel activé ouvre son écran de configuration (token, identifiants, listes d’autorisation)Entersur Continue ouTabpasse à l’étape suivante- Chaque écran de configuration de channel possède un bouton Test Connection
Consultez Vue d’ensemble des channels pour le guide de navigation complet.
Relancer la configuration
Vous pouvez accéder directement à n’importe quelle étape sans relancer tout l’assistant :
| Commande | Étape |
|---|---|
/onboard | Assistant complet |
/onboard:provider | Choix du provider et du model |
/onboard:channels | Sélection des channels |
/onboard:voice | Configuration de la voix |
/onboard:image | Configuration de l’image |
/onboard:brain | Génération des brain files |
Après l’onboarding, votre agent démarre et se présente. Il lit ses brain files (SOUL.md, AGENTS.md, TOOLS.md) et lance une conversation.
Amorçage
Au tout premier lancement, l’agent passe par une phase d’amorçage :
- Apprend à vous connaître (nom, préférences, manière de travailler)
- Définit son identité (nom, personnalité, emoji)
- Ouvre
SOUL.mdavec vous pour discuter des valeurs - Met en place
USER.mdavec votre profil
Le fichier d’amorçage (BOOTSTRAP.md) se supprime automatiquement une fois terminé.
Migration depuis un autre outil
Vous utilisez déjà ClaudeCode, OpenClaw, Hermes ou un autre harness d’agent IA ? Votre agent peut migrer vos données existantes (mémoire, skills, commandes personnalisées, préférences) vers ses propres brain files, en langage naturel. Aucune manipulation manuelle de fichiers n’est nécessaire.
Cela fonctionne avec tout agent ou harness de code qui stocke sa configuration en local. La migration recherche dans votre système de fichiers les répertoires de configuration de l’autre outil, lit leur contenu et le transpose dans le format de brain files d’OpenCrabs (SOUL.md, USER.md, TOOLS.md, MEMORY.md, AGENTS.md, CODE.md).
Migration guidée
Si vous souhaitez vérifier ce qui sera migré avant que cela n’ait lieu :
Recherchez mes données ClaudeCode/OpenClaw/Hermes en local (ou tout autre harness d’agent que j’utilisais), auditez une migration vers nos propres brain files, faites-moi un rapport une fois terminé, et exécutez-la quand je confirme et approuve.
L’agent va :
- Rechercher dans votre système de fichiers les répertoires de configuration de l’autre outil
- Lire et analyser tous les fichiers pertinents (mémoire, commandes, skills, préférences)
- Produire un audit indiquant exactement ce qui correspond à quoi
- Attendre votre confirmation
- Exécuter la migration et fournir un bilan complet
Migration autonome
Si vous voulez simplement que ce soit fait :
Recherchez mes données d’agent ou de harness existantes en local et migrez tout vers nos propres brain files, sans attendre mon approbation. Lancez-vous, planifiez et exécutez, puis faites-moi un bilan complet une fois terminé.
L’agent saute l’étape d’audit, planifie la migration en interne, l’exécute et vous donne un résumé de tout ce qui a été déplacé.
Ce qui est transposé
| Source | Destination | Exemple |
|---|---|---|
| Mémoire / CLAUDE.md / fichiers de contexte | MEMORY.md | Décisions de projet, contexte passé |
| Commandes personnalisées | commands.toml | Commandes slash et leurs définitions |
| Skills / instructions de l’agent | AGENTS.md, TOOLS.md | Règles de workflow, configurations d’outils |
| Préférences / profil de l’utilisateur | USER.md | Nom, fuseau horaire, style de code |
| Standards de code / règles de linting | CODE.md | Guides de style, conventions |
Astuce : Lancez la migration juste après l’onboarding, tant que le contexte est frais. L’agent dispose déjà de votre
USER.mdet de votreSOUL.mdissus de l’assistant : il peut donc fusionner intelligemment au lieu d’écraser.
Commandes principales
| Commande | Description |
|---|---|
/help | Afficher toutes les commandes disponibles |
/models | Changer de provider ou de model |
/new | Créer une nouvelle session |
/sessions | Passer d’une session à l’autre |
/cd | Changer de répertoire de travail |
/compact | Compacter manuellement le contexte |
/evolve | Télécharger la dernière version |
/rebuild | Compiler depuis les sources |
/approve | Définir la politique d’approbation |
Modes d’approbation
Contrôlez le niveau d’autonomie de l’agent :
| Mode | Comportement |
|---|---|
/approve | Demander avant chaque utilisation d’outil (par défaut) |
/approve auto | Approbation automatique pour cette session |
/approve yolo | Approbation automatique permanente (conservée) |
Répertoire de travail
L’agent travaille dans un répertoire de travail pour ses opérations sur les fichiers. Modifiez-le avec :
- La commande
/cddans le chat - Le sélecteur de répertoire dans le TUI (Tab pour sélectionner)
- L’outil
config_manager set_working_directory
Le répertoire de travail est conservé par session. Changer de session restaure automatiquement le répertoire.
Indication de filtre des models (v0.3.78)
Le sélecteur de model de l’onboarding affiche désormais toujours une indication de filtre au-dessus de la liste des models (“Tapez pour filtrer…”). Auparavant, cette indication n’apparaissait qu’après la saisie, et les utilisateurs ne savaient pas que le filtrage était disponible. De plus, un ID de model saisi exactement l’emporte désormais sur une correspondance partielle : si vous tapez claude-opus-4-8 exactement, ce model est sélectionné même si d’autres models contiennent la même sous-chaîne.