Votre assistant IA est prêt ! 🖥️

Félicitations ! Votre Mac Mini est configuré et prêt à l'emploi avec OpenClaw, votre assistant IA personnel.

Ce que vous avez reçu

• Un Mac Mini avec macOS configuré
• OpenClaw installé et fonctionnel
• Un agent IA avec son workspace dédié
• Un bot Telegram connecté (votre canal de communication principal)

Glossaire rapide

Gateway

Le processus central d'OpenClaw — il fait le lien entre vos apps de messagerie et l'IA.

Agent

Votre assistant IA. Il a sa propre personnalité, mémoire et outils.

Workspace

Le dossier de travail de votre agent — ses fichiers, sa mémoire, ses projets.

Skill

Un module qui donne une capacité à votre agent (email, calendrier, GitHub…).

Heartbeat

Un signal périodique qui permet à l'agent de vérifier s'il y a quelque chose à faire.

Channel

Un canal de communication (Telegram, WhatsApp, Discord…).

Cron Job

Une tâche planifiée qui s'exécute automatiquement à une heure ou un intervalle défini.

Première chose à faire : sécurisez vos accès. La machine a été configurée avec des identifiants temporaires.

1. Mot de passe de session macOS

1. Réglages Système → Utilisateurs et groupes
2. Cliquez sur votre compte → Modifier le mot de passe
3. Choisissez un mot de passe fort et unique

2. Compte Gmail

1. Rendez-vous sur myaccount.google.com/security
2. Changez le mot de passe
3. Activez la vérification en 2 étapes
4. Vérifiez les appareils connectés et retirez ceux que vous ne reconnaissez pas

3. Compte Brave API

Un compte Brave Search API a été créé pour la recherche web de votre agent. Changez le mot de passe de ce compte :

1. Rendez-vous sur brave.com/search/api
2. Connectez-vous avec les identifiants fournis
3. Changez le mot de passe dans les paramètres du compte
4. Gardez la clé API — elle est déjà configurée dans OpenClaw

4. Navigateur (Brave / Chrome)

• Vérifiez les mots de passe enregistrés : brave://settings/passwords
• Supprimez ceux que vous ne reconnaissez pas
• Activez le verrouillage par mot de passe pour accéder aux mots de passe enregistrés

5. Clé API / Token Anthropic

Si une clé API ou un token OAuth est configuré, il a été mis en place pour le setup initial. Voir la section Clés API LLM pour le remplacer par le vôtre.

Telegram est votre canal principal pour communiquer avec votre agent. Voici comment le configurer ou le recréer si besoin.

Créer un bot Telegram

1. Ouvrez Telegram et cherchez @BotFather
2. Envoyez /newbot
3. Choisissez un nom (ex: "Mon Assistant") puis un username (ex: MonAssistant_bot)
4. BotFather vous donne un token — copiez-le

Configurer dans OpenClaw

// ~/.openclaw/openclaw.json
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "VOTRE_TOKEN_BOT",
      "allowFrom": ["VOTRE_TELEGRAM_ID"]
    }
  }
}

Pour trouver votre Telegram ID, envoyez /start à @userinfobot

Redémarrer le Gateway

openclaw gateway restart

Envoyez un message à votre bot — il devrait répondre !

Accédez à votre Mac Mini depuis n'importe où grâce à Tailscale (VPN mesh, gratuit).

1. Installer Tailscale

Sur le Mac Mini (déjà fait si vous avez reçu la machine configurée) :

brew install tailscale

Sur votre machine personnelle : tailscale.com/download

2. Se connecter au même réseau

1. Créez un compte Tailscale (gratuit)
2. Connectez les deux machines au même compte
3. Vos machines reçoivent des IPs en 100.x.x.x

3. Identifiants de connexion

4. Partage d'écran

1. Sur le Mac Mini : Réglages Système → Général → Partage → Activer Partage d'écran
2. Sur votre Mac : Finder → Cmd+K → vnc://100.x.x.x (IP Tailscale du Mini)
3. Entrez le nom d'utilisateur et le mot de passe de la session macOS du Mac Mini

5. SSH

1. Sur le Mac Mini : Réglages Système → Général → Partage → Activer Connexion à distance
2. Depuis votre machine :

   ssh utilisateur@100.x.x.x

   Copier
   Remplacez utilisateur par le nom d'utilisateur macOS du Mini et 100.x.x.x par son IP Tailscale.

6. Web UI OpenClaw

Accédez au dashboard depuis votre navigateur :

http://100.x.x.x:18789

Votre agent a besoin d'un accès à un modèle d'IA (Claude, GPT, etc.) pour fonctionner. Deux méthodes possibles :

