​

Outils (OpenClaw)

​

Désactivation des outils

{
  tools: { deny: ["browser"] },
}

• La correspondance est insensible à la casse.
• Les jokers * sont pris en charge ("*" signifie tous les outils).
• Si tools.allow ne référence que des noms d’outils de plugins inconnus ou non chargés, OpenClaw consigne un avertissement et ignore la liste d’autorisation afin que les outils cœur restent disponibles.

​

Profils d’outils (liste d’autorisation de base)

• minimal : session_status uniquement
• coding : group:fs, group:runtime, group:sessions, group:memory, image
• messaging : group:messaging, sessions_list, sessions_history, sessions_send, session_status
• full : aucune restriction (identique à non défini)

{
  tools: {
    profile: "messaging",
    allow: ["slack", "discord"],
  },
}

{
  tools: {
    profile: "coding",
    deny: ["group:runtime"],
  },
}

{
  tools: { profile: "coding" },
  agents: {
    list: [
      {
        id: "support",
        tools: { profile: "messaging", allow: ["slack"] },
      },
    ],
  },
}

​

Politique d’outils spécifique au fournisseur

{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}

{
  tools: {
    allow: ["group:fs", "group:runtime", "sessions_list"],
    byProvider: {
      "openai/gpt-5.2": { allow: ["group:fs", "sessions_list"] },
    },
  },
}

{
  agents: {
    list: [
      {
        id: "support",
        tools: {
          byProvider: {
            "google-antigravity": { allow: ["message", "sessions_list"] },
          },
        },
      },
    ],
  },
}

​

Groupes d’outils (raccourcis)

• group:runtime : exec, bash, process
• group:fs : read, write, edit, apply_patch
• group:sessions : sessions_list, sessions_history, sessions_send, sessions_spawn, session_status
• group:memory : memory_search, memory_get
• group:web : web_search, web_fetch
• group:ui : browser, canvas
• group:automation : cron, gateway
• group:messaging : message
• group:nodes : nodes
• group:openclaw : tous les outils OpenClaw intégrés (exclut les plugins de fournisseur)

{
  tools: {
    allow: ["group:fs", "browser"],
  },
}

​

Plugins + outils

• Lobster : moteur de workflow typé avec validations reprises (nécessite le CLI Lobster sur l’hôte de la Gateway (passerelle)).
• LLM Task : étape LLM JSON uniquement pour une sortie de workflow structurée (validation de schéma optionnelle).

​

Inventaire des outils

​

apply_patch

​

exec

• command (requis)
• yieldMs (passage automatique en arrière-plan après délai, par défaut 10000)
• background (arrière-plan immédiat)
• timeout (secondes ; tue le processus si dépassé, par défaut 1800)
• elevated (bool ; exécuter sur l’hôte si le mode élevé est activé/autorisé ; ne change le comportement que lorsque l’agent est en sandbox)
• host (sandbox | gateway | node)
• security (deny | allowlist | full)
• ask (off | on-miss | always)
• node (id/nom de nœud pour host=node)
• Besoin d’un vrai TTY ? Définissez pty: true.

• Renvoie status: "running" avec un sessionId lorsqu’il est en arrière-plan.
• Utilisez process pour sonder/journaliser/écrire/arrêter/effacer les sessions en arrière-plan.
• Si process est interdit, exec s’exécute de manière synchrone et ignore yieldMs/background.
• elevated est contrôlé par tools.elevated plus toute surcharge agents.list[].tools.elevated (les deux doivent autoriser) et est un alias pour host=gateway + security=full.
• elevated ne change le comportement que lorsque l’agent est en sandbox (sinon, sans effet).
• host=node peut cibler une application compagnon macOS ou un hôte de nœud sans interface (openclaw node run).
• approbations et listes d’autorisation gateway/nœud : Exec approvals.

​

process

• list, poll, log, write, kill, clear, remove

• poll renvoie la nouvelle sortie et le statut de sortie une fois terminé.
• log prend en charge le suivi par lignes offset/limit (omettre offset pour récupérer les N dernières lignes).
• process est limité par agent ; les sessions d’autres agents ne sont pas visibles.

​

web_search

• query (requis)
• count (1–10 ; valeur par défaut depuis tools.web.search.maxResults)

• Nécessite une clé API Brave (recommandé : openclaw configure --section web, ou définir BRAVE_API_KEY).
• Activer via tools.web.search.enabled.
• Les réponses sont mises en cache (15 min par défaut).
• Voir Web tools pour la configuration.

​

web_fetch

• url (requis)
• extractMode (markdown | text)
• maxChars (tronquer les pages longues)

