Start

Assistant d'Intégration (CLI)

Utilisez l'assistant CLI pour configurer Clawdbot avec une configuration guidée pour Gateway, canaux, compétences et paramètres par défaut de l'espace de travail.

Aperçu

L'assistant d'intégration est la méthode de configuration recommandée pour Clawdbot sur macOS, Linux ou Windows (via WSL2). Il fournit un flux de configuration guidé pour les connexions Gateway locales ou distantes, les canaux, les compétences et les paramètres par défaut de l'espace de travail.

Commandes Principales

CommandeDescription
clawdbot onboardAssistant de configuration principal
clawdbot dashboardOuvre l'UI de Contrôle pour le chat navigateur
clawdbot configureReconfigurer l'installation existante
clawdbot configure --section webConfigurer la recherche web (Brave Search API)

Modes de Configuration

Démarrage Rapide (Recommandé)

Configuration par défaut pour la plupart des utilisateurs :

  • Gateway local sur loopback
  • Port 18789 avec authentification par jeton
  • DMs Telegram/WhatsApp utilisent le mode allowlist

Mode Avancé

Contrôle total sur toutes les étapes de configuration pour les utilisateurs avancés.

Flux de Configuration

1. Détection de Configuration Existante

L'assistant détecte ~/.clawdbot/clawdbot.json et propose :

  • Conserver - Utiliser la configuration existante
  • Modifier - Mettre à jour des paramètres spécifiques
  • Réinitialiser - Repartir de zéro

2. Modèle et Authentification

Choisissez votre fournisseur d'IA :

FournisseurDescription
Anthropic API KeyRecommandé pour les meilleures performances
Anthropic OAuthPour les abonnés Claude Pro/Max
OpenAI API KeyGPT-4 et autres modèles
OpenAI CodexAbonnement orienté code
Vercel AI GatewayOption proxy
Modèles LocauxFonctionnement hors ligne

3. Configuration de l'Espace de Travail

Espace de travail par défaut : ~/.clawdbot/workspace

Fichiers d'amorçage créés :

  • AGENTS.md - Configuration de l'agent
  • SOUL.md - Paramètres de personnalité
  • TOOLS.md - Outils disponibles
  • IDENTITY.md - Informations d'identité

4. Configuration du Gateway

Configurez les paramètres de votre Gateway :

  • Port : Par défaut 18789
  • Adresse de Liaison : Loopback ou réseau
  • Mode d'Authentification : Basé sur jeton (recommandé)
  • Tailscale : Exposition distante optionnelle

5. Configuration des Canaux

Intégrations optionnelles :

  • WhatsApp
  • Telegram
  • Discord
  • Slack
  • Signal
  • iMessage
  • Google Chat
  • Mattermost

6. Installation du Démon

  • macOS : LaunchAgent
  • Linux/WSL2 : unité utilisateur systemd

7. Vérification de Santé

Valide le démarrage du Gateway et la connectivité.

8. Installation de Compétences

Packages de compétences optionnels via npm/pnpm.

Mode Distant

Se connecter à un Gateway existant fonctionnant ailleurs :

clawdbot onboard --remote

Aucune installation n'est effectuée sur l'hôte distant - configure uniquement la connexion du client local.

Mode Non Interactif

Pour l'automatisation et les scripts :

clawdbot onboard --non-interactive \
  --auth-choice anthropic \
  --anthropic-api-key $ANTHROPIC_API_KEY

Agents Multiples

Créer des instances d'agents isolées :

clawdbot agents add work
clawdbot agents add personal
clawdbot agents list

Chaque agent possède son propre espace de travail et sa configuration.

Prochaines Étapes