Dominando la CLI de OpenClaw

Referencia de la CLI

Esta página describe el comportamiento actual de la CLI. Si los comandos cambian, actualiza este documento.

Páginas de comandos

• setup
• onboard
• configure
• config
• completion
• doctor
• dashboard
• backup
• reset
• uninstall
• update
• message
• agent
• agents
• acp
• mcp
• status
• health
• sessions
• gateway
• logs
• system
• models
• infer
• memory
• wiki
• directory
• nodes
• devices
• node
• approvals
• sandbox
• tui
• browser
• cron
• tasks
• flows
• dns
• docs
• hooks
• webhooks
• pairing
• qr
• plugins (comandos de plugins)
• channels
• security
• secrets
• skills
• daemon (alias heredado para comandos del servicio gateway)
• clawbot (espacio de nombres de alias heredado)
• voicecall (plugin; si está instalado)

Flags globales

• --dev: aisla el estado bajo ~/.openclaw-dev y cambia los puertos por defecto.
• --profile <name>: aisla el estado bajo ~/.openclaw-<name>.
• --container <name>: apunta a un contenedor específico para la ejecución.
• --no-color: desactiva los colores ANSI.
• --update: atajo para openclaw update (solo para instalaciones desde el código fuente).
• -V, --version, -v: imprime la versión y sale.

Estilo de salida

• Los colores ANSI y los indicadores de progreso solo se muestran en sesiones TTY.
• Los hipervínculos OSC-8 aparecen como enlaces en los que puedes hacer clic en terminales compatibles; si no, verás las URLs normales.
• --json (y --plain donde sea compatible) desactiva el estilo para que tengas una salida limpia.
• --no-color desactiva el estilo ANSI; también se respeta la variable NO_COLOR=1.
• Los comandos de larga duración muestran un indicador de progreso (OSC 9;4 cuando es compatible).

Paleta de colores

OpenClaw usa una paleta “lobster” para la salida de la CLI.