• Activer via tools.web.fetch.enabled.
• maxChars est plafonné par tools.web.fetch.maxCharsCap (par défaut 50000).
• Les réponses sont mises en cache (15 min par défaut).
• Pour les sites fortement dépendants de JS, privilégiez l’outil navigateur.
• Voir Web tools pour la configuration.
• Voir Firecrawl pour le repli anti-bot optionnel.

​

browser

• status, start, stop, tabs, open, focus, close
• snapshot (aria/ai)
• screenshot (renvoie un bloc image + MEDIA:<path>)
• act (actions UI : click/type/press/hover/drag/select/fill/resize/wait/evaluate)
• navigate, console, pdf, upload, dialog

• profiles — lister tous les profils de navigateur avec statut
• create-profile — créer un nouveau profil avec port alloué automatiquement (ou cdpUrl)
• delete-profile — arrêter le navigateur, supprimer les données utilisateur, retirer de la configuration (local uniquement)
• reset-profile — tuer un processus orphelin sur le port du profil (local uniquement)

• profile (optionnel ; par défaut browser.defaultProfile)
• target (sandbox | host | node)
• node (optionnel ; sélectionner un id/nom de nœud spécifique) Notes :
• Nécessite browser.enabled=true (par défaut true ; définir false pour désactiver).
• Toutes les actions acceptent un paramètre optionnel profile pour le support multi‑instances.
• Lorsque profile est omis, utilise browser.defaultProfile (par défaut « chrome »).
• Noms de profil : alphanumérique en minuscules + tirets uniquement (64 caractères max).
• Plage de ports : 18800‑18899 (~100 profils max).
• Les profils distants sont en attachement uniquement (pas de start/stop/reset).
• Si un nœud compatible navigateur est connecté, l’outil peut s’y router automatiquement (sauf si vous épinglez target).
• snapshot par défaut ai lorsque Playwright est installé ; utilisez aria pour l’arbre d’accessibilité.
• snapshot prend aussi en charge des options d’instantané de rôles (interactive, compact, depth, selector) qui renvoient des références comme e12.
• act nécessite ref depuis snapshot (numérique 12 depuis les instantanés IA, ou e12 depuis les instantanés de rôles) ; utilisez evaluate pour de rares besoins de sélecteur CSS.
• Évitez act → wait par défaut ; utilisez‑le uniquement dans des cas exceptionnels (aucun état UI fiable sur lequel attendre).
• upload peut optionnellement transmettre un ref pour cliquer automatiquement après armement.
• upload prend aussi en charge inputRef (réf aria) ou element (sélecteur CSS) pour définir directement <input type="file">.

​

canvas

• present, hide, navigate, eval
• snapshot (renvoie un bloc image + MEDIA:<path>)
• a2ui_push, a2ui_reset

• Utilise la node.invoke de la Gateway (passerelle) en interne.
• Si aucun node n’est fourni, l’outil choisit une valeur par défaut (nœud unique connecté ou nœud mac local).
• A2UI est en v0.8 uniquement (pas de createSurface) ; la CLI rejette les JSONL v0.9 avec des erreurs de ligne.
• Test rapide : openclaw nodes canvas a2ui push --node <id> --text "Hello from A2UI".

​

nodes

• status, describe
• pending, approve, reject (appairage)
• notify (macOS system.notify)
• run (macOS system.run)
• camera_snap, camera_clip, screen_record
• location_get

• Les commandes caméra/écran nécessitent que l’application du nœud soit au premier plan.
• Les images renvoient des blocs image + MEDIA:<path>.
• Les vidéos renvoient FILE:<path> (mp4).
• La localisation renvoie une charge utile JSON (lat/lon/précision/horodatage).
• Paramètres run : tableau argv command ; cwd optionnel, env (KEY=VAL), commandTimeoutMs, invokeTimeoutMs, needsScreenRecording.

{
  "action": "run",
  "node": "office-mac",
  "command": ["echo", "Hello"],
  "env": ["FOO=bar"],
  "commandTimeoutMs": 12000,
  "invokeTimeoutMs": 45000,
  "needsScreenRecording": false
}

​

image

• image (chemin ou URL requis)
• prompt (optionnel ; par défaut « Describe the image. »)
• model (surcharge optionnelle)
• maxBytesMb (plafond de taille optionnel)

• Disponible uniquement lorsque agents.defaults.imageModel est configuré (principal ou secours), ou lorsqu’un modèle d’image implicite peut être déduit de votre modèle par défaut + authentification configurée (appariement au mieux).
• Utilise directement le modèle d’image (indépendant du modèle de chat principal).

​

message

