​

Référence CLI

​

Pages de commande

• setup
• onboard
• configure
• config
• completion
• doctor
• dashboard
• backup
• reset
• uninstall
• update
• message
• agent
• agents
• acp
• mcp
• status
• health
• sessions
• gateway
• logs
• system
• models
• memory
• directory
• nodes
• devices
• node
• approvals
• sandbox
• tui
• browser
• cron
• tasks
• flows
• dns
• docs
• hooks
• webhooks
• pairing
• qr
• plugins (commandes de plugin)
• channels
• security
• secrets
• skills
• daemon (alias historique pour les commandes de service gateway)
• clawbot (espace de noms d’alias historique)
• voicecall (plugin ; si installé)

​

Indicateurs globaux

• --dev : isole l’état sous ~/.openclaw-dev et décale les ports par défaut.
• --profile <name> : isole l’état sous ~/.openclaw-<name>.
• --container <name> : cible un conteneur nommé pour l’exécution.
• --no-color : désactive les couleurs ANSI.
• --update : raccourci pour openclaw update (installations depuis les sources uniquement).
• -V, --version, -v : affiche la version et quitte.

​

Style de sortie

• Les couleurs ANSI et les indicateurs de progression ne s’affichent que dans les sessions TTY.
• Les hyperliens OSC-8 s’affichent comme liens cliquables dans les terminaux compatibles ; sinon, nous revenons à des URL en clair.
• --json (et --plain lorsque pris en charge) désactive le style pour une sortie propre.
• --no-color désactive le style ANSI ; NO_COLOR=1 est également respecté.
• Les commandes longues affichent un indicateur de progression (OSC 9;4 lorsque pris en charge).

​

Palette de couleurs