• accent (#FF5A2D): encabezados, etiquetas y resaltados principales.
• accentBright (#FF7A3D): nombres de comandos y énfasis.
• accentDim (#D14A22): texto de resaltado secundario.
• info (#FF8A5B): valores informativos.
• success (#2FBF71): estados de éxito.
• warn (#FFB020): advertencias, fallbacks y atención.
• error (#E23D2D): errores y fallos.
• muted (#8B7F77): falta de énfasis y metadatos.

La fuente de la verdad de la paleta está en: src/terminal/palette.ts (la “paleta lobster”).

Árbol de comandos

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
  wiki
    status
    doctor
    init
    ingest
    compile
    lint
    search
    get
    apply
    bridge import
    unsafe-local import
    obsidian status|search|open|command|daily
  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
  infer (alias: capability)
    list
    inspect
    model run|list|inspect|providers|auth login|logout|status
    image generate|edit|describe|describe-many|providers
    audio transcribe|providers
    tts convert|voices|providers|status|enable|disable|set-provider
    video generate|describe|providers
    web search|fetch|providers
    embedding create|providers
    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

Nota: los plugins pueden añadir comandos adicionales de nivel superior (por ejemplo, openclaw voicecall).

Seguridad

• openclaw security audit — audita la configuración y el estado local para detectar errores de seguridad comunes.
• openclaw security audit --deep — una sonda en vivo del Gateway.
• openclaw security audit --fix — refuerza los valores predeterminados seguros y los permisos de configuración.

Secretos

secrets

Administra SecretRefs y la higiene del entorno de ejecución y configuración.

Subcomandos:

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

Opciones de secrets reload:

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

Opciones de secrets audit:

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

Opciones de secrets configure:

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

Opciones de secrets apply --from <path>:

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

Notas:

• reload es una RPC del Gateway y mantiene la última captura válida del entorno de ejecución cuando falla la resolución.
• audit --check devuelve un código de salida distinto de cero si encuentra problemas; las referencias sin resolver usan un código de mayor prioridad.
• Las comprobaciones de ejecución en modo dry-run se omiten por defecto; usa --allow-exec para activarlas.

Plugins

Gestiona las extensiones y su configuración:

• openclaw plugins list — descubre plugins (usa --json para obtener datos procesables).
• openclaw plugins inspect <id> — muestra detalles de un plugin (info es un alias).
• openclaw plugins install <path|.tgz|npm-spec|plugin@marketplace> — instala un plugin (o añade una ruta a plugins.load.paths; usa --force para sobrescribir una instalación existente).
• openclaw plugins marketplace list <marketplace> — lista las entradas del marketplace antes de instalar.
• openclaw plugins enable <id> / disable <id> — cambia el estado de plugins.entries.<id>.enabled.
• openclaw plugins doctor — informa errores al cargar plugins.

La mayoría de los cambios en los plugins requieren reiniciar el Gateway. Consulta /plugin.

Memoria

Búsqueda vectorial sobre MEMORY.md + memory/*.md:

• openclaw memory status — muestra estadísticas del índice; usa --deep para comprobaciones de preparación de vectores + embeddings o --fix para reparar artefactos de recall/promotion obsoletos.
• openclaw memory index — reindexa los archivos de memoria.
• openclaw memory search "<query>" (o --query "<query>") — búsqueda semántica sobre la memoria.
• openclaw memory promote — clasifica los recalls a corto plazo y, opcionalmente, añade las entradas principales a MEMORY.md.

Sandbox

Gestiona los runtimes de Sandbox para la ejecución aislada de agentes. Consulta /cli/sandbox.

Subcomandos:

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

Notas:

• sandbox recreate elimina los runtimes existentes para que el próximo uso los vuelva a generar con la configuración actual.
• Para los backends ssh y OpenShell remote, recreate elimina el espacio de trabajo remoto canónico para el alcance seleccionado.

Comandos slash del chat

Los mensajes de chat admiten comandos /... (texto y nativos). Consulta /tools/slash-commands.

Destacados:

• /status para diagnósticos rápidos.
• /config para cambios de configuración persistentes.
• /debug para sobrescribir la configuración solo en tiempo de ejecución (en memoria, no en disco; requiere commands.debug: true).

Configuración y onboarding

completion

Genera scripts de shell-completion y, opcionalmente, los instala en tu perfil de shell.

Opciones:

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

Notas:

• Sin --install o --write-state, completion imprime el script en stdout.
• --install escribe un bloque OpenClaw Completion en tu perfil de shell y lo apunta al script en caché bajo el directorio de estado de OpenClaw.

setup

Inicializa la configuración y el workspace.

Opciones:

• --workspace <dir>: ruta del workspace del agente (por defecto ~/.openclaw/workspace).
• --wizard: ejecuta el onboarding.
• --non-interactive: ejecuta el onboarding sin preguntas.
• --mode <local|remote>: modo de onboarding.
• --remote-url <url>: URL del Gateway remoto.
• --remote-token <token>: token del Gateway remoto.

El onboarding se ejecuta automáticamente cuando aparece cualquier flag de onboarding (--non-interactive, --mode, --remote-url, --remote-token).

onboard

Onboarding interactivo para el gateway, el workspace y las skills.

Opciones:

• --workspace <dir>
• --reset (restablece configuración + credenciales + sesiones antes del onboarding)
• --reset-scope <config|config+creds+sessions|full> (por defecto config+creds+sessions; usa full para eliminar también el workspace)
• --non-interactive
• --mode <local|remote>
• --flow <quickstart|advanced|manual> (manual es un alias de advanced)
• --auth-choice <choice> donde <choice> es uno 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
• Nota sobre Qwen: qwen-* es la familia canónica de auth-choice. Los IDs modelstudio-* se aceptan solo como alias de compatibilidad heredados.
• --secret-input-mode <plaintext|ref> (por defecto plaintext; usa ref para almacenar referencias de entorno por defecto del proveedor en lugar de claves en texto plano)
• --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> (no interactivo; usado con --auth-choice custom-api-key)
• --custom-model-id <id> (no interactivo; usado con --auth-choice custom-api-key)
• --custom-api-key <key> (no interactivo; opcional; usado con --auth-choice custom-api-key; usa CUSTOM_API_KEY si se omite)
• --custom-provider-id <id> (no interactivo; ID de proveedor personalizado opcional)
• --custom-compatibility <openai|anthropic> (no interactivo; opcional; por defecto openai)
• --gateway-port <port>
• --gateway-bind <loopback|lan|tailnet|auto|custom>
• --gateway-auth <token|password>
• --gateway-token <token>
• --gateway-token-ref-env <name> (no interactivo; almacena gateway.auth.token como un SecretRef de entorno; requiere que esa variable de entorno esté configurada; no se puede combinar con --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> (gestor de nodos para skills en setup/onboarding; se recomienda pnpm, también se admite bun)
• --json

configure

Asistente de configuración interactivo (modelos, canales, skills, gateway).

Opciones:

• --section <section> (repetible; limita el asistente a secciones específicas)

config

Ayudantes de configuración no interactivos (get/set/unset/file/schema/validate). Ejecutar openclaw config sin subcomando inicia el asistente.

Subcomandos:

• config get <path>: imprime un valor de configuración (ruta por punto/corchete).
• config set: admite cuatro modos de asignación:
  • modo valor: config set <path> <value> (análisis JSON5 o string)
  • modo constructor SecretRef: config set <path> --ref-provider <provider> --ref-source <source> --ref-id <id>
  • modo constructor de proveedor: config set secrets.providers.<alias> --provider-source <env|file|exec> ...
  • modo lote: config set --batch-json '<json>' o config set --batch-file <path>
• config set --dry-run: valida las asignaciones sin escribir en openclaw.json (las comprobaciones de exec SecretRef se omiten por defecto).
• config set --allow-exec --dry-run: activa las comprobaciones dry-run de exec SecretRef (puede ejecutar comandos del proveedor).
• config set --dry-run --json: emite una salida dry-run legible por máquina (comprobaciones + señal de completitud, operaciones, referencias comprobadas/omitidas, errores).
• config set --strict-json: requiere análisis JSON5 para la entrada de ruta/valor. --json se mantiene como alias heredado para análisis estricto fuera del modo de salida dry-run.
• config unset <path>: elimina un valor.
• config file: imprime la ruta del archivo de configuración activo.
• config schema: imprime el esquema JSON generado para openclaw.json, incluyendo metadatos de documentación de los campos title / description propagados a través de objetos anidados, comodines, elementos de array y ramas de composición, además de metadatos de esquema de plugins/canales en tiempo real.
• config validate: valida la configuración actual contra el esquema sin iniciar el gateway.
• config validate --json: emite una salida JSON legible por máquina.

doctor

Comprobaciones de salud + reparaciones rápidas (configuración + gateway + servicios heredados).

Opciones:

• --no-workspace-suggestions: desactiva las sugerencias de memoria del workspace.
• --yes: acepta los valores por defecto sin preguntar (headless).
• --non-interactive: omite preguntas; aplica solo migraciones seguras.
• --deep: escanea los servicios del sistema en busca de instalaciones adicionales del gateway.
• --repair (alias: --fix): intenta reparaciones automáticas para los problemas detectados.
• --force: fuerza las reparaciones incluso cuando no son estrictamente necesarias.
• --generate-gateway-token: genera un nuevo token de autenticación para el gateway.

dashboard

Abre la UI de Control con tu token actual.

Opciones:

• --no-open: imprime la URL pero no lanza el navegador.

Notas:

• Para tokens de gateway gestionados por SecretRef, dashboard imprime o abre una URL sin token en lugar de exponer el secreto en la salida de la terminal o en los argumentos de lanzamiento del navegador.

update

Actualiza la CLI instalada.

Opciones raíz:

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

Subcomandos:

• update status
• update wizard

Opciones de update status:

• --json
• --timeout <seconds>

Opciones de update wizard:

• --timeout <seconds>

Notas:

• openclaw --update se redirige a openclaw update.

backup

Crea y verifica archivos de respaldo locales para el estado de OpenClaw.

Subcomandos:

• backup create
• backup verify <archive>

Opciones de backup create:

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

Opciones de backup verify <archive>:

• --json

Ayudantes de canales

channels

Administra cuentas de canales de chat (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/Microsoft Teams).

Subcomandos:

• channels list: muestra los canales configurados y los perfiles de autenticación.
• channels status: verifica la conectividad del Gateway y la salud del canal (--probe ejecuta comprobaciones de auditoría/sondeo en vivo por cuenta cuando el Gateway es accesible; si no, recurre a resúmenes de canales basados solo en la configuración. Usa openclaw health o openclaw status --deep para sondeos de salud del Gateway más amplios).
• Consejo: channels status imprime advertencias con sugerencias de solución cuando detecta errores de configuración comunes (luego te dirige a openclaw doctor).
• channels logs: muestra los logs recientes de los canales desde el archivo de log del Gateway.
• channels add: configuración estilo asistente cuando no se pasan flags; las flags activan el modo no interactivo.
  • Al añadir una cuenta que no es la predeterminada a un canal que todavía usa una configuración de nivel superior de cuenta única, OpenClaw promueve los valores con alcance de cuenta al mapa de cuentas del canal antes de escribir la nueva cuenta. La mayoría de los canales usan accounts.default; Matrix puede preservar un destino con nombre/predeterminado existente que coincida.
  • channels add en modo no interactivo no crea ni actualiza bindings automáticamente; los bindings que son solo de canal seguirán coincidiendo con la cuenta predeterminada.
• channels remove: desactivado por defecto; pasa --delete para eliminar entradas de configuración sin confirmaciones.
• channels login: inicio de sesión interactivo en el canal (solo WhatsApp Web).
• channels logout: cierra la sesión de un canal (si es compatible).

Opciones comunes:

• --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
• --account <id>: ID de la cuenta del canal (por defecto default)
• --name <label>: nombre visible para la cuenta

Opciones de channels login:

• --channel <channel> (por defecto whatsapp; soporta whatsapp/web)
• --account <id>
• --verbose

Opciones de channels logout:

• --channel <channel> (por defecto whatsapp)
• --account <id>

Opciones de channels list:

• --no-usage: omite los resúmenes de uso/cuota del proveedor de modelos (solo para los que usan OAuth/API).
• --json: salida en JSON (incluye el uso a menos que se use --no-usage).

Opciones de channels status:

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

Opciones de channels capabilities:

• --channel <name>
• --account <id> (solo con --channel)
• --target <dest>
• --timeout <ms>
• --json

Opciones de channels resolve:

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

Opciones de channels logs:

• --channel <name|all> (por defecto all)
• --lines <n> (por defecto 200)
• --json

Notas:

• channels login soporta --verbose.
• channels capabilities --account solo se aplica cuando --channel está configurado.
• channels status --probe puede mostrar el estado del transporte además de los resultados del sondeo/auditoría como works, probe failed, audit ok o audit failed, dependiendo del soporte del canal.

Más detalles en: /concepts/oauth

Ejemplos:

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

Busca IDs propios, de pares (peers) y de grupos para canales que exponen una superficie de directorio. Consulta openclaw directory.

Opciones comunes:

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

Subcomandos:

• 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

Lista e inspecciona las skills disponibles además de información sobre su preparación (readiness).

Subcomandos:

• skills search [query...]: busca skills en ClawHub.
• skills search --limit <n> --json: limita los resultados de búsqueda o genera una salida procesable por máquinas.
• skills install <slug>: instala una skill desde ClawHub en el workspace activo.
• skills install <slug> --version <version>: instala una versión específica de ClawHub.
• skills install <slug> --force: sobrescribe una carpeta de skill existente en el workspace.
• skills update <slug|--all>: actualiza las skills de ClawHub rastreadas.
• skills list: lista las skills (por defecto si no hay subcomando).
• skills list --json: genera un inventario de skills procesable por máquinas en stdout.
• skills list --verbose: incluye los requisitos faltantes en la tabla.
• skills info <name>: muestra detalles de una skill.
• skills info <name> --json: genera detalles procesables por máquinas en stdout.
• skills check: resumen de requisitos listos frente a los faltantes.
• skills check --json: genera una salida de preparación procesable por máquinas en stdout.

Opciones:

• --eligible: muestra solo las skills que están listas.
• --json: salida en JSON (sin estilo).
• -v, --verbose: incluye detalles de los requisitos faltantes.

Consejo: usa openclaw skills search, openclaw skills install y openclaw skills update para skills respaldadas por ClawHub.

pairing

Aprueba solicitudes de emparejamiento de DM en todos los canales.

Subcomandos:

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

Notas:

• Si solo hay configurado un canal con capacidad de emparejamiento, también se permite pairing approve <code>.
• Tanto list como approve soportan --account <id> para canales con múltiples cuentas.

devices

Administra las entradas de emparejamiento de dispositivos del Gateway y los tokens de dispositivo por rol.

Subcomandos:

• 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>

Notas:

• devices list y devices approve pueden recurrir a archivos de emparejamiento locales en loopback local cuando el alcance de emparejamiento directo no está disponible.
• devices approve requiere un ID de solicitud explícito antes de generar tokens; omitir requestId o pasar --latest solo previsualiza la solicitud pendiente más reciente.
• Las reconexiones con tokens almacenados reutilizan los alcances (scopes) aprobados en caché del token; un devices rotate --scope ... explícito actualiza ese conjunto de alcances almacenados para futuras reconexiones con tokens en caché.
• devices rotate y devices revoke devuelven payloads en JSON.

qr

Genera un QR de emparejamiento móvil y un código de configuración desde la configuración actual del Gateway. Consulta openclaw qr.

Opciones:

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

Notas:

• --token y --password son mutuamente excluyentes.
• El código de configuración lleva un token de bootstrap de corta duración, no el token/password compartido del Gateway.
• La transferencia de bootstrap integrada mantiene el token del nodo primario en scopes: [].
• Cualquier token de bootstrap de operador transferido permanece limitado a operator.approvals, operator.read, operator.talk.secrets y operator.write.
• Las comprobaciones de alcance de bootstrap tienen prefijo de rol, de modo que la lista de permitidos del operador solo satisface solicitudes del operador; los roles que no son de operador aún necesitan alcances bajo su propio prefijo de rol.
• --remote puede usar gateway.remote.url o la URL activa de Tailscale Serve/Funnel.
• Después de escanear, aprueba la solicitud con openclaw devices list / openclaw devices approve <requestId>.

clawbot

Espacio de nombres de alias heredado. Actualmente soporta openclaw clawbot qr, que se mapea a openclaw qr.

hooks

Administra los hooks internos del agente.

Subcomandos:

• hooks list
• hooks info <name>
• hooks check
• hooks enable <name>
• hooks disable <name>
• hooks install <path-or-spec> (alias obsoleto para openclaw plugins install)
• hooks update [id] (alias obsoleto para openclaw plugins update)

Opciones comunes:

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

Notas:

• Los hooks gestionados por plugins no se pueden activar o desactivar a través de openclaw hooks; activa o desactiva el plugin propietario en su lugar.
• hooks install y hooks update todavía funcionan como alias de compatibilidad, pero imprimen advertencias de obsolescencia y redirigen a los comandos de plugins.

webhooks

Ayudantes de webhooks. La superficie integrada actual es la configuración y el ejecutor de Gmail Pub/Sub:

• webhooks gmail setup
• webhooks gmail run

webhooks gmail

Configuración y ejecutor del hook de Gmail Pub/Sub. Consulta Gmail Pub/Sub.

Subcomandos:

• webhooks gmail setup (requiere --account <email>; soporta --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 (sobrescrituras en tiempo de ejecución para las mismas flags)

Notas:

• setup configura el watch de Gmail más la ruta de push orientada a OpenClaw.
• run inicia el bucle local de vigilancia/renovación de Gmail con sobrescrituras opcionales en tiempo de ejecución.

dns

Ayudantes de DNS de descubrimiento de área amplia (CoreDNS + Tailscale). Superficie integrada actual:

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

dns setup

Ayudante de DNS de descubrimiento de área amplia (CoreDNS + Tailscale. Consulta /gateway/discovery.

Opciones:

• --domain <domain>
• --apply: instala/actualiza la configuración de CoreDNS (requiere sudo; solo macOS).

Notas:

• Sin --apply, este es un ayudante de planificación que imprime la configuración de DNS recomendada para OpenClaw + Tailscale.
• --apply actualmente solo soporta macOS con CoreDNS de Homebrew.

Mensajería + agente

message

Mensajería saliente unificada + acciones de canal.

Consulta: /cli/message

Subcomandos:

• 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>

Ejemplos:

• 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

Ejecuta un turno del agente a través del Gateway (o embebido con --local).

Pasa al menos un selector de sesión: --to, --session-id o --agent.

Requerido:

• -m, --message <text>

Opciones:

• -t, --to <dest> (para la clave de sesión y entrega opcional)
• --session-id <id>
• --agent <id> (ID del agente; sobrescribe los bindings de enrutamiento)
• --thinking <off|minimal|low|medium|high|xhigh> (el soporte del proveedor varía; no está limitado por el modelo a nivel de CLI)
• --verbose <on|off>
• --channel <channel> (canal de entrega; omítelo para usar el canal principal de la sesión)
• --reply-to <target> (sobrescritura del destino de entrega, independiente del enrutamiento de la sesión)
• --reply-channel <channel> (sobrescritura del canal de entrega)
• --reply-account <id> (sobrescritura del ID de la cuenta de entrega)
• --local (ejecución embebida; el registro de plugins se precarga primero)
• --deliver
• --json
• --timeout <seconds>

Notas:

• El modo Gateway recurre al agente embebido cuando falla la solicitud al Gateway.
• --local todavía precarga el registro de plugins, por lo que los proveedores, herramientas y canales proporcionados por plugins siguen disponibles durante las ejecuciones embebidas.
• --channel, --reply-channel y --reply-account afectan a la entrega de la respuesta, no al enrutamiento.

agents

Administra agentes aislados (workspaces + autenticación + enrutamiento).

Ejecutar openclaw agents sin subcomando es equivalente a openclaw agents list.

agents list

Lista los agentes configurados.

Opciones:

• --json
• --bindings

agents add [name]

Añade un nuevo agente aislado. Ejecuta el asistente guiado a menos que se pasen flags (o --non-interactive); --workspace es obligatorio en modo no interactivo.

Opciones:

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

Las especificaciones de binding usan channel[:accountId]. Cuando se omite accountId, OpenClaw puede resolver el alcance de la cuenta a través de los valores predeterminados del canal o hooks de plugins; de lo contrario, es un binding de canal sin alcance de cuenta explícito. Pasar cualquier flag de adición explícita cambia el comando a la ruta no interactiva. main está reservado y no puede usarse como el nuevo ID de agente.

agents bindings

Lista los bindings de enrutamiento.

Opciones:

• --agent <id>
• --json

agents bind

Añade bindings de enrutamiento para un agente.

Opciones:

• --agent <id> (por defecto es el agente predeterminado actual)
• --bind <channel[:accountId]> (repetible)
• --json

agents unbind

Elimina bindings de enrutamiento para un agente.

Opciones:

• --agent <id> (por defecto es el agente predeterminado actual)
• --bind <channel[:accountId]> (repetible)
• --all
• --json

Usa --all o --bind, pero no ambos.

agents delete <id>

Elimina un agente y poda su workspace + estado.

Opciones:

• --force
• --json

Notas:

• main no se puede eliminar.
• Sin --force, se requiere confirmación interactiva.

agents set-identity

Actualiza la identidad de un agente (nombre/tema/emoji/avatar).

Opciones:

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

Notas:

• Se puede usar --agent o --workspace para seleccionar el agente de destino.
• Cuando no se proporcionan campos de identidad explícitos, el comando lee IDENTITY.md.

acp

Ejecuta el bridge ACP que conecta los IDEs al Gateway.

Opciones raíz:

• --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

Cliente ACP interactivo para depuración del bridge.

Opciones:

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

Consulta acp para ver el comportamiento completo, notas de seguridad y ejemplos.

mcp

Administra definiciones guardadas de servidores MCP y expone canales de OpenClaw a través de MCP stdio.

mcp serve

Expone conversaciones de canales enrutados de OpenClaw a través de MCP stdio.

Opciones:

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

mcp list

Lista las definiciones guardadas de servidores MCP.

Opciones:

• --json

mcp show [name]

Muestra una definición guardada de servidor MCP o el objeto completo del servidor MCP guardado.

Opciones:

• --json

mcp set <name> <value>

Guarda una definición de servidor MCP desde un objeto JSON.

mcp unset <name>

Elimina una definición guardada de servidor MCP.

approvals

Administra las aprobaciones de ejecución (exec). Alias: exec-approvals.

approvals get

Obtiene la instantánea de aprobaciones de ejecución y la política efectiva.

Opciones:

• --node <node>
• --gateway
• --json
• opciones de RPC de nodo de openclaw nodes

approvals set

Reemplaza las aprobaciones de ejecución con JSON desde un archivo o stdin.

Opciones:

• --node <node>
• --gateway
• --file <path>
• --stdin
• --json
• opciones de RPC de nodo de openclaw nodes

approvals allowlist add|remove

Edita la lista de permitidos de ejecución por agente.

Opciones:

• --node <node>
• --gateway
• --agent <id> (por defecto *)
• --json
• opciones de RPC de nodo de openclaw nodes

status

Muestra la salud de las sesiones vinculadas y los destinatarios recientes.

Opciones:

• --json
• --all (diagnóstico completo; solo lectura, para copiar y pegar)
• --deep (pide al Gateway un sondeo de salud en vivo, incluyendo sondeos de canales cuando sea compatible)
• --usage (muestra el uso/cuota del proveedor de modelos)
• --timeout <ms>
• --verbose
• --debug (alias de --verbose)

Notas:

• El resumen incluye el estado del servicio host del Gateway + nodo cuando está disponible.
• --usage imprime ventanas de uso del proveedor normalizadas como X% left.

Seguimiento de uso

OpenClaw puede mostrar el uso/cuota del proveedor cuando las credenciales de OAuth/API están disponibles.

Superficies:

• /status (añade una línea corta de uso del proveedor cuando está disponible)
• openclaw status --usage (imprime el desglose completo del proveedor)
• Barra de menú de macOS (sección Usage bajo Context)

Notas:

• Los datos provienen directamente de los endpoints de uso del proveedor (sin estimaciones).
• La salida legible para humanos se normaliza a X% left en todos los proveedores.
• Proveedores con ventanas de uso actuales: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi y z.ai.
• Nota sobre MiniMax: usage_percent / usagePercent en bruto significa cuota restante, por lo que OpenClaw lo invierte antes de mostrarlo; los campos basados en conteo siguen teniendo prioridad cuando están presentes. Las respuestas de model_remains prefieren la entrada del modelo de chat, derivan la etiqueta de la ventana de los timestamps cuando es necesario e incluyen el nombre del modelo en la etiqueta del plan.
• La autenticación de uso proviene de hooks específicos del proveedor cuando están disponibles; de lo contrario, OpenClaw recurre a las credenciales coincidentes de OAuth/API-key de los perfiles de autenticación, entorno o configuración. Si no se resuelve ninguna, el uso se oculta.
• Detalles: consulta Seguimiento de uso.

health

Obtiene el estado de salud del Gateway en ejecución.

Opciones:

• --json
• --timeout <ms>
• --verbose (fuerza un sondeo en vivo e imprime los detalles de conexión del Gateway)
• --debug (alias de --verbose)

Notas:

• El comando health por defecto puede devolver una instantánea del Gateway en caché reciente.
• health --verbose fuerza un sondeo en vivo y expande la salida legible para humanos en todas las cuentas y agentes configurados.

sessions

Lista las sesiones de conversación almacenadas.

Opciones:

• --json
• --verbose
• --store <path>
• --active <minutes>
• --agent <id> (filtra sesiones por agente)
• --all-agents (muestra sesiones de todos los agentes)

Subcomandos:

• sessions cleanup — elimina sesiones expiradas o huérfanas

Notas:

• sessions cleanup también soporta --fix-missing para podar entradas cuyos archivos de transcripción han desaparecido.

Reset / Desinstalar

reset

Reinicia la configuración o el estado local (mantiene la CLI instalada).

Opciones:

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

Notas:

• --non-interactive requiere el uso de --scope y --yes.

uninstall

Desinstala el servicio gateway y los datos locales (la CLI permanece).

Opciones:

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

Notas:

• --non-interactive requiere --yes y scopes explícitos (o --all).
• --all elimina el servicio, el estado, el workspace y la app al mismo tiempo.

tasks

Lista y gestiona ejecuciones de background task entre agentes.

• tasks list — muestra ejecuciones de tareas activas y recientes
• tasks show <id> — muestra detalles de una ejecución de tarea específica
• tasks notify <id> — cambia la política de notificaciones para una ejecución de tarea
• tasks cancel <id> — cancela una tarea en ejecución
• tasks audit — detecta problemas operativos (tareas estancadas, perdidas o fallos de entrega)
• tasks maintenance [--apply] [--json] — previsualiza o aplica limpieza y reconciliación de tareas y TaskFlow (sesiones hijo de ACP/subagent, cron jobs activos, ejecuciones de CLI en vivo)
• tasks flow list — lista flujos de Task Flow activos y recientes
• tasks flow show <lookup> — inspecciona un flujo por id o clave de búsqueda
• tasks flow cancel <lookup> — cancela un flujo en ejecución y sus tareas activas

flows

Atajo de documentación antigua. Los comandos de Flow ahora viven bajo openclaw tasks flow:

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

Gateway

gateway

Ejecuta el WebSocket Gateway.

Opciones:

• --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 (reinicia la configuración de dev + credenciales + sesiones + workspace)
• --force (fuerza el cierre del listener existente en el puerto)
• --verbose
• --cli-backend-logs
• --ws-log <auto|full|compact>
• --compact (alias de --ws-log compact)
• --raw-stream
• --raw-stream-path <path>

gateway service

Gestiona el servicio Gateway (launchd/systemd/schtasks).

Subcomandos:

• gateway status (sondea el RPC del Gateway por defecto)
• gateway install (instalación del servicio)
• gateway uninstall
• gateway start
• gateway stop
• gateway restart

Notas:

• gateway status sondea el RPC del Gateway por defecto usando el puerto/configuración resuelta del servicio (puedes sobrescribirlo con --url/--token/--password).
• gateway status admite --no-probe, --deep, --require-rpc y --json para scripting.
• gateway status también detecta servicios gateway antiguos o adicionales cuando es posible (--deep añade escaneos a nivel de sistema). Los servicios de OpenClaw con nombre de perfil se tratan como principales y no se marcan como “extra”.
• gateway status sigue disponible para diagnósticos incluso si la configuración local de la CLI falta o no es válida.
• gateway status imprime la ruta resuelta del archivo de log, un resumen de la validez de las rutas de configuración de la CLI frente al servicio y la URL de sondeo resuelta.
• Si los SecretRefs de autenticación del gateway no se resuelven en la ruta del comando actual, gateway status --json informa rpc.authWarning solo cuando la conectividad o autenticación del sondeo falla (los avisos se omiten si el sondeo tiene éxito).
• En instalaciones de systemd en Linux, las comprobaciones de discrepancia de tokens (token-drift) incluyen fuentes de unidad tanto de Environment= como de EnvironmentFile=.
• gateway install|uninstall|start|stop|restart admiten --json para scripting (la salida por defecto sigue siendo amigable para humanos).
• gateway install usa Node como runtime por defecto; no se recomienda usar bun (errores en WhatsApp/Telegram).
• Opciones de gateway install: --port, --runtime, --token, --force, --json.

daemon

Alias antiguo para los comandos de gestión del servicio Gateway. Consulta /cli/daemon.

Subcomandos:

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

Opciones comunes:

• 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

Sigue los logs de archivo del Gateway vía RPC.

Opciones:

• --limit <n>: número máximo de líneas de log a devolver
• --max-bytes <n>: máximo de bytes a leer del archivo de log
• --follow: sigue el archivo de log (estilo tail -f)
• --interval <ms>: intervalo de sondeo en ms al usar follow
• --local-time: muestra las marcas de tiempo en hora local
• --json: emite JSON delimitado por líneas
• --plain: desactiva el formato estructurado
• --no-color: desactiva los colores ANSI
• --url <url>: URL WebSocket explícita del Gateway
• --token <token>: token del Gateway
• --timeout <ms>: tiempo de espera del RPC del Gateway
• --expect-final: espera una respuesta final cuando sea necesario

Ejemplos:

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

Notas:

• Si pasas --url, la CLI no aplica automáticamente la configuración ni las credenciales del entorno.
• Los fallos de emparejamiento en loopback local recurren al archivo de log local configurado; los objetivos con --url explícita no lo hacen.

gateway <subcommand>

Ayudantes de la CLI del Gateway (usa --url, --token, --password, --timeout, --expect-final para subcomandos RPC). Cuando pasas --url, la CLI no aplica automáticamente la configuración ni las credenciales del entorno. Incluye --token o --password de forma explícita. La falta de credenciales explícitas resultará en un error.

Subcomandos:

• 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

Notas:

• gateway status --deep añade un escaneo de servicios a nivel de sistema. Usa gateway probe, health --verbose o el comando status --deep de nivel superior para obtener detalles más profundos del sondeo en runtime.

RPCs comunes:

• config.schema.lookup (inspecciona un subárbol de configuración con un nodo de esquema superficial, metadatos de sugerencias coincidentes y resúmenes de hijos inmediatos)
• config.get (lee la instantánea de configuración actual + hash)
• config.set (valida y escribe la configuración completa; usa baseHash para concurrencia optimista)
• config.apply (valida + escribe configuración + reinicia + despierta)
• config.patch (fusiona una actualización parcial + reinicia + despierta)
• update.run (ejecuta actualización + reinicia + despierta)

Tip: al llamar a config.set/config.apply/config.patch directamente, pasa el baseHash obtenido de config.get si ya existe una configuración. Tip: para ediciones parciales, inspecciona primero con config.schema.lookup y prioriza el uso de config.patch. Tip: estos RPCs de escritura de configuración validan previamente la resolución de SecretRef para las referencias en el payload de configuración enviado y rechazan la escritura si una referencia enviada que debería estar activa no se puede resolver. Tip: la herramienta de runtime gateway (solo para propietarios) sigue rechazando la reescritura de tools.exec.ask o tools.exec.security; los alias antiguos tools.bash.* se normalizan a las mismas rutas de ejecución protegidas.

Modelos

Consulta /concepts/models para conocer el comportamiento de fallback y la estrategia de escaneo.

Nota sobre Anthropic: El personal de Anthropic nos ha comunicado que el uso de Claude CLI al estilo OpenClaw está permitido de nuevo, por lo que OpenClaw trata la reutilización de Claude CLI y el uso de claude -p como autorizados para esta integración, a menos que Anthropic publique una nueva política. Para producción, es mejor que uses una API key de Anthropic u otro proveedor de suscripción compatible como OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan o Z.AI / GLM Coding Plan.

Anthropic setup-token sigue disponible como una ruta de token-auth compatible, pero ahora OpenClaw prefiere la reutilización de Claude CLI y claude -p cuando estén disponibles.

models (root)

openclaw models es un alias de models status.

Opciones de la raíz:

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

models list

Opciones:

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

models status

Opciones:

• --json
• --plain
• --check (salida 1=expirado/faltante, 2=por expirar)
• --probe (sondeo en vivo de los perfiles de auth configurados)
• --probe-provider <name>
• --probe-profile <id> (repetir o separar por comas)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id>

Siempre incluye el resumen de auth y el estado de expiración de OAuth para los perfiles en el almacén de auth. --probe realiza peticiones en vivo (puede consumir tokens y activar límites de tasa). Las filas del probe pueden provenir de perfiles de auth, credenciales de entorno o de models.json. Espera estados de probe como ok, auth, rate_limit, billing, timeout, format, unknown y no_model. Cuando un auth.order.<provider> explícito omite un perfil almacenado, el probe informa excluded_by_auth_order en lugar de intentar usar ese perfil en silencio.

models set <model>

Configura agents.defaults.model.primary.

models set-image <model>

Configura agents.defaults.imageModel.primary.

models aliases list|add|remove

Opciones:

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

models fallbacks list|add|remove|clear

Opciones:

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

models image-fallbacks list|add|remove|clear

Opciones:

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

models scan

Opciones:

• --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

Opciones:

• add: asistente de auth interactivo (flujo de auth del proveedor o pegar token)
• login: --provider <name>, --method <method>, --set-default
• login-github-copilot: flujo de inicio de sesión OAuth de GitHub Copilot (--yes)
• setup-token: --provider <name>, --yes
• paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

Notas:

• setup-token y paste-token son comandos de token genéricos para proveedores que exponen métodos de autenticación por token.
• setup-token requiere una TTY interactiva y ejecuta el método de token-auth del proveedor.
• paste-token solicita el valor del token y usa por defecto el id de perfil de auth <provider>:manual cuando se omite --profile-id.
• Anthropic setup-token / paste-token siguen disponibles como una ruta de token de OpenClaw compatible, pero ahora OpenClaw prefiere la reutilización de Claude CLI y claude -p cuando estén disponibles.

models auth order get|set|clear

Opciones:

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

Sistema

system event

Encola un evento del sistema y, opcionalmente, activa un heartbeat (Gateway RPC).

Requerido:

• --text <text>

Opciones:

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

system heartbeat last|enable|disable

Controles de heartbeat (Gateway RPC).

Opciones:

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

system presence

Lista las entradas de presencia del sistema (Gateway RPC).

Opciones:

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

Cron

Administra tareas programadas (Gateway RPC). Consulta /automation/cron-jobs.

Subcomandos:

• cron status [--json]
• cron list [--all] [--json] (salida en tabla por defecto; usa --json para datos brutos)
• cron add (alias: create; requiere --name y exactamente uno de --at | --every | --cron, y exactamente un payload de --system-event | --message)
• cron edit <id> (parchear campos)
• cron rm <id> (aliases: remove, delete)
• cron enable <id>
• cron disable <id>
• cron runs --id <id> [--limit <n>]
• cron run <id> [--due]

Todos los comandos cron aceptan --url, --token, --timeout, --expect-final.

cron add|edit --model ... usa el modelo permitido seleccionado para la tarea. Si el modelo no está permitido, cron avisa y utiliza la selección de modelo por defecto o del agente de la tarea. Las cadenas de fallback configuradas siguen aplicando, pero un override de modelo simple sin una lista de fallback explícita por tarea ya no añade el modelo principal del agente como un objetivo de reintento extra oculto.

Node host

node

node ejecuta un host de nodo headless o lo administra como un servicio en segundo plano. Consulta openclaw node.

Subcomandos:

• 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

Notas de autenticación:

• node resuelve la autenticación del gateway desde el entorno o la configuración (no existen los flags --token/--password): OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD, y después gateway.auth.*. En modo local, el host del nodo ignora intencionadamente gateway.remote.*; en gateway.mode=remote, gateway.remote.* participa según las reglas de precedencia remota.
• La resolución de autenticación del host del nodo solo respeta las variables de entorno OPENCLAW_GATEWAY_*.

Nodes

nodes se comunica con el Gateway y se dirige a los nodos vinculados. Puedes consultar /nodes.

Opciones comunes:

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

Subcomandos:

• 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>] (solo mac)

Cámara:

• 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>]

Canvas + pantalla:

• 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>]

Ubicación:

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

Browser

CLI de control del Browser (Chrome/Brave/Edge/Chromium dedicado). Consulta openclaw browser y la Browser tool.

Opciones comunes:

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

Gestionar:

• 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>

Inspeccionar:

• 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>]

Acciones:

• 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>]

Llamadas de voz

voicecall

Utilidades de llamadas de voz proporcionadas por el plugin. Solo aparece si el plugin voice-call está instalado y habilitado. Consulta openclaw voicecall.

Comandos comunes:

• 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>]

Búsqueda en la documentación

docs

Busca en el índice de la documentación en vivo de OpenClaw.

docs [query...]

Busca en el índice de la documentación en vivo.

TUI

tui

Abre la interfaz de terminal (TUI) conectada al Gateway.

Opciones:

• --url <url>
• --token <token>
• --password <password>
• --session <key>
• --deliver
• --thinking <level>
• --message <text>
• --timeout-ms <ms> (por defecto es agents.defaults.timeoutSeconds)
• --history-limit <n>