Méthode 1 : OAuth via Claude Code (recommandée)

Pas besoin de clé API ni de facturation séparée — vous utilisez votre abonnement Claude (Pro, Team, Enterprise) directement.

Étape 1 : Générer le setup-token

Sur n'importe quelle machine avec Claude Code installé :

claude setup-token

Suivez les instructions — une fenêtre de navigateur s'ouvre pour vous authentifier. Un token est généré à la fin.

Étape 2 : Enregistrer le token dans OpenClaw

Sur le Mac Mini (la machine qui fait tourner OpenClaw), lancez :

openclaw models auth setup-token --provider anthropic

Si vous avez généré le token sur une autre machine, utilisez plutôt :

openclaw models auth paste-token --provider anthropic

Puis collez le token quand demandé.

Étape 3 : Configurer le modèle par défaut

// ~/.openclaw/openclaw.json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6"
      }
    }
  }
}

Étape 4 : Redémarrer

openclaw gateway restart

Méthode 2 : Clé API classique

1. Créez un compte sur console.anthropic.com
2. Générez une clé API
3. Ajoutez-la dans votre configuration :

   // ~/.openclaw/gateway.env
   ANTHROPIC_API_KEY=sk-ant-...

   Copier
4. Redémarrez :

   openclaw gateway restart

   Copier

Votre agent peut chercher sur le web de deux manières très différentes. Comprendre la différence est important.

Recherche classique — Brave Search API

C'est une recherche web traditionnelle, comme Google. L'agent envoie une requête et reçoit une liste de résultats (titre, URL, extrait). Il peut ensuite visiter les pages pour en lire le contenu.

• Résultats structurés et vérifiables
• Gratuit (tier gratuit Brave) ou peu cher
• Configuré par défaut sur votre machine

// Config dans ~/.openclaw/openclaw.json
{
  "tools": {
    "web": {
      "search": {
        "provider": "brave"
      }
    }
  }
}

Recherche IA — Perplexity / Grok

Ici, un modèle d'IA fait la recherche pour vous et synthétise la réponse avec des citations. C'est plus rapide pour obtenir une réponse directe, mais moins vérifiable.

• Réponses synthétisées par IA avec sources
• Idéal pour des questions complexes ou de la veille
• Nécessite une clé API Perplexity ou OpenRouter

// Exemple avec Perplexity via OpenRouter
{
  "tools": {
    "web": {
      "search": {
        "provider": "perplexity",
        "perplexity": {
          "apiKey": "sk-or-v1-...",
          "baseUrl": "https://openrouter.ai/api/v1",
          "model": "perplexity/sonar-pro"
        }
      }
    }
  }
}

Votre agent peut vous aider dans de nombreux domaines. Voici les use cases les plus courants :

🌐 Développement Web

Prérequis à installer :

# Node.js (déjà installé)
node --version

# GitHub CLI
brew install gh
gh auth login

# Vercel CLI
npm install -g vercel
vercel login

Votre agent peut créer des projets, écrire du code, commit, push, déployer sur Vercel — le tout via Telegram.

✅ Exercice de validation

Pour vérifier que tout fonctionne de bout en bout, envoyez ce prompt à votre agent :

Si tout est bien configuré (GitHub CLI, Vercel CLI, clé API), votre agent va :

1. Créer le projet et coder le jeu
2. Initialiser un repo privé sur GitHub et push le code
3. Déployer sur Vercel et vous envoyer le lien

📊 Productivité

• Gestion de calendrier et rappels
• Prise de notes et organisation
• Recherche web et veille
• Automatisation de tâches répétitives

📱 Social Media

• Publication et veille Twitter/X
• Monitoring de mentions
• Rédaction de contenu

🏠 Domotique

• Contrôle Philips Hue (skill openhue)
• Automatisations via scripts

Les skills sont des modules qui donnent des capacités à votre agent. Voici les principaux :

📧 Email — Himalaya

Envoyez et recevez des emails directement depuis votre agent.

# Installer himalaya
brew install himalaya

# Configurer votre compte email
# Fichier : ~/.config/himalaya/config.toml

Une fois configuré, demandez à votre agent : "Lis mes derniers emails" ou "Envoie un email à X".

📅 Google Workspace — gog

Gmail, Calendar, Drive, Contacts, Sheets, Docs.

brew install gog

Nécessite une authentification OAuth avec votre compte Google.

🐙 GitHub

Gestion de repos, issues, PRs, CI/CD.

brew install gh
gh auth login

🔍 Découvrir plus de skills

Parcourez le catalogue complet sur ClawHub — la marketplace officielle de skills OpenClaw.