• accent (#FF5A2D) : titres, libellés, mises en évidence principales.
• accentBright (#FF7A3D) : noms de commande, emphase.
• accentDim (#D14A22) : texte de mise en évidence secondaire.
• info (#FF8A5B) : valeurs d’information.
• success (#2FBF71) : états de réussite.
• warn (#FFB020) : avertissements, solutions de repli, éléments demandant de l’attention.
• error (#E23D2D) : erreurs, échecs.
• muted (#8B7F77) : atténuation, métadonnées.

​

Arborescence des commandes

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
    file
    schema
    validate
  completion
  doctor
  dashboard
  backup
    create
    verify
  security
    audit
  secrets
    reload
    audit
    configure
    apply
  reset
  uninstall
  update
    wizard
    status
  channels
    list
    status
    capabilities
    resolve
    logs
    add
    remove
    login
    logout
  directory
    self
    peers list
    groups list|members
  skills
    search
    install
    update
    list
    info
    check
  plugins
    list
    inspect
    install
    uninstall
    update
    enable
    disable
    doctor
    marketplace list
  memory
    status
    index
    search
  message
    send
    broadcast
    poll
    react
    reactions
    read
    edit
    delete
    pin
    unpin
    pins
    permissions
    search
    thread create|list|reply
    emoji list|upload
    sticker send|upload
    role info|add|remove
    channel info|list
    member info
    voice status
    event list|create
    timeout
    kick
    ban
  agent
  agents
    list
    add
    delete
    bindings
    bind
    unbind
    set-identity
  acp
  mcp
    serve
    list
    show
    set
    unset
  status
  health
  sessions
    cleanup
  tasks
    list
    audit
    maintenance
    show
    notify
    cancel
    flow list|show|cancel
  gateway
    call
    usage-cost
    health
    status
    probe
    discover
    install
    uninstall
    start
    stop
    restart
    run
  daemon
    status
    install
    uninstall
    start
    stop
    restart
  logs
  system
    event
    heartbeat last|enable|disable
    presence
  models
    list
    status
    set
    set-image
    aliases list|add|remove
    fallbacks list|add|remove|clear
    image-fallbacks list|add|remove|clear
    scan
    auth add|login|login-github-copilot|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
    status
    describe
    list
    pending
    approve
    reject
    rename
    invoke
    notify
    push
    canvas snapshot|present|hide|navigate|eval
    canvas a2ui push|reset
    camera list|snap|clip
    screen record
    location get
  devices
    list
    remove
    clear
    approve
    reject
    rotate
    revoke
  node
    run
    status
    install
    uninstall
    stop
    restart
  approvals
    get
    set
    allowlist add|remove
  browser
    status
    start
    stop
    reset-profile
    tabs
    open
    focus
    close
    profiles
    create-profile
    delete-profile
    screenshot
    snapshot
    navigate
    resize
    click
    type
    press
    hover
    drag
    select
    upload
    fill
    dialog
    wait
    evaluate
    console
    pdf
  hooks
    list
    info
    check
    enable
    disable
    install
    update
  webhooks
    gmail setup|run
  pairing
    list
    approve
  qr
  clawbot
    qr
  docs
  dns
    setup
  tui

​

Sécurité

• openclaw security audit — audite la configuration + l’état local pour détecter les pièges de sécurité courants.
• openclaw security audit --deep — sonde gateway en direct au mieux.
• openclaw security audit --fix — resserre les valeurs par défaut sûres et les autorisations d’état/configuration.

​

Secrets

​

secrets

• secrets reload
• secrets audit
• secrets configure
• secrets apply --from <path>

• --url, --token, --timeout, --expect-final, --json

• --check
• --allow-exec
• --json

• --apply
• --yes
• --providers-only
• --skip-provider-setup
• --agent <id>
• --allow-exec
• --plan-out <path>
• --json

• --dry-run
• --allow-exec
• --json

• reload est une RPC Gateway et conserve le snapshot d’exécution valide le plus récent lorsque la résolution échoue.
• audit --check renvoie une valeur non nulle en cas de résultats ; les références non résolues utilisent un code de sortie non nul de priorité plus élevée.
• Les vérifications exec en dry-run sont ignorées par défaut ; utilisez --allow-exec pour y participer explicitement.

​

Plugins

• openclaw plugins list — découvre les plugins (utilisez --json pour une sortie lisible par machine).
• openclaw plugins inspect <id> — affiche les détails d’un plugin (info est un alias).
• openclaw plugins install <path|.tgz|npm-spec|plugin@marketplace> — installe un plugin (ou ajoute un chemin de plugin à plugins.load.paths ; utilisez --force pour écraser une cible d’installation existante).
• openclaw plugins marketplace list <marketplace> — liste les entrées du marketplace avant installation.
• openclaw plugins enable <id> / disable <id> — bascule plugins.entries.<id>.enabled.
• openclaw plugins doctor — signale les erreurs de chargement de plugins.

​

Memory

• openclaw memory status — affiche les statistiques d’index ; utilisez --deep pour les vérifications de disponibilité vectorielle + embeddings ou --fix pour réparer les artefacts obsolètes de rappel/promotion.
• openclaw memory index — réindexe les fichiers memory.
• openclaw memory search "<query>" (ou --query "<query>") — recherche sémantique dans memory.
• openclaw memory promote — classe les rappels à court terme et peut éventuellement ajouter les meilleures entrées à MEMORY.md.

​

Sandbox

• sandbox list [--browser] [--json]
• sandbox recreate [--all] [--session <key>] [--agent <id>] [--browser] [--force]
• sandbox explain [--session <key>] [--agent <id>] [--json]

• sandbox recreate supprime les environnements existants afin que leur prochaine utilisation les réamorce avec la configuration actuelle.
• Pour les backends ssh et OpenShell remote, recreate supprime l’espace de travail distant canonique pour l’étendue sélectionnée.

​

Commandes slash de chat

• /status pour des diagnostics rapides.
• /config pour des modifications de configuration persistées.
• /debug pour des remplacements de configuration à l’exécution uniquement (en mémoire, pas sur disque ; nécessite commands.debug: true).

​

Configuration initiale + onboarding

​

completion

• -s, --shell <zsh|bash|powershell|fish>
• -i, --install
• --write-state
• -y, --yes

• Sans --install ni --write-state, completion affiche le script sur stdout.
• --install écrit un bloc OpenClaw Completion dans votre profil shell et le fait pointer vers le script mis en cache dans le répertoire d’état OpenClaw.

​

setup

• --workspace <dir> : chemin de l’espace de travail de l’agent (par défaut ~/.openclaw/workspace).
• --wizard : lance l’onboarding.
• --non-interactive : exécute l’onboarding sans invites.
• --mode <local|remote> : mode d’onboarding.
• --remote-url <url> : URL Gateway distante.
• --remote-token <token> : jeton Gateway distant.

​

onboard

• --workspace <dir>
• --reset (réinitialise config + identifiants + sessions avant l’onboarding)
• --reset-scope <config|config+creds+sessions|full> (par défaut config+creds+sessions ; utilisez full pour supprimer également l’espace de travail)
• --non-interactive
• --mode <local|remote>
• --flow <quickstart|advanced|manual> (manual est un alias de advanced)
• --auth-choice <choice> où <choice> est l’un de : chutes, deepseek-api-key, openai-codex, openai-api-key, openrouter-api-key, kilocode-api-key, litellm-api-key, ai-gateway-api-key, cloudflare-ai-gateway-api-key, moonshot-api-key, moonshot-api-key-cn, kimi-code-api-key, synthetic-api-key, venice-api-key, together-api-key, huggingface-api-key, apiKey, gemini-api-key, google-gemini-cli, zai-api-key, zai-coding-global, zai-coding-cn, zai-global, zai-cn, xiaomi-api-key, minimax-global-oauth, minimax-global-api, minimax-cn-oauth, minimax-cn-api, opencode-zen, opencode-go, github-copilot, copilot-proxy, xai-api-key, mistral-api-key, volcengine-api-key, byteplus-api-key, qianfan-api-key, qwen-standard-api-key-cn, qwen-standard-api-key, qwen-api-key-cn, qwen-api-key, modelstudio-standard-api-key-cn, modelstudio-standard-api-key, modelstudio-api-key-cn, modelstudio-api-key, custom-api-key, skip
• Remarque Qwen : qwen-* est la famille canonique pour auth-choice. Les identifiants modelstudio-* restent acceptés uniquement comme alias historiques de compatibilité.
• --secret-input-mode <plaintext|ref> (par défaut plaintext ; utilisez ref pour stocker des références env provider par défaut au lieu de clés en clair)
• --anthropic-api-key <key>
• --openai-api-key <key>
• --mistral-api-key <key>
• --openrouter-api-key <key>
• --ai-gateway-api-key <key>
• --moonshot-api-key <key>
• --kimi-code-api-key <key>
• --gemini-api-key <key>
• --zai-api-key <key>
• --minimax-api-key <key>
• --opencode-zen-api-key <key>
• --opencode-go-api-key <key>
• --custom-base-url <url> (non interactif ; utilisé avec --auth-choice custom-api-key)
• --custom-model-id <id> (non interactif ; utilisé avec --auth-choice custom-api-key)
• --custom-api-key <key> (non interactif ; facultatif ; utilisé avec --auth-choice custom-api-key ; utilise CUSTOM_API_KEY comme repli s’il est omis)
• --custom-provider-id <id> (non interactif ; identifiant provider personnalisé facultatif)
• --custom-compatibility <openai|anthropic> (non interactif ; facultatif ; openai par défaut)
• --gateway-port <port>
• --gateway-bind <loopback|lan|tailnet|auto|custom>
• --gateway-auth <token|password>
• --gateway-token <token>
• --gateway-token-ref-env <name> (non interactif ; stocke gateway.auth.token en tant que SecretRef env ; nécessite que cette variable d’environnement soit définie ; ne peut pas être combiné avec --gateway-token)
• --gateway-password <password>
• --remote-url <url>
• --remote-token <token>
• --tailscale <off|serve|funnel>
• --tailscale-reset-on-exit
• --install-daemon
• --no-install-daemon (alias : --skip-daemon)
• --daemon-runtime <node|bun>
• --skip-channels
• --skip-skills
• --skip-search
• --skip-health
• --skip-ui
• --cloudflare-ai-gateway-account-id <id>
• --cloudflare-ai-gateway-gateway-id <id>
• --node-manager <npm|pnpm|bun> (gestionnaire Node pour setup/onboarding de Skills ; pnpm recommandé, bun également pris en charge)
• --json

​

configure

• --section <section> (répétable ; limite l’assistant à des sections spécifiques)

​

config

• config get <path> : affiche une valeur de configuration (chemin dot/bracket).
• config set : prend en charge quatre modes d’affectation :
  • mode valeur : config set <path> <value> (analyse JSON5-ou-chaîne)
  • mode constructeur SecretRef : config set <path> --ref-provider <provider> --ref-source <source> --ref-id <id>
  • mode constructeur provider : config set secrets.providers.<alias> --provider-source <env|file|exec> ...
  • mode lot : config set --batch-json '<json>' ou config set --batch-file <path>
• config set --dry-run : valide les affectations sans écrire openclaw.json (les vérifications exec SecretRef sont ignorées par défaut).
• config set --allow-exec --dry-run : permet explicitement les vérifications exec SecretRef en dry-run (peut exécuter des commandes provider).
• config set --dry-run --json : émet une sortie de dry-run lisible par machine (vérifications + signal d’exhaustivité, opérations, refs vérifiées/ignorées, erreurs).
• config set --strict-json : impose l’analyse JSON5 pour l’entrée chemin/valeur. --json reste un alias historique de l’analyse stricte hors mode de sortie dry-run.
• config unset <path> : supprime une valeur.
• config file : affiche le chemin du fichier de configuration actif.
• config schema : affiche le schéma JSON généré pour openclaw.json, y compris les métadonnées de documentation title / description propagées à travers les branches imbriquées d’objet, joker, élément de tableau et composition, ainsi que des métadonnées de schéma plugin/canal live au mieux.
• config validate : valide la configuration actuelle par rapport au schéma sans démarrer la gateway.
• config validate --json : émet une sortie JSON lisible par machine.

​

doctor

• --no-workspace-suggestions : désactive les conseils de mémoire d’espace de travail.
• --yes : accepte les valeurs par défaut sans invite (mode headless).
• --non-interactive : ignore les invites ; applique uniquement les migrations sûres.
• --deep : analyse les services système à la recherche d’installations gateway supplémentaires.
• --repair (alias : --fix) : tente des réparations automatiques pour les problèmes détectés.
• --force : force les réparations même lorsqu’elles ne sont pas strictement nécessaires.
• --generate-gateway-token : génère un nouveau jeton d’authentification gateway.

​

dashboard

• --no-open : affiche l’URL sans lancer de navigateur

• Pour les jetons gateway gérés par SecretRef, dashboard affiche ou ouvre une URL sans jeton au lieu d’exposer le secret dans la sortie terminal ou les arguments de lancement du navigateur.

​

update

• --json
• --no-restart
• --dry-run
• --channel <stable|beta|dev>
• --tag <dist-tag|version|spec>
• --timeout <seconds>
• --yes

• update status
• update wizard

• --json
• --timeout <seconds>

• --timeout <seconds>

• openclaw --update est réécrit en openclaw update.

​

backup

• backup create
• backup verify <archive>

• --output <path>
• --json
• --dry-run
• --verify
• --only-config
• --no-include-workspace

• --json

​

Assistants de canal

​

channels

• channels list : affiche les canaux configurés et les profils d’authentification.
• channels status : vérifie l’accessibilité de la gateway et la santé des canaux (--probe exécute des vérifications probe/audit live par compte lorsque la gateway est accessible ; sinon, il se replie sur des résumés de canaux basés uniquement sur la configuration. Utilisez openclaw health ou openclaw status --deep pour des sondes de santé gateway plus larges).
• Astuce : channels status affiche des avertissements avec des correctifs suggérés lorsqu’il peut détecter des erreurs de configuration courantes (puis vous oriente vers openclaw doctor).
• channels logs : affiche les journaux récents des canaux depuis le fichier journal de la gateway.
• channels add : configuration façon assistant lorsqu’aucun indicateur n’est passé ; les indicateurs basculent en mode non interactif.
  • Lors de l’ajout d’un compte non par défaut à un canal utilisant encore une configuration de niveau supérieur à compte unique, OpenClaw promeut les valeurs liées au compte dans la map des comptes du canal avant d’écrire le nouveau compte. La plupart des canaux utilisent accounts.default ; Matrix peut préserver une cible nommée/par défaut existante correspondante à la place.
  • channels add en mode non interactif ne crée/met pas automatiquement à niveau les bindings ; les bindings uniquement canal continuent de correspondre au compte par défaut.
• channels remove : désactive par défaut ; passez --delete pour supprimer les entrées de configuration sans invites.
• channels login : connexion interactive au canal (WhatsApp Web uniquement).
• channels logout : déconnecte une session de canal (si pris en charge).

• --channel <name> : whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
• --account <id> : identifiant de compte de canal (par défaut default)
• --name <label> : nom d’affichage du compte

• --channel <channel> (par défaut whatsapp ; prend en charge whatsapp/web)
• --account <id>
• --verbose

• --channel <channel> (par défaut whatsapp)
• --account <id>

• --no-usage : ignore les snapshots d’utilisation/quota du provider de modèle (OAuth/API uniquement).
• --json : affiche du JSON (inclut l’utilisation sauf si --no-usage est défini).

• --probe
• --timeout <ms>
• --json

• --channel <name>
• --account <id> (uniquement avec --channel)
• --target <dest>
• --timeout <ms>
• --json

• <entries...>
• --channel <name>
• --account <id>
• --kind <auto|user|group>
• --json

• --channel <name|all> (par défaut all)
• --lines <n> (par défaut 200)
• --json

• channels login prend en charge --verbose.
• channels capabilities --account ne s’applique que lorsque --channel est défini.
• channels status --probe peut afficher l’état du transport ainsi que des résultats probe/audit comme works, probe failed, audit ok ou audit failed, selon la prise en charge par le canal.

openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
openclaw channels remove --channel discord --account work --delete
openclaw channels status --probe
openclaw status --deep

​

directory

• --channel <name>
• --account <id>
• --json

• directory self
• directory peers list [--query <text>] [--limit <n>]
• directory groups list [--query <text>] [--limit <n>]
• directory groups members --group-id <id> [--limit <n>]

​

skills

• skills search [query...] : recherche les Skills ClawHub.
• skills search --limit <n> --json : limite les résultats de recherche ou émet une sortie lisible par machine.
• skills install <slug> : installe un Skill depuis ClawHub dans l’espace de travail actif.
• skills install <slug> --version <version> : installe une version spécifique de ClawHub.
• skills install <slug> --force : écrase un dossier Skill existant dans l’espace de travail.
• skills update <slug|--all> : met à jour les Skills ClawHub suivis.
• skills list : liste les Skills (par défaut lorsqu’aucune sous-commande n’est donnée).
• skills list --json : émet un inventaire des Skills lisible par machine sur stdout.
• skills list --verbose : inclut les exigences manquantes dans le tableau.
• skills info <name> : affiche les détails d’un Skill.
• skills info <name> --json : émet des détails lisibles par machine sur stdout.
• skills check : résumé des éléments prêts vs manquants.
• skills check --json : émet une sortie de disponibilité lisible par machine sur stdout.

• --eligible : n’affiche que les Skills prêts.
• --json : sortie JSON (sans style).
• -v, --verbose : inclut les détails des exigences manquantes.

​

pairing

• pairing list [channel] [--channel <channel>] [--account <id>] [--json]
• pairing approve <channel> <code> [--account <id>] [--notify]
• pairing approve --channel <channel> [--account <id>] <code> [--notify]

• Si exactement un canal compatible pairing est configuré, pairing approve <code> est également autorisé.
• list et approve prennent tous deux en charge --account <id> pour les canaux multi-comptes.

​

devices

• devices list [--json]
• devices approve [requestId] [--latest]
• devices reject <requestId>
• devices remove <deviceId>
• devices clear --yes [--pending]
• devices rotate --device <id> --role <role> [--scope <scope...>]
• devices revoke --device <id> --role <role>

• devices list et devices approve peuvent se replier sur les fichiers de pairing locaux sur local loopback lorsque l’étendue de pairing direct n’est pas disponible.
• devices approve sélectionne automatiquement la demande en attente la plus récente lorsqu’aucun requestId n’est fourni ou lorsque --latest est défini.
• Les reconnexions avec jeton stocké réutilisent les étendues approuvées mises en cache de ce jeton ; un devices rotate --scope ... explicite met à jour cet ensemble d’étendues stocké pour les futures reconnexions avec jeton mis en cache.
• devices rotate et devices revoke renvoient des charges utiles JSON.

​

qr

• --remote
• --url <url>
• --public-url <url>
• --token <token>
• --password <password>
• --setup-code-only
• --no-ascii
• --json

• --token et --password sont mutuellement exclusifs.
• Le code de configuration transporte un jeton bootstrap de courte durée, et non le jeton/mot de passe gateway partagé.
• Le transfert bootstrap intégré conserve le jeton de nœud principal à scopes: [].
• Tout jeton bootstrap opérateur transmis reste limité à operator.approvals, operator.read, operator.talk.secrets et operator.write.
• Les vérifications d’étendue bootstrap sont préfixées par rôle, de sorte que cette liste d’autorisation opérateur ne satisfait que les demandes opérateur ; les rôles non opérateur nécessitent toujours des étendues sous leur propre préfixe de rôle.
• --remote peut utiliser gateway.remote.url ou l’URL active Tailscale Serve/Funnel.
• Après le scan, approuvez la demande avec openclaw devices list / openclaw devices approve <requestId>.

​

clawbot

​

hooks

• hooks list
• hooks info <name>
• hooks check
• hooks enable <name>
• hooks disable <name>
• hooks install <path-or-spec> (alias déprécié de openclaw plugins install)
• hooks update [id] (alias déprécié de openclaw plugins update)

• --json
• --eligible
• -v, --verbose

• Les hooks gérés par plugin ne peuvent pas être activés ni désactivés via openclaw hooks ; activez ou désactivez plutôt le plugin propriétaire.
• hooks install et hooks update fonctionnent encore comme alias de compatibilité, mais affichent des avertissements de dépréciation et redirigent vers les commandes de plugin.

​

webhooks

• webhooks gmail setup
• webhooks gmail run

​

webhooks gmail

• webhooks gmail setup (nécessite --account <email> ; prend en charge --project, --topic, --subscription, --label, --hook-url, --hook-token, --push-token, --bind, --port, --path, --include-body, --max-bytes, --renew-minutes, --tailscale, --tailscale-path, --tailscale-target, --push-endpoint, --json)
• webhooks gmail run (remplacements d’exécution pour les mêmes indicateurs)

• setup configure la surveillance Gmail ainsi que le chemin push côté OpenClaw.
• run démarre le watcher/la boucle de renouvellement Gmail local(e) avec des remplacements d’exécution facultatifs.

​

dns

• dns setup [--domain <domain>] [--apply]

​

dns setup

• --domain <domain>
• --apply : installe/met à jour la configuration CoreDNS (nécessite sudo ; macOS uniquement).

• Sans --apply, c’est un assistant de planification qui affiche la configuration DNS OpenClaw + Tailscale recommandée.
• --apply ne prend actuellement en charge que macOS avec Homebrew CoreDNS.

​

Messagerie + agent

​

message

• message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
• message thread <create|list|reply>
• message emoji <list|upload>
• message sticker <send|upload>
• message role <info|add|remove>
• message channel <info|list>
• message member info
• message voice status
• message event <list|create>

• openclaw message send --target +15555550123 --message "Hi"
• openclaw message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

​

agent

• -m, --message <text>

• -t, --to <dest> (pour la clé de session et la livraison facultative)
• --session-id <id>
• --agent <id> (identifiant d’agent ; remplace les bindings de routage)
• --thinking <off|minimal|low|medium|high|xhigh> (la prise en charge varie selon le provider ; pas de filtrage au niveau du modèle dans la CLI)
• --verbose <on|off>
• --channel <channel> (canal de livraison ; omettez-le pour utiliser le canal de la session principale)
• --reply-to <target> (remplacement de la cible de livraison, distinct du routage de session)
• --reply-channel <channel> (remplacement du canal de livraison)
• --reply-account <id> (remplacement de l’identifiant de compte de livraison)
• --local (exécution intégrée ; le registre de plugins est toujours préchargé en premier)
• --deliver
• --json
• --timeout <seconds>

• Le mode Gateway bascule vers l’agent intégré lorsque la requête Gateway échoue.
• --local précharge quand même le registre de plugins, de sorte que les providers, outils et canaux fournis par les plugins restent disponibles pendant les exécutions intégrées.
• --channel, --reply-channel et --reply-account affectent la livraison de la réponse, et non le routage.

​

agents

​

agents list

• --json
• --bindings

​

agents add [name]

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (répétable)
• --non-interactive
• --json

​

agents bindings

• --agent <id>
• --json

​

agents bind

• --agent <id> (par défaut l’agent actuel par défaut)
• --bind <channel[:accountId]> (répétable)
• --json

​

agents unbind

• --agent <id> (par défaut l’agent actuel par défaut)
• --bind <channel[:accountId]> (répétable)
• --all
• --json

​

agents delete <id>

• --force
• --json

• main ne peut pas être supprimé.
• Sans --force, une confirmation interactive est requise.

​

agents set-identity

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

• --agent ou --workspace peuvent être utilisés pour sélectionner l’agent cible.
• Lorsqu’aucun champ d’identité explicite n’est fourni, la commande lit IDENTITY.md.

​

acp

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --session <key>
• --session-label <label>
• --require-existing
• --reset-session
• --no-prefix-cwd
• --provenance <off|meta|meta+receipt>
• --verbose

​

acp client

• --cwd <dir>
• --server <command>
• --server-args <args...>
• --server-verbose
• --verbose

​

mcp

​

mcp serve

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --claude-channel-mode <auto|on|off>
• --verbose

​

mcp list

• --json

​

mcp show [name]

• --json

​

mcp set <name> <value>

​

mcp unset <name>

​

approvals

​

approvals get

• --node <node>
• --gateway
• --json
• options RPC de nœud depuis openclaw nodes

​

approvals set

• --node <node>
• --gateway
• --file <path>
• --stdin
• --json
• options RPC de nœud depuis openclaw nodes

​

approvals allowlist add|remove

• --node <node>
• --gateway
• --agent <id> (par défaut *)
• --json
• options RPC de nœud depuis openclaw nodes

​

status

• --json
• --all (diagnostic complet ; lecture seule, prêt à coller)
• --deep (demande à la gateway une sonde de santé live, y compris des sondes de canal lorsque prises en charge)
• --usage (affiche l’utilisation/quota du provider de modèle)
• --timeout <ms>
• --verbose
• --debug (alias de --verbose)

• La vue d’ensemble inclut l’état du service Gateway + node host lorsqu’il est disponible.
• --usage affiche les fenêtres d’utilisation provider normalisées sous la forme X% left.

​

Suivi d’utilisation

• /status (ajoute une courte ligne d’utilisation provider lorsqu’elle est disponible)
• openclaw status --usage (affiche la ventilation complète par provider)
• barre de menus macOS (section Usage sous Context)

• Les données proviennent directement des points de terminaison d’utilisation des providers (pas d’estimations).
• La sortie lisible par un humain est normalisée à X% left pour tous les providers.
• Providers avec fenêtres d’utilisation actuelles : Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi et z.ai.
• Remarque MiniMax : les champs bruts usage_percent / usagePercent signifient quota restant, donc OpenClaw les inverse avant affichage ; les champs basés sur les décomptes restent prioritaires lorsqu’ils sont présents. Les réponses model_remains préfèrent l’entrée de modèle de chat, dérivent l’étiquette de fenêtre à partir des horodatages si nécessaire et incluent le nom du modèle dans l’étiquette du plan.
• L’authentification d’utilisation provient de hooks spécifiques au provider lorsqu’ils sont disponibles ; sinon OpenClaw se replie sur des identifiants OAuth/API-key correspondants issus des profils auth, de l’environnement ou de la configuration. Si rien ne se résout, l’utilisation est masquée.
• Détails : voir Usage tracking.

​

health

• --json
• --timeout <ms>
• --verbose (force une sonde live et affiche les détails de connexion gateway)
• --debug (alias de --verbose)

• health par défaut peut renvoyer un snapshot gateway récent mis en cache.
• health --verbose force une sonde live et étend la sortie lisible par un humain à tous les comptes et agents configurés.

​

sessions

• --json
• --verbose
• --store <path>
• --active <minutes>
• --agent <id> (filtre les sessions par agent)
• --all-agents (affiche les sessions de tous les agents)

• sessions cleanup — supprime les sessions expirées ou orphelines

• sessions cleanup prend aussi en charge --fix-missing pour élaguer les entrées dont les fichiers de transcription ont disparu.

​

Reset / Uninstall

​

reset

• --scope <config|config+creds+sessions|full>
• --yes
• --non-interactive
• --dry-run

• --non-interactive nécessite --scope et --yes.

​

uninstall

• --service
• --state
• --workspace
• --app
• --all
• --yes
• --non-interactive
• --dry-run

• --non-interactive nécessite --yes et des étendues explicites (ou --all).
• --all supprime ensemble le service, l’état, l’espace de travail et l’application.

​

tasks

• tasks list — affiche les exécutions de tâche actives et récentes
• tasks show <id> — affiche les détails d’une exécution de tâche spécifique
• tasks notify <id> — modifie la politique de notification d’une exécution de tâche
• tasks cancel <id> — annule une tâche en cours d’exécution
• tasks audit — met en évidence les problèmes opérationnels (obsolètes, perdues, échecs de livraison)
• tasks maintenance [--apply] [--json] — prévisualise ou applique le nettoyage/la réconciliation des tâches et de TaskFlow (sessions enfant ACP/subagent, jobs cron actifs, exécutions CLI live)
• tasks flow list — liste les flux Task Flow actifs et récents
• tasks flow show <lookup> — inspecte un flux par id ou clé de recherche
• tasks flow cancel <lookup> — annule un flux en cours d’exécution et ses tâches actives

​

flows

• tasks flow list [--json]
• tasks flow show <lookup>
• tasks flow cancel <lookup>

​

Gateway

​

gateway

• --port <port>
• --bind <loopback|tailnet|lan|auto|custom>
• --token <token>
• --auth <token|password>
• --password <password>
• --password-file <path>
• --tailscale <off|serve|funnel>
• --tailscale-reset-on-exit
• --allow-unconfigured
• --dev
• --reset (réinitialise la config dev + identifiants + sessions + espace de travail)
• --force (tue l’écouteur existant sur le port)
• --verbose
• --cli-backend-logs
• --claude-cli-logs (alias déprécié)
• --ws-log <auto|full|compact>
• --compact (alias de --ws-log compact)
• --raw-stream
• --raw-stream-path <path>

​

gateway service

• gateway status (sonde la RPC Gateway par défaut)
• gateway install (installation du service)
• gateway uninstall
• gateway start
• gateway stop
• gateway restart

• gateway status sonde par défaut la RPC Gateway en utilisant le port/la configuration résolus du service (remplacez avec --url/--token/--password).
• gateway status prend en charge --no-probe, --deep, --require-rpc et --json pour les scripts.
• gateway status met également en évidence les services gateway historiques ou supplémentaires lorsqu’il peut les détecter (--deep ajoute des analyses au niveau système). Les services OpenClaw nommés par profil sont traités comme de première classe et ne sont pas signalés comme « supplémentaires ».
• gateway status reste disponible pour le diagnostic même si la configuration CLI locale est absente ou invalide.
• gateway status affiche le chemin résolu du journal fichier, le snapshot des chemins/validités de configuration CLI-vs-service et l’URL cible de sonde résolue.
• Si les SecretRefs d’authentification gateway ne sont pas résolus dans le chemin de commande actuel, gateway status --json ne signale rpc.authWarning que lorsque la connectivité/authentification de la sonde échoue (les avertissements sont supprimés lorsque la sonde réussit).
• Sur les installations Linux systemd, les vérifications de dérive de jeton dans status incluent les sources d’unité Environment= et EnvironmentFile=.
• gateway install|uninstall|start|stop|restart prend en charge --json pour les scripts (la sortie par défaut reste conviviale pour les humains).
• gateway install utilise Node par défaut ; bun est non recommandé (bogues WhatsApp/Telegram).
• Options de gateway install : --port, --runtime, --token, --force, --json.

​

daemon

• daemon status
• daemon install
• daemon uninstall
• daemon start
• daemon stop
• daemon restart

• status : --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
• install : --port, --runtime <node|bun>, --token, --force, --json
• uninstall|start|stop|restart : --json

​

logs

• --limit <n> : nombre maximal de lignes de journal à renvoyer
• --max-bytes <n> : nombre maximal d’octets à lire depuis le fichier journal
• --follow : suit le fichier journal (style tail -f)
• --interval <ms> : intervalle d’interrogation en ms lors du suivi
• --local-time : affiche les horodatages en heure locale
• --json : émet du JSON délimité par des lignes
• --plain : désactive la mise en forme structurée
• --no-color : désactive les couleurs ANSI
• --url <url> : URL WebSocket Gateway explicite
• --token <token> : jeton Gateway
• --timeout <ms> : délai d’attente RPC Gateway
• --expect-final : attend une réponse finale lorsque nécessaire

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json
openclaw logs --no-color

• Si vous passez --url, la CLI n’applique pas automatiquement les identifiants de configuration ou d’environnement.
• Les échecs de pairing local loopback se replient sur le fichier journal local configuré ; les cibles --url explicites ne le font pas.

​

gateway <subcommand>

• gateway call <method> [--params <json>] [--url <url>] [--token <token>] [--password <password>] [--timeout <ms>] [--expect-final] [--json]
• gateway health
• gateway status
• gateway probe
• gateway discover
• gateway install|uninstall|start|stop|restart
• gateway run

• gateway status --deep ajoute une analyse de service au niveau système. Utilisez gateway probe, health --verbose ou le status --deep de premier niveau pour des détails de sonde d’exécution plus approfondis.

• config.schema.lookup (inspecte un sous-arbre de configuration avec un nœud de schéma superficiel, des métadonnées d’indice correspondantes et des résumés des enfants immédiats)
• config.get (lit le snapshot de configuration actuel + hash)
• config.set (valide + écrit la configuration complète ; utilisez baseHash pour la concurrence optimiste)
• config.apply (valide + écrit la configuration + redémarre + réveille)
• config.patch (fusionne une mise à jour partielle + redémarre + réveille)
• update.run (exécute la mise à jour + redémarre + réveille)

​

Models

openclaw models auth login --provider anthropic --method cli --set-default

​

models (racine)

• --status-json (alias de models status --json)
• --status-plain (alias de models status --plain)

​

models list

• --all
• --local
• --provider <name>
• --json
• --plain

​

models status

• --json
• --plain
• --check (quitte avec 1=expiré/manquant, 2=expiration proche)
• --probe (sonde live des profils auth configurés)
• --probe-provider <name>
• --probe-profile <id> (répéter ou séparer par des virgules)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id>

​

models set <model>

​

models set-image <model>

​

models aliases list|add|remove

• list : --json, --plain
• add <alias> <model>
• remove <alias>

​

models fallbacks list|add|remove|clear

• list : --json, --plain
• add <model>
• remove <model>
• clear

​

models image-fallbacks list|add|remove|clear

• list : --json, --plain
• add <model>
• remove <model>
• clear

​

models scan

• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms>
• --concurrency <n>
• --no-probe
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

models auth add|login|login-github-copilot|setup-token|paste-token

• add : assistant auth interactif (flux auth provider ou collage de jeton)
• login : --provider <name>, --method <method>, --set-default
• login-github-copilot : flux de connexion OAuth GitHub Copilot (--yes)
• setup-token : --provider <name>, --yes
• paste-token : --provider <name>, --profile-id <id>, --expires-in <duration>

• setup-token et paste-token sont des commandes de jeton génériques pour les providers qui exposent des méthodes d’authentification par jeton.
• setup-token nécessite un TTY interactif et exécute la méthode d’authentification par jeton du provider.
• paste-token demande la valeur du jeton et utilise par défaut l’identifiant de profil auth <provider>:manual lorsque --profile-id est omis.
• Anthropic setup-token / paste-token sont à nouveau disponibles comme chemin OpenClaw historique/manuel. Anthropic a indiqué aux utilisateurs d’OpenClaw que ce chemin nécessite Extra Usage sur le compte Claude.

​

models auth order get|set|clear

• get : --provider <name>, --agent <id>, --json
• set : --provider <name>, --agent <id>, <profileIds...>
• clear : --provider <name>, --agent <id>

​

System

​

system event

• --text <text>

• --mode <now|next-heartbeat>
• --json
• --url, --token, --timeout, --expect-final

​

system heartbeat last|enable|disable

• --json
• --url, --token, --timeout, --expect-final

​

system presence

• --json
• --url, --token, --timeout, --expect-final

​

Cron

• cron status [--json]
• cron list [--all] [--json] (sortie tableau par défaut ; utilisez --json pour le brut)
• cron add (alias : create ; nécessite --name et exactement un de --at | --every | --cron, et exactement une charge utile parmi --system-event | --message)
• cron edit <id> (corrige des champs)
• cron rm <id> (alias : remove, delete)
• cron enable <id>
• cron disable <id>
• cron runs --id <id> [--limit <n>]
• cron run <id> [--due]

​

Hôte de nœud

​

node

• node run --host <gateway-host> --port 18789
• node status
• node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
• node uninstall
• node stop
• node restart

• node résout l’authentification gateway depuis l’environnement/la configuration (pas d’indicateurs --token/--password) : OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD, puis gateway.auth.*. En mode local, node host ignore volontairement gateway.remote.* ; en gateway.mode=remote, gateway.remote.* participe selon les règles de priorité à distance.
• La résolution d’authentification de node host ne respecte que les variables d’environnement OPENCLAW_GATEWAY_*.

​

Nodes

• --url, --token, --timeout, --json

• nodes status [--connected] [--last-connected <duration>]
• nodes describe --node <id|name|ip>
• nodes list [--connected] [--last-connected <duration>]
• nodes pending
• nodes approve <requestId>
• nodes reject <requestId>
• nodes rename --node <id|name|ip> --name <displayName>
• nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
• nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (mac uniquement)

• nodes camera list --node <id|name|ip>
• nodes camera snap --node <id|name|ip> [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]
• nodes camera clip --node <id|name|ip> [--facing front|back] [--device-id <id>] [--duration <ms|10s|1m>] [--no-audio] [--invoke-timeout <ms>]

• nodes canvas snapshot --node <id|name|ip> [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]
• nodes canvas present --node <id|name|ip> [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]
• nodes canvas hide --node <id|name|ip> [--invoke-timeout <ms>]
• nodes canvas navigate <url> --node <id|name|ip> [--invoke-timeout <ms>]
• nodes canvas eval [<js>] --node <id|name|ip> [--js <code>] [--invoke-timeout <ms>]
• nodes canvas a2ui push --node <id|name|ip> (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]
• nodes canvas a2ui reset --node <id|name|ip> [--invoke-timeout <ms>]
• nodes screen record --node <id|name|ip> [--screen <index>] [--duration <ms|10s>] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]

• nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]

​

Browser

• --url, --token, --timeout, --expect-final, --json
• --browser-profile <name>

• browser status
• browser start
• browser stop
• browser reset-profile
• browser tabs
• browser open <url>
• browser focus <targetId>
• browser close [targetId]
• browser profiles
• browser create-profile --name <name> [--color <hex>] [--cdp-url <url>] [--driver existing-session] [--user-data-dir <path>]
• browser delete-profile --name <name>

• browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]
• browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]

• browser navigate <url> [--target-id <id>]
• browser resize <width> <height> [--target-id <id>]
• browser click <ref> [--double] [--button <left|right|middle>] [--modifiers <csv>] [--target-id <id>]
• browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]
• browser press <key> [--target-id <id>]
• browser hover <ref> [--target-id <id>]
• browser drag <startRef> <endRef> [--target-id <id>]
• browser select <ref> <values...> [--target-id <id>]
• browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]
• browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]
• browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]
• browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]
• browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]
• browser console [--level <error|warn|info>] [--target-id <id>]
• browser pdf [--target-id <id>]

​

Appel vocal

​

voicecall

• voicecall call --to <phone> --message <text> [--mode notify|conversation]
• voicecall start --to <phone> [--message <text>] [--mode notify|conversation]
• voicecall continue --call-id <id> --message <text>
• voicecall speak --call-id <id> --message <text>
• voicecall end --call-id <id>
• voicecall status --call-id <id>
• voicecall tail [--file <path>] [--since <n>] [--poll <ms>]
• voicecall latency [--file <path>] [--last <n>]
• voicecall expose [--mode off|serve|funnel] [--path <path>] [--port <port>] [--serve-path <path>]

​

Recherche dans la documentation

​

docs

​

docs [query...]

​

TUI

​

tui

• --url <url>
• --token <token>
• --password <password>
• --session <key>
• --deliver
• --thinking <level>
• --message <text>
• --timeout-ms <ms> (par défaut agents.defaults.timeoutSeconds)
• --history-limit <n>