Construire un Assistant Personnel

Aperçu

Clawdbot sert de passerelle connectant les plateformes de messagerie aux agents IA, vous permettant d'interagir avec un assistant IA via votre application de messagerie préférée.

Considérations de Sécurité

Clawdbot peut exécuter des commandes, accéder aux fichiers et envoyer des messages. Mesures de sécurité importantes :

• Configurez channels.whatsapp.allowFrom pour restreindre l'accès
• Utilisez un numéro de téléphone dédié pour l'assistant
• Commencez avec les heartbeats désactivés ("0m") jusqu'à établir la confiance
• Vérifiez les permissions avant d'accorder l'accès au shell

Prérequis

• Node.js 22+
• Clawdbot installé globalement
• Un second numéro de téléphone pour l'assistant (recommandé)

Architecture Recommandée

Utilisez deux téléphones pour la configuration la plus sécurisée :

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Votre Téléphone│────▶│  Assistant      │────▶│  Votre Ordi     │
│  (Personnel)    │     │  Numéro Tél.    │     │  (Clawdbot)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Votre appareil personnel envoie des messages à un second téléphone (l'assistant) qui est lié à Clawdbot fonctionnant sur votre ordinateur.

Démarrage Rapide

1. Associer WhatsApp Web

clawdbot channels login whatsapp

Scannez le code QR avec votre téléphone assistant.

2. Démarrer la Passerelle

clawdbot gateway --port 18789

3. Configurer la Liste Autorisée

Éditez ~/.clawdbot/clawdbot.json :

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"],
      "dmPolicy": "allowlist"
    }
  }
}

Espace de Travail et Mémoire

Espace de Travail par Défaut

Emplacement : ~/.clawdbot/workspace

Contient les fichiers d'instructions :

Contrôle de Version

Traitez votre espace de travail comme un dépôt git pour la sauvegarde :

cd ~/.clawdbot/workspace
git init
git add .
git commit -m "Initial workspace"

Sessions

Les sessions sont stockées par expéditeur. Commandes pour gérer les sessions :

Heartbeats (Tâches Proactives)

Les heartbeats sont des vérifications périodiques où l'agent lit HEARTBEAT.md pour les tâches.

Configuration

Dans ~/.clawdbot/clawdbot.json :

{
  "heartbeat": {
    "interval": "30m",
    "enabled": true
  }
}

Comportement

• Par défaut : Toutes les 30 minutes
• L'agent lit HEARTBEAT.md pour les tâches en attente
• Répond avec HEARTBEAT_OK si rien ne nécessite d'attention
• Configurez à "0m" pour désactiver

Exemple de HEARTBEAT.md

# Tâches Heartbeat

- Vérifier les nouveaux e-mails et résumer les importants
- Consulter le calendrier pour les réunions à venir
- Surveiller les prix des actions pour AAPL, GOOGL

Gestion des Médias

Pièces Jointes Entrantes

Clawdbot peut recevoir et traiter :

• Images
• Documents
• Notes vocales
• Vidéos

Médias Sortants

Envoyez des médias en utilisant la syntaxe MEDIA:<chemin> :

MEDIA:/path/to/image.png

Opérations

Commandes de Statut

# Vérifier la santé
clawdbot health

# Voir le statut
clawdbot status

# Vérifier les journaux
tail -f /tmp/clawdbot/gateway.log

Journalisation

Les journaux sont stockés dans /tmp/clawdbot/ :

Configuration Multi-Canal

Configurez plusieurs canaux dans clawdbot.json :

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+1234567890"]
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Prochaines Étapes

• Appairage - Configurer le contrôle d'accès
• Vitrine - Voir ce que d'autres ont construit
• Compétences - Étendre avec des plugins