Intégration de l'App macOS

Aperçu

Ce guide décrit l'expérience d'intégration du premier lancement de l'application macOS de Clawdbot, couvrant la configuration depuis le lancement initial jusqu'à l'amorçage de l'agent.

Flux de Configuration

L'intégration suit 8 étapes :

Étape 1 : Bienvenue

Écran de bienvenue initial avec un avis de sécurité sur les capacités de Clawdbot.

Étape 2 : Sélection du Gateway

Choisissez votre mode Gateway :

Étape 3 : Authentification

Pour les configurations locales, authentifiez-vous auprès de votre fournisseur d'IA :

• Anthropic OAuth - Pour les abonnés Claude Pro/Max
• Anthropic API Key - Accès direct à l'API
• OpenAI - Modèles GPT
• Autres Fournisseurs - Diverses options

Le flux OAuth ouvre votre navigateur pour l'authentification PKCE. Collez la valeur code/état lorsqu'on vous le demande.

Identifiants stockés dans : ~/.clawdbot/credentials/oauth.json

Étape 4 : Assistant de Configuration

Configuration pilotée par Gateway pour :

• Paramètres de port et réseau
• Intégrations de canaux
• Installation de compétences

Étape 5 : Permissions

macOS nécessite des autorisations explicites :

Accordez les permissions selon les demandes. Certaines fonctionnalités nécessitent des permissions spécifiques pour fonctionner.

Étape 6 : Installation du CLI

Installation optionnelle de la commande globale clawdbot :

# Installé dans /usr/local/bin/clawdbot
clawdbot --version

Étape 7 : Chat d'Intégration

Une session dédiée pour l'introduction de l'agent :

• L'agent crée l'espace de travail (~/.clawdbot/workspace)
• Initialise les fichiers : AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md
• Effectue des Q&R pour personnaliser votre expérience
• Apprend vos préférences et cas d'utilisation

Étape 8 : Prêt

Configuration terminée. Vous pouvez maintenant :

• Discuter avec votre assistant
• Configurer des canaux supplémentaires
• Installer des compétences
• Personnaliser votre espace de travail

Modes Gateway

Mode Local

• Gateway s'exécute sur votre Mac
• Les flux OAuth fonctionnent directement
• Identifiants stockés localement
• Idéal pour un usage personnel

Mode Distant

Lors de l'utilisation d'un Gateway distant :

• Tous les identifiants résident sur l'hôte Gateway
• Les fichiers de l'espace de travail sont sur la machine distante
• Le Mac local agit uniquement comme client
• Utile pour les déploiements partagés ou sur serveur

Amorçage de l'Agent

Au premier lancement, l'agent :

1. Crée le répertoire de l'espace de travail
2. Initialise les fichiers d'instructions
3. Effectue des Q&R de personnalisation
4. Configure les préférences initiales

Fichiers d'Amorçage

Dépannage

Problèmes de Permissions

Si les fonctionnalités ne marchent pas :

1. Ouvrez Préférences Système → Confidentialité et Sécurité
2. Vérifiez chaque catégorie de permissions
3. Assurez-vous que Clawdbot est activé
4. Redémarrez l'app si nécessaire

Échecs OAuth

Si l'authentification échoue :

1. Vérifiez votre connexion internet
2. Confirmez le statut de votre abonnement
3. Essayez de saisir la clé API manuellement
4. Vérifiez ~/.clawdbot/credentials/ pour les problèmes

Le Gateway Ne Démarre Pas

1. Vérifiez si le port 18789 est disponible
2. Consultez les logs dans /tmp/clawdbot/
3. Essayez clawdbot health depuis le terminal

Prochaines Étapes

• Guide d'Installation - Configuration détaillée
• Construire un Assistant - Créez votre assistant
• Canaux - Connecter les plateformes de messagerie