Les cron jobs permettent à votre agent d'exécuter des tâches automatiquement, sans intervention de votre part. Voici des exemples de prompts à envoyer à votre agent via Telegram ou le chat pour les mettre en place :

🔐 Check sécurité automatique

💾 Backup automatique

📰 Veille tech / nouveautés

📧 Check emails urgent

📅 Rappel agenda quotidien

Quand quelque chose ne marche pas, voici comment diagnostiquer.

Commandes essentielles

# Vérifier le statut
openclaw status

# Redémarrer le gateway
openclaw gateway restart

# Voir les logs en temps réel (heure locale)
openclaw gateway logs --local-time

# Vérifier la config
cat ~/.openclaw/openclaw.json

Erreurs courantes

Créer un autre agent

Vous pouvez avoir plusieurs agents, chacun avec son propre workspace et sa personnalité :

# Ajouter un nouvel agent
openclaw agents add mon-second-agent

# Chaque agent a son propre workspace
# ~/.openclaw/workspace-mon-second-agent/

Backups

Les fichiers importants à sauvegarder :

# Config
~/.openclaw/openclaw.json
~/.openclaw/gateway.env

# Workspace (mémoire, personnalité, fichiers)
~/.openclaw/workspace/

# Credentials
~/.openclaw/credentials/

# Auth profiles
~/.openclaw/agents/*/agent/auth-profiles.json

# Pour un backup complet
cp -r ~/.openclaw/ ~/backup-openclaw-$(date +%Y%m%d)/

Mise à jour OpenClaw

# Mettre à jour
npm update -g openclaw

# Ou via le CLI
openclaw update

📚 Ressources

• Documentation officielle — Guide complet, référence API, configuration avancée
• GitHub OpenClaw — Code source, issues, contributions
• Discord communautaire — Support, échanges, partage de skills
• ClawHub — Marketplace de skills

Questions fréquentes pour mieux comprendre OpenClaw et optimiser votre usage.

🤖 C'est quoi OpenClaw ?

OpenClaw est un assistant IA personnel qui tourne sur votre Mac Mini. Contrairement aux chatbots classiques, il a accès à votre environnement : il peut lire vos emails, gérer votre calendrier, coder des projets, les déployer, contrôler votre domotique, etc. C'est comme avoir un développeur et assistant personnel disponible 24h/7j via Telegram.

💻 Comment fonctionne l'assistant IA sur Mac Mini ?

Votre Mac Mini héberge l'assistant localement. Il utilise des modèles IA comme Claude ou GPT via API, mais tout le traitement et la mémoire restent chez vous. Vous communiquez avec lui via Telegram, WhatsApp ou Discord. Il peut exécuter des commandes, scripter des automatisations, et apprendre de vos habitudes pour devenir plus efficace.

💰 Combien coûte l'installation ?

Les tarifs dépendent de vos besoins : configuration basique (Telegram + IA), setup avancé (skills multiples, automatisations), ou solution sur mesure pour entreprise. Le Mac Mini est fourni pré-configuré. Coûts récurrents : abonnement Claude (~20€/mois) et électricité (~5€/mois). Voir les tarifs détaillés.

📞 Comment contacter le support ?

Support multicanal disponible : WhatsApp (+33763439100) pour l'urgence, email (contact@claw-bot.fr) pour les questions techniques, ou directement via votre assistant configuré. Documentation complète sur docs.openclaw.ai et communauté Discord active.

🔒 Mes données sont-elles sécurisées ?

Sécurité maximale : l'assistant tourne entièrement chez vous, pas dans le cloud. Vos conversations et fichiers ne quittent jamais votre Mac Mini. Communication chiffrée end-to-end avec les plateformes (Telegram, WhatsApp). Accès distant sécurisé via Tailscale VPN.

⚡ Quels sont les cas d'usage les plus populaires ?

Top 5 des usages : 1) Développement web automatisé (GitHub + Vercel), 2) Gestion d'emails et calendrier, 3) Veille et recherche web intelligente, 4) Automatisation domotique (Hue, HomeKit), 5) Support client et FAQ automatiques. L'assistant s'adapte à votre métier et workflow.

🔧 Que faire si ça ne marche pas ?

Debug méthodique : vérifiez d'abord openclaw status, puis consultez les logs avec openclaw gateway logs. Erreurs courantes : token API expiré, bot Telegram mal configuré, ou gateway arrêté. Le guide Debug ci-dessus couvre 90% des problèmes.

📱 Puis-je utiliser d'autres messageries que Telegram ?

Multi-plateformes : WhatsApp, Discord, Slack supportés nativement. Twitter/X pour les notifications. Email via Himalaya. Même des webhooks personnalisés. Telegram reste le plus stable et complet, mais vous pouvez mixer selon vos besoins.