Configuration de l'assistant personnel

OpenClaw est une passerelle auto-hébergée qui connecte Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, et plus encore à des agents IA. Ce guide couvre la configuration de l’« assistant personnel » : un numéro WhatsApp dédié qui se comporte comme votre assistant IA toujours actif.

⚠️ Sécurité d’abord

Vous placez un agent dans une position susceptible de :

exécuter des commandes sur votre machine (en fonction de votre politique d’outil)
lire/écrire des fichiers dans votre espace de travail
renvoyer des messages via WhatsApp/Telegram/Discord/Mattermost et d’autres canaux inclus

Soyez prudent au début :

Définissez toujours channels.whatsapp.allowFrom (n’exécutez jamais une version ouverte au monde sur votre Mac personnel).
Utilisez un numéro WhatsApp dédié pour l’assistant.
Les battements de cœur (Heartbeats) sont désormais réglés par défaut sur toutes les 30 minutes. Désactivez-les jusqu’à ce que vous fassiez confiance à la configuration en définissant agents.defaults.heartbeat.every: "0m".

Prérequis

OpenClaw installé et intégré - voir Getting Started si vous ne l’avez pas encore fait
Un deuxième numéro de téléphone (SIM/eSIM/prépayé) pour l’assistant

La configuration à deux téléphones (recommandée)

Vous voulez ceci :

flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]

Si vous liez votre WhatsApp personnel à OpenClaw, chaque message qui vous est adressé devient une « entrée d’agent ». Ce sont rarement les résultats que vous recherchez.

Démarrage rapide en 5 minutes

Associer WhatsApp Web (affiche un QR code ; scannez avec le téléphone de l’assistant) :

openclaw channels login

Démarrez le Gateway (laissez-le en cours d’exécution) :

openclaw gateway --port 18789

Mettez une configuration minimale dans ~/.openclaw/openclaw.json :

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

Envoyez maintenant un message au numéro de l’assistant depuis votre téléphone autorisé.

Une fois l’onboarding terminé, OpenClaw ouvre automatiquement le tableau de bord et affiche un lien propre (non tokenisé). Si le tableau de bord demande une authentification, collez le secret partagé configuré dans les paramètres de l’interface de contrôle (Control UI). L’onboarding utilise un jeton par défaut (gateway.auth.token), mais l’authentification par mot de passe fonctionne également si vous avez changé gateway.auth.mode pour password. Pour rouvrir plus tard : openclaw dashboard.

Donner à l’agent un espace de travail (AGENTS)

OpenClaw lit les instructions de fonctionnement et la « mémoire » depuis son répertoire d’espace de travail.

Par défaut, OpenClaw utilise ~/.openclaw/workspace comme espace de travail de l’agent et le créera (ainsi que les fichiers de démarrage AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) automatiquement lors de la configuration/première exécution de l’agent. BOOTSTRAP.md n’est créé que lorsque l’espace de travail est tout nouveau (il ne devrait pas réapparaître après l’avoir supprimé). MEMORY.md est facultatif (non créé automatiquement) ; lorsqu’il est présent, il est chargé pour les sessions normales. Les sessions de sous-agents n’injectent que AGENTS.md et TOOLS.md.

openclaw setup

Plan complet de l’espace de travail + guide de sauvegarde : Espace de travail de l’agent Flux de travail de la mémoire : Mémoire

Optionnel : choisir un espace de travail différent avec agents.defaults.workspace (prend en charge ~).

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

Si vous fournissez déjà vos propres fichiers d’espace de travail depuis un dépôt, vous pouvez désactiver entièrement la création de fichiers d’amorçage :