• send (texte + média optionnel ; MS Teams prend aussi en charge card pour les Adaptive Cards)
• poll (sondages WhatsApp/Discord/MS Teams)
• react / reactions / read / edit / delete
• pin / unpin / list-pins
• permissions
• thread-create / thread-list / thread-reply
• search
• sticker
• member-info / role-info
• emoji-list / emoji-upload / sticker-upload
• role-add / role-remove
• channel-info / channel-list
• voice-status
• event-list / event-create
• timeout / kick / ban

• send route WhatsApp via la Gateway (passerelle) ; les autres canaux vont directement.
• poll utilise la Gateway (passerelle) pour WhatsApp et MS Teams ; les sondages Discord vont directement.
• Lorsqu’un appel d’outil de messagerie est lié à une session de chat active, les envois sont contraints à la cible de cette session afin d’éviter les fuites inter‑contexte.

​

cron

• status, list
• add, update, remove, run, runs
• wake (mettre en file un événement système + battement immédiat optionnel)

• add attend un objet de tâche cron complet (même schéma que l’RPC cron.add).
• update utilise { id, patch }.

​

gateway

• restart (autorise + envoie SIGUSR1 pour redémarrage en processus ; openclaw gateway redémarrage sur place)
• config.get / config.schema
• config.apply (valider + écrire la configuration + redémarrer + réveiller)
• config.patch (fusionner une mise à jour partielle + redémarrer + réveiller)
• update.run (exécuter la mise à jour + redémarrer + réveiller)

• Utilisez delayMs (par défaut 2000) pour éviter d’interrompre une réponse en cours.
• restart est désactivé par défaut ; activez‑le avec commands.restart: true.

​

sessions_list / sessions_history / sessions_send / sessions_spawn / session_status

• sessions_list : kinds?, limit?, activeMinutes?, messageLimit? (0 = aucun)
• sessions_history : sessionKey (ou sessionId), limit?, includeTools?
• sessions_send : sessionKey (ou sessionId), message, timeoutSeconds? (0 = fire‑and‑forget)
• sessions_spawn : task, label?, agentId?, model?, runTimeoutSeconds?, cleanup?
• session_status : sessionKey? (par défaut courant ; accepte sessionId), model? (default efface la surcharge)

• main est la clé canonique de chat direct ; global/inconnu sont masqués.
• messageLimit > 0 récupère les N derniers messages par session (messages d’outils filtrés).
• sessions_send attend l’achèvement final lorsque timeoutSeconds > 0.
• La livraison/l’annonce intervient après l’achèvement et est au mieux ; status: "ok" confirme la fin de l’exécution de l’agent, pas la livraison de l’annonce.
• sessions_spawn démarre une exécution de sous‑agent et publie une réponse d’annonce dans le chat demandeur.
• sessions_spawn est non bloquant et renvoie immédiatement status: "accepted".
• sessions_send exécute un ping‑pong de réponse (répondre REPLY_SKIP pour arrêter ; nombre maximal de tours via session.agentToAgent.maxPingPongTurns, 0–5).
• Après le ping‑pong, l’agent cible exécute une étape d’annonce ; répondre ANNOUNCE_SKIP pour supprimer l’annonce.

​

agents_list

• Le résultat est limité aux listes d’autorisation par agent (agents.list[].subagents.allowAgents).
• Lorsque ["*"] est configuré, l’outil inclut tous les agents configurés et marque allowAny: true.

​

Paramètres (communs)

• gatewayUrl (par défaut ws://127.0.0.1:18789)
• gatewayToken (si l’authentification est activée)
• timeoutMs

• profile (optionnel ; par défaut browser.defaultProfile)
• target (sandbox | host | node)
• node (optionnel ; épingler un id/nom de nœud spécifique)

​

Flux d’agent recommandés

1. browser → status / start
2. snapshot (ai ou aria)
3. act (click/type/press)
4. screenshot si vous avez besoin d’une confirmation visuelle

1. canvas → present
2. a2ui_push (optionnel)
3. snapshot

1. nodes → status
2. describe sur le nœud choisi
3. notify / run / camera_snap / screen_record

​

Sécurité

• Évitez system.run direct ; utilisez nodes → run uniquement avec le consentement explicite de l’utilisateur.
• Respectez le consentement de l’utilisateur pour la capture caméra/écran.
• Utilisez status/describe pour vérifier les autorisations avant d’invoquer des commandes média.

​

Comment les outils sont présentés à l’agent

1. Texte du prompt système : une liste lisible par un humain + des consignes.
2. Schéma d’outil : les définitions de fonctions structurées envoyées à l’API du modèle.