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 d’autres services à des agents IA. Ce guide couvre la configuration « assistant personnel » : un numéro WhatsApp dédié qui se comporte comme votre assistant IA toujours actif.

⚠️ La sécurité d’abord

Vous placez un agent en position de :

exécuter des commandes sur votre machine (selon votre politique d’outils)
lire/écrire des fichiers dans votre espace de travail
renvoyer des messages via WhatsApp/Telegram/Discord/Mattermost et d’autres canaux intégrés

Commencez de manière prudente :

Définissez toujours channels.whatsapp.allowFrom (n’exécutez jamais une configuration ouverte à tout Internet sur votre Mac personnel).
Utilisez un numéro WhatsApp dédié pour l’assistant.
Les Heartbeats utilisent désormais par défaut un intervalle de 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 initialisé - consultez Bien démarrer si ce n’est pas encore fait
Un deuxième numéro de téléphone (SIM/eSIM/prépayé) pour l’assistant

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

Vous voulez ceci : Si vous liez votre WhatsApp personnel à OpenClaw, chaque message qui vous est adressé devient une « entrée de l’agent ». C’est rarement ce que vous voulez.

Démarrage rapide en 5 minutes

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

openclaw channels login

Démarrez le Gateway (laissez-le tourner) :

openclaw gateway --port 18789

Placez 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é. Lorsque l’initialisation se termine, 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. L’initialisation utilise un jeton par défaut (gateway.auth.token), mais l’authentification par mot de passe fonctionne aussi si vous avez passé gateway.auth.mode à password. Pour rouvrir plus tard : openclaw dashboard.

Donner un espace de travail à l’agent (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ée automatiquement (avec les fichiers de démarrage AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) lors de la configuration ou de la première exécution de l’agent. BOOTSTRAP.md n’est créé que lorsque l’espace de travail est entièrement nouveau (il ne doit pas réapparaître après sa suppression). MEMORY.md est facultatif (il n’est pas créé automatiquement) ; lorsqu’il est présent, il est chargé pour les sessions normales. Les sessions de sous-agent injectent uniquement AGENTS.md et TOOLS.md.

Traitez ce dossier comme la mémoire d’OpenClaw et faites-en un dépôt git (idéalement privé) afin que votre AGENTS.md et vos fichiers de mémoire soient sauvegardés. Si git est installé, les espaces de travail tout neufs sont automatiquement initialisés.

openclaw setup

Disposition complète de l’espace de travail + guide de sauvegarde : Espace de travail de l’agent Workflow de mémoire : Mémoire Facultatif : choisissez un autre espace de travail avec agents.defaults.workspace (prend en charge ~).

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

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

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

La configuration qui le transforme en « assistant »

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

la personnalité/les instructions dans SOUL.md
les paramètres de réflexion par défaut (si souhaité)
les 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 (hérité : ~/.openclaw/sessions/sessions.json)
/new ou /reset démarre une nouvelle session pour cette conversation (configurable via resetTriggers). S’il est envoyé seul, OpenClaw confirme la réinitialisation sans invoquer le modèle.
/compact [instructions] compacte le contexte de session et indique le budget de contexte restant.

Heartbeats (mode proactif)

Par défaut, OpenClaw exécute un Heartbeat 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 le désactiver.

Si HEARTBEAT.md existe mais est effectivement vide (uniquement des lignes vides et des en-têtes Markdown comme # Heading), OpenClaw ignore l’exécution du Heartbeat pour économiser des appels API.
Si le fichier est absent, le Heartbeat s’exécute quand même et le modèle décide quoi faire.
Si l’agent répond avec HEARTBEAT_OK (éventuellement avec un court remplissage ; voir agents.defaults.heartbeat.ackMaxChars), OpenClaw supprime l’envoi sortant pour ce Heartbeat.
Par défaut, la livraison des Heartbeats vers les cibles de type message direct user:<id> est autorisée. Définissez agents.defaults.heartbeat.directPolicy: "block" pour supprimer la livraison vers des cibles directes tout en gardant les exécutions de Heartbeat actives.
Les Heartbeats exécutent des tours d’agent complets - des intervalles plus courts consomment davantage de jetons.

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

Médias entrants et sortants

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

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

Pièces jointes sortantes depuis 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 comme médias avec le texte. Le comportement des chemins locaux suit le même modèle de confiance pour la lecture de fichiers que l’agent :

Si tools.fs.workspaceOnly vaut true, les chemins locaux MEDIA: sortants restent limités à la racine temporaire d’OpenClaw, au cache média, aux chemins de l’espace de travail de l’agent et aux fichiers générés par le bac à sable.
Si tools.fs.workspaceOnly vaut false, les MEDIA: sortants peuvent utiliser des 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 depuis l’hôte n’autorisent toujours que les médias et les types de documents sûrs (images, audio, vidéo, PDF et documents Office). Les fichiers texte brut et les fichiers ressemblant à des secrets ne sont pas traités comme des médias envoyables.

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

Checklist 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 Gateway : Guide d’exploitation Gateway
Cron + réveils : Tâches Cron
Compagnon de barre de menus macOS : App macOS OpenClaw
App de nœud iOS : App iOS
App de nœud Android : App Android
Statut Windows : Windows (WSL2)
Statut Linux : App Linux
Sécurité : Sécurité

Overview

First steps

Guides

Configuration de l’assistant personnel

⚠️ La sécurité d’abord

Prérequis

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

Démarrage rapide en 5 minutes

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

La configuration qui le transforme en « assistant »

Sessions et mémoire

Heartbeats (mode proactif)

Médias entrants et sortants

Checklist des opérations

Étapes suivantes

Associé

Overview

First steps

Guides

Documentation Index

​⚠️ La sécurité d’abord

​Prérequis

​La configuration avec deux téléphones (recommandée)

​Démarrage rapide en 5 minutes

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

​La configuration qui le transforme en « assistant »

​Sessions et mémoire

​Heartbeats (mode proactif)

​Médias entrants et sortants

​Checklist des opérations

​Étapes suivantes

​Associé

⚠️ La sécurité d’abord

Prérequis

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

Démarrage rapide en 5 minutes

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

La configuration qui le transforme en « assistant »

Sessions et mémoire

Heartbeats (mode proactif)

Médias entrants et sortants

Checklist des opérations

Étapes suivantes

Associé