{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

La configuration qui le transforme en « assistant »

OpenClaw est configuré par défaut pour une bonne configuration d’assistant, mais vous voudrez généralement ajuster :

persona/instructions dans SOUL.md
paramètres par défaut de réflexion (si souhaité)
battements de cœur (heartbeats) (une fois que vous lui faites confiance)

Exemple :

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      // Start with 0; enable later.
      heartbeat: { every: "0m" },
    },
    list: [
      {
        id: "main",
        default: true,
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

Sessions et mémoire

Fichiers de session : ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
Métadonnées de session (utilisation des jetons, dernière route, etc.) : ~/.openclaw/agents/<agentId>/sessions/sessions.json (ancien : ~/.openclaw/sessions/sessions.json)
/new ou /reset lance une nouvelle session pour cette discussion (configurable via resetTriggers). S’il est envoyé seul, OpenClaw acknowledge la réinitialisation sans invoquer le model.
/compact [instructions] compacte le contexte de la session et signale le budget contextuel restant.

Battements de cœur (mode proactif)

Par défaut, OpenClaw exécute un battement de cœur toutes les 30 minutes avec le prompt : Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. Définissez agents.defaults.heartbeat.every: "0m" pour désactiver.

Si HEARTBEAT.md existe mais est effectivement vide (seulement des lignes vides et des en-têtes markdown comme # Heading), OpenClaw ignore l’exécution du battement de cœur pour économiser les appels à l’API.
Si le fichier est manquant, le battement de cœur s’exécute toujours et le model décide de quoi faire.
Si l’agent répond avec HEARTBEAT_OK (éventuellement avec un court remplissage ; voir agents.defaults.heartbeat.ackMaxChars), OpenClaw supprime la livraison sortante pour ce battement de cœur.
Par défaut, la livraison de battements de cœur vers les cibles de type user:<id> de type DM est autorisée. Définissez agents.defaults.heartbeat.directPolicy: "block" pour supprimer la livraison directe aux cibles tout en gardant les exécutions de battements de cœur actives.
Les battements de cœur exécutent des tours complets d’agent - des intervalles plus courts consomment plus de jetons.

{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

Médias en entrée et en sortie

Les pièces jointes entrantes (images/audio/docs) peuvent être présentées à votre commande via des modèles :

{{MediaPath}} (chemin de fichier temporaire local)
{{MediaUrl}} (pseudo-URL)
{{Transcript}} (si la transcription audio est activée)

Pièces jointes sortantes de l’agent : incluez MEDIA:<path-or-url> sur sa propre ligne (sans espaces). Exemple :

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

OpenClaw les extrait et les envoie en tant que médias accompagnant le texte.

Le comportement du chemin local suit le même modèle de confiance de lecture de fichier que l’agent :

Si tools.fs.workspaceOnly est true, les chemins locaux sortants MEDIA: restent restreints à la racine temp OpenClaw, le cache multimédia, les chemins de l’espace de travail de l’agent et les fichiers générés par le bac à sable.
Si tools.fs.workspaceOnly est false, les chemins locaux sortants MEDIA: peuvent utiliser les fichiers locaux de l’hôte que l’agent est déjà autorisé à lire.
Les chemins locaux peuvent être absolus, relatifs à l’espace de travail ou relatifs au répertoire personnel avec ~/.
Les envois locaux à l’hôte n’autorisent toujours que les types de médias et de documents sécurisés (images, audio, vidéo, PDF et documents Office). Les fichiers en texte brut et ceux ressemblant à des secrets ne sont pas considérés comme des médias envoyables.

Cela signifie que les images/fichiers générés en dehors de l’espace de travail peuvent maintenant être envoyés lorsque votre stratégie de système de fichiers autorise déjà ces lectures, sans rouvrir l’exfiltration arbitraire de pièces jointes texte de l’hôte.

Liste de contrôle des opérations

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

Les journaux se trouvent sous /tmp/openclaw/ (par défaut : openclaw-YYYY-MM-DD.log).

Étapes suivantes

WebChat : WebChat
Opérations du Gateway : Gateway runbook
Cron + réveils : Cron jobs
Compagnon de barre de menu macOS : application OpenClaw macOS
Application nœud iOS : application iOS
Application nœud Android : application Android
Statut Windows : Windows (WSL2)
Statut Linux : application Linux
Sécurité : Sécurité