Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Los comandos los gestiona el Gateway. La mayoría de los comandos deben enviarse como un mensaje independiente que empiece por /. El comando de chat bash solo para el host usa ! <cmd> (con /bash <cmd> como alias). Cuando una conversación o hilo está vinculado a una sesión ACP, el texto normal de seguimiento se enruta a ese arnés ACP. Los comandos de administración del Gateway siguen siendo locales: /acp ... siempre llega al manejador de comandos ACP de OpenClaw, y /status más /unfocus permanecen locales siempre que el manejo de comandos esté habilitado para la superficie. Hay dos sistemas relacionados:
Mensajes independientes /....
/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue.
  • Las directivas se eliminan del mensaje antes de que el modelo lo vea.
  • En mensajes de chat normales (no solo directivas), se tratan como “sugerencias en línea” y no persisten la configuración de la sesión.
  • En mensajes solo de directivas (el mensaje contiene únicamente directivas), persisten en la sesión y responden con una confirmación.
  • Las directivas solo se aplican para remitentes autorizados. Si commands.allowFrom está configurado, es la única lista de permitidos usada; de lo contrario, la autorización proviene de las listas de permitidos/emparejamiento del canal más commands.useAccessGroups. Los remitentes no autorizados ven las directivas tratadas como texto sin formato.
Solo remitentes en la lista de permitidos/autorizados: /help, /commands, /status, /whoami (/id).Se ejecutan inmediatamente, se eliminan antes de que el modelo vea el mensaje, y el texto restante continúa por el flujo normal.

Configuración

{
  commands: {
    native: "auto",
    nativeSkills: "auto",
    text: true,
    bash: false,
    bashForegroundMs: 2000,
    config: false,
    mcp: false,
    plugins: false,
    debug: false,
    restart: true,
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw",
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}
commands.text
boolean
predeterminado:"true"
Habilita el análisis de /... en mensajes de chat. En superficies sin comandos nativos (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), los comandos de texto siguen funcionando incluso si estableces esto en false.
commands.native
boolean | "auto"
predeterminado:"\"auto\""
Registra comandos nativos. Auto: activado para Discord/Telegram; desactivado para Slack (hasta que añadas comandos de barra); ignorado para proveedores sin soporte nativo. Establece channels.discord.commands.native, channels.telegram.commands.native o channels.slack.commands.native para sobrescribir por proveedor (bool o "auto"). En Discord, false omite el registro de comandos de barra y la limpieza durante el inicio; los comandos registrados previamente pueden seguir visibles hasta que los elimines de la aplicación de Discord. Los comandos de Slack se gestionan en la aplicación de Slack y no se eliminan automáticamente.
En Discord, las especificaciones de comandos nativos pueden incluir descriptionLocalizations, que OpenClaw publica como description_localizations de Discord e incluye en las comparaciones de conciliación.
commands.nativeSkills
boolean | "auto"
predeterminado:"\"auto\""
Registra comandos de Skills de forma nativa cuando se admite. Auto: activado para Discord/Telegram; desactivado para Slack (Slack requiere crear un comando de barra por Skills). Establece channels.discord.commands.nativeSkills, channels.telegram.commands.nativeSkills o channels.slack.commands.nativeSkills para sobrescribir por proveedor (bool o "auto").
commands.bash
boolean
predeterminado:"false"
Habilita ! <cmd> para ejecutar comandos del shell del host (/bash <cmd> es un alias; requiere listas de permitidos de tools.elevated).
commands.bashForegroundMs
number
predeterminado:"2000"
Controla cuánto tiempo espera bash antes de cambiar al modo en segundo plano (0 lo pone en segundo plano inmediatamente).
commands.config
boolean
predeterminado:"false"
Habilita /config (lee/escribe openclaw.json).
commands.mcp
boolean
predeterminado:"false"
Habilita /mcp (lee/escribe la configuración MCP gestionada por OpenClaw en mcp.servers).
commands.plugins
boolean
predeterminado:"false"
Habilita /plugins (descubrimiento/estado de plugins más controles de instalación y activación/desactivación).
commands.debug
boolean
predeterminado:"false"
Habilita /debug (sobrescrituras solo en tiempo de ejecución).
commands.restart
boolean
predeterminado:"true"
Habilita /restart más acciones de herramienta de reinicio del Gateway.
commands.ownerAllowFrom
string[]
Establece la lista de permitidos explícita del propietario para superficies de comandos/herramientas solo para el propietario. Esta es la cuenta del operador humano que puede aprobar acciones peligrosas y ejecutar comandos como /diagnostics, /export-trajectory y /config. Es independiente de commands.allowFrom y del acceso por emparejamiento de DM.
channels.<channel>.commands.enforceOwnerForCommands
boolean
predeterminado:"false"
Por canal: hace que los comandos solo para el propietario requieran identidad del propietario para ejecutarse en esa superficie. Cuando es true, el remitente debe coincidir con un candidato de propietario resuelto (por ejemplo, una entrada en commands.ownerAllowFrom o metadatos de propietario nativos del proveedor) o tener el alcance interno operator.admin en un canal de mensajes interno. Una entrada comodín en allowFrom del canal, o una lista de candidatos de propietario vacía/no resuelta, no es suficiente: los comandos solo para el propietario fallan de forma cerrada en ese canal. Deja esto desactivado si quieres que los comandos solo para el propietario estén protegidos solo por ownerAllowFrom y las listas de permitidos estándar de comandos.
commands.ownerDisplay
"raw" | "hash"
Controla cómo aparecen los id de propietario en el prompt del sistema.
commands.ownerDisplaySecret
string
Opcionalmente establece el secreto HMAC usado cuando commands.ownerDisplay="hash".
commands.allowFrom
object
Lista de permitidos por proveedor para autorización de comandos. Cuando está configurada, es la única fuente de autorización para comandos y directivas (las listas de permitidos/emparejamiento del canal y commands.useAccessGroups se ignoran). Usa "*" para un valor predeterminado global; las claves específicas de proveedor lo sobrescriben.
commands.useAccessGroups
boolean
predeterminado:"true"
Aplica listas de permitidos/políticas para comandos cuando commands.allowFrom no está configurado.

Lista de comandos

Fuente de verdad actual:
  • los integrados del núcleo provienen de src/auto-reply/commands-registry.shared.ts
  • los comandos de dock generados provienen de src/auto-reply/commands-registry.data.ts
  • los comandos de Plugin provienen de llamadas registerCommand() de Plugin
  • la disponibilidad real en tu gateway sigue dependiendo de flags de configuración, la superficie del canal y los plugins instalados/habilitados

Comandos integrados del núcleo

  • /new [model] inicia una nueva sesión; /reset es el alias de restablecimiento.
  • La UI de control intercepta /new escrito para crear y cambiar a una sesión de panel nueva, excepto cuando session.dmScope: "main" está configurado y el padre actual es la sesión principal del agente; en ese caso, /new restablece la sesión principal en su lugar. /reset escrito sigue ejecutando el restablecimiento in situ del Gateway.
  • /reset soft [message] conserva la transcripción actual, descarta los id de sesión reutilizados del backend CLI y vuelve a ejecutar la carga de inicio/prompt del sistema in situ.
  • /compact [instructions] compacta el contexto de la sesión. Consulta Compaction.
  • /stop aborta la ejecución actual.
  • /session idle <duration|off> y /session max-age <duration|off> gestionan la caducidad de la vinculación de hilos.
  • /export-session [path] exporta la sesión actual a HTML. Alias: /export.
  • /export-trajectory [path] solicita aprobación de exec y luego exporta un paquete de trayectoria JSONL para la sesión actual. Úsalo cuando necesites la cronología del prompt, herramientas y transcripción de una sesión de OpenClaw. En chats de grupo, el prompt de aprobación y el resultado de exportación se envían al propietario en privado. Alias: /trajectory.
  • /think <level|default> establece el nivel de pensamiento o borra la sobrescritura de sesión. Las opciones provienen del perfil de proveedor del modelo activo; los niveles comunes son off, minimal, low, medium y high, con niveles personalizados como xhigh, adaptive, max o el binario on solo donde se admiten. Alias: /thinking, /t.
  • /verbose on|off|full alterna la salida detallada. Alias: /v.
  • /trace on|off alterna la salida de traza de Plugin para la sesión actual.
  • /fast [status|on|off|default] muestra, establece o borra el modo rápido.
  • /reasoning [on|off|stream] alterna la visibilidad del razonamiento. Alias: /reason.
  • /elevated [on|off|ask|full] alterna el modo elevado. Alias: /elev.
  • /exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> muestra o establece los valores predeterminados de exec.
  • /model [name|#|status] muestra o establece el modelo.
  • /models [provider] [page] [limit=<n>|size=<n>|all] enumera proveedores configurados/disponibles por autenticación o modelos de un proveedor; añade all para explorar el catálogo completo de ese proveedor. Las entradas provider/* en agents.defaults.models hacen que /model y /models muestren modelos descubiertos solo para esos proveedores.
  • /queue <mode> gestiona el comportamiento de cola (steer, queue heredado, followup, collect, steer-backlog, interrupt) más opciones como debounce:0.5s cap:25 drop:summarize; /queue default o /queue reset borra la sobrescritura de sesión. Consulta Cola de comandos y Cola de Steer.
  • /steer <message> inyecta orientación en la ejecución activa para la sesión actual, independientemente del modo /queue. No inicia una ejecución nueva cuando la sesión está inactiva. Alias: /tell. Consulta Steer.
  • /help muestra el resumen breve de ayuda.
  • /commands muestra el catálogo de comandos generado.
  • /tools [compact|verbose] muestra qué puede usar el agente actual ahora mismo.
  • /status muestra el estado de ejecución/tiempo de ejecución, el tiempo de actividad del Gateway y del sistema, más uso/cuota del proveedor cuando está disponible.
  • /diagnostics [note] es el flujo de informe de soporte solo para el propietario para errores del Gateway y ejecuciones del arnés Codex. Solicita aprobación explícita de exec cada vez antes de ejecutar openclaw gateway diagnostics export --json; no apruebes diagnósticos con una regla de permitir todo. Tras la aprobación, envía un informe que se puede pegar con la ruta del paquete local, resumen del manifiesto, notas de privacidad e id de sesión relevantes. En chats de grupo, el prompt de aprobación y el informe se envían al propietario en privado. Cuando la sesión activa usa el arnés OpenAI Codex, la misma aprobación también envía comentarios relevantes de Codex a los servidores de OpenAI y la respuesta completada enumera los id de sesión de OpenClaw, id de hilo de Codex y comandos codex resume <thread-id>. Consulta Exportación de diagnósticos.
  • /crestodian <request> ejecuta el asistente de configuración y reparación de Crestodian desde un DM del propietario.
  • /tasks enumera tareas en segundo plano activas/recientes para la sesión actual.
  • /context [list|detail|map|json] explica cómo se ensambla el contexto. map envía una imagen de mapa de árbol del contexto de la sesión actual.
  • /whoami muestra tu id de remitente. Alias: /id.
  • /usage off|tokens|full|cost controla el pie de página de uso por respuesta o imprime un resumen de coste local.
  • /skill <name> [input] ejecuta una skill por nombre.
  • /allowlist [list|add|remove] ... administra entradas de la lista de permitidos. Solo texto.
  • /approve <id> <decision> resuelve avisos de aprobación de exec.
  • /btw <question> hace una pregunta secundaria sin cambiar el contexto futuro de la sesión. Alias: /side. Consulta BTW.
  • /subagents list|kill|log|info|send|steer|spawn administra ejecuciones de subagentes para la sesión actual.
  • /acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help administra sesiones ACP y opciones de runtime.
  • /focus <target> vincula el hilo actual de Discord o el tema/conversación de Telegram con un destino de sesión.
  • /unfocus elimina el vínculo actual.
  • /agents lista los agentes vinculados al hilo para la sesión actual.
  • /kill <id|#|all> aborta uno o todos los subagentes en ejecución.
  • /subagents steer <id|#> <message> envía instrucciones a un subagente en ejecución. Consulta Steer.
  • /config show|get|set|unset lee o escribe openclaw.json. Solo propietarios. Requiere commands.config: true.
  • /mcp show|get|set|unset lee o escribe la configuración de servidores MCP administrados por OpenClaw bajo mcp.servers. Solo propietarios. Requiere commands.mcp: true.
  • /plugins list|inspect|show|get|install|enable|disable inspecciona o modifica el estado de los plugins. /plugin es un alias. Solo propietarios para escrituras. Requiere commands.plugins: true.
  • /debug show|set|unset|reset administra anulaciones de configuración solo de runtime. Solo propietarios. Requiere commands.debug: true.
  • /restart reinicia OpenClaw cuando está habilitado. Valor predeterminado: habilitado; establece commands.restart: false para deshabilitarlo.
  • /send on|off|inherit establece la política de envío. Solo propietarios.
  • /tts on|off|status|chat|latest|provider|limit|summary|audio|help controla TTS. Consulta TTS.
  • /activation mention|always establece el modo de activación de grupo.
  • /bash <command> ejecuta un comando de shell del host. Solo texto. Alias: ! <command>. Requiere commands.bash: true más listas de permitidos de tools.elevated.
  • !poll [sessionId] comprueba un trabajo de bash en segundo plano.
  • !stop [sessionId] detiene un trabajo de bash en segundo plano.

Comandos de acoplamiento generados

Los comandos de acoplamiento cambian la ruta de respuesta de la sesión actual a otro canal vinculado. Consulta Acoplamiento de canales para ver la configuración, ejemplos y solución de problemas. Los comandos de acoplamiento se generan a partir de plugins de canal con compatibilidad de comandos nativos. Conjunto incluido actual:
  • /dock-discord (alias: /dock_discord)
  • /dock-mattermost (alias: /dock_mattermost)
  • /dock-slack (alias: /dock_slack)
  • /dock-telegram (alias: /dock_telegram)
Usa comandos de acoplamiento desde un chat directo para cambiar la ruta de respuesta de la sesión actual a otro canal vinculado. El agente conserva el mismo contexto de sesión, pero las respuestas futuras para esa sesión se entregan al par de canal seleccionado. Los comandos de acoplamiento requieren session.identityLinks. El remitente de origen y el par de destino deben estar en el mismo grupo de identidades, por ejemplo ["telegram:123", "discord:456"]. Si un usuario de Telegram con id 123 envía /dock_discord, OpenClaw almacena lastChannel: "discord" y lastTo: "456" en la sesión activa. Si el remitente no está vinculado a un par de Discord, el comando responde con una sugerencia de configuración en lugar de pasar al chat normal. El acoplamiento cambia solo la ruta de la sesión activa. No crea cuentas de canal, concede acceso, omite listas de permitidos de canales ni mueve el historial de transcripción a otra sesión. Usa /dock-telegram, /dock-slack, /dock-mattermost u otro comando de acoplamiento generado para volver a cambiar la ruta.

Comandos de plugins incluidos

Los plugins incluidos pueden agregar más comandos de barra. Comandos incluidos actuales en este repositorio:
  • /dreaming [on|off|status|help] activa o desactiva Dreaming de memoria. Consulta Dreaming.
  • /pair [qr|status|pending|approve|cleanup|notify] administra el flujo de emparejamiento/configuración de dispositivos. Consulta Emparejamiento.
  • /phone status|arm <camera|screen|writes|all> [duration]|disarm arma temporalmente comandos de nodo telefónico de alto riesgo.
  • /voice status|list [limit]|set <voiceId|name> administra la configuración de voz de Talk. En Discord, el nombre del comando nativo es /talkvoice.
  • /card ... envía preajustes de tarjetas enriquecidas de LINE. Consulta LINE.
  • /codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills inspecciona y controla el arnés de servidor de aplicación Codex incluido. Consulta Arnés de Codex.
  • Comandos exclusivos de QQBot:
    • /bot-ping
    • /bot-version
    • /bot-help
    • /bot-upgrade
    • /bot-logs

Comandos dinámicos de Skills

Las Skills invocables por el usuario también se exponen como comandos de barra:
  • /skill <name> [input] siempre funciona como punto de entrada genérico.
  • Las skills también pueden aparecer como comandos directos, como /prose, cuando la skill o el plugin los registra.
  • El registro nativo de comandos de skills se controla mediante commands.nativeSkills y channels.<provider>.commands.nativeSkills.
  • Las especificaciones de comandos pueden proporcionar descriptionLocalizations para superficies nativas que admiten descripciones localizadas, incluido Discord.
  • Los comandos aceptan un : opcional entre el comando y los argumentos (por ejemplo, /think: high, /send: on, /help:).
  • /new <model> acepta un alias de modelo, provider/model o un nombre de proveedor (coincidencia aproximada); si no hay coincidencia, el texto se trata como el cuerpo del mensaje.
  • Para un desglose completo del uso por proveedor, usa openclaw status --usage.
  • /allowlist add|remove requiere commands.config=true y respeta configWrites del canal.
  • En canales con varias cuentas, /allowlist --account <id> dirigido a configuración y /config set channels.<provider>.accounts.<id>... también respetan configWrites de la cuenta de destino.
  • /usage controla el pie de uso por respuesta; /usage cost imprime un resumen de costo local a partir de los registros de sesión de OpenClaw.
  • /restart está habilitado de forma predeterminada; establece commands.restart: false para deshabilitarlo.
  • /plugins install <spec> acepta las mismas especificaciones de plugin que openclaw plugins install: ruta/archivo local, paquete npm, git:<repo> o clawhub:<pkg>, y luego solicita un reinicio del Gateway porque cambiaron los módulos de origen del plugin.
  • /plugins enable|disable actualiza la configuración del plugin y activa la recarga de plugins del Gateway para nuevos turnos del agente.
  • Comando nativo solo de Discord: /vc join|leave|status controla canales de voz (no disponible como texto). join requiere un servidor y un canal de voz/escenario seleccionado. Requiere channels.discord.voice y comandos nativos.
  • Los comandos de vinculación de hilos de Discord (/focus, /unfocus, /agents, /session idle, /session max-age) requieren que las vinculaciones efectivas de hilos estén habilitadas (session.threadBindings.enabled y/o channels.discord.threadBindings.enabled).
  • Referencia de comandos ACP y comportamiento de runtime: Agentes ACP.
  • /verbose está pensado para depuración y visibilidad adicional; mantenlo desactivado en el uso normal.
  • /trace es más limitado que /verbose: solo revela líneas de trace/depuración propiedad del plugin y mantiene desactivado el ruido verbose normal de herramientas.
  • /fast on|off persiste una anulación de sesión. Usa la opción inherit de la interfaz de sesiones para borrarla y volver a los valores predeterminados de configuración.
  • /fast es específico del proveedor: OpenAI/OpenAI Codex lo asignan a service_tier=priority en endpoints nativos de Responses, mientras que las solicitudes públicas directas de Anthropic, incluido el tráfico autenticado con OAuth enviado a api.anthropic.com, lo asignan a service_tier=auto o standard_only. Consulta OpenAI y Anthropic.
  • Los resúmenes de fallos de herramientas se siguen mostrando cuando son relevantes, pero el texto detallado del fallo solo se incluye cuando /verbose está on o full.
  • /reasoning, /verbose y /trace son riesgosos en entornos de grupo: pueden revelar razonamiento interno, salida de herramientas o diagnósticos de plugins que no pretendías exponer. Prefiere dejarlos desactivados, especialmente en chats grupales.
  • /model persiste el nuevo modelo de sesión inmediatamente.
  • Si el agente está inactivo, la siguiente ejecución lo usa de inmediato.
  • Si una ejecución ya está activa, OpenClaw marca un cambio en vivo como pendiente y solo reinicia con el nuevo modelo en un punto de reintento limpio.
  • Si la actividad de herramientas o la salida de respuesta ya empezó, el cambio pendiente puede permanecer en cola hasta una oportunidad de reintento posterior o el siguiente turno del usuario.
  • En la TUI local, /crestodian [request] vuelve desde la TUI normal del agente a Crestodian. Esto está separado del modo de rescate de canales de mensajes y no concede autoridad remota de configuración.
  • Ruta rápida: los mensajes que solo contienen comandos de remitentes en la lista de permitidos se gestionan de inmediato (omiten cola + modelo).
  • Control de menciones en grupos: los mensajes que solo contienen comandos de remitentes en la lista de permitidos omiten los requisitos de mención.
  • Atajos inline (solo remitentes en la lista de permitidos): ciertos comandos también funcionan cuando están incrustados en un mensaje normal y se eliminan antes de que el modelo vea el texto restante.
    • Ejemplo: hey /status activa una respuesta de estado y el texto restante continúa por el flujo normal.
  • Actualmente: /help, /commands, /status, /whoami (/id).
  • Los mensajes no autorizados que solo contienen comandos se ignoran silenciosamente, y los tokens inline /... se tratan como texto sin formato.
  • Comandos de Skills: las skills user-invocable se exponen como comandos de barra. Los nombres se saneen a a-z0-9_ (máx. 32 caracteres); las colisiones reciben sufijos numéricos (por ejemplo, _2).
    • /skill <name> [input] ejecuta una skill por nombre (útil cuando los límites de comandos nativos impiden comandos por skill).
    • De forma predeterminada, los comandos de skills se reenvían al modelo como una solicitud normal.
    • Las Skills pueden declarar opcionalmente command-dispatch: tool para enrutar el comando directamente a una herramienta (determinista, sin modelo).
    • Ejemplo: /prose (plugin OpenProse); consulta OpenProse.
  • Argumentos de comandos nativos: Discord usa autocompletado para opciones dinámicas (y menús de botones cuando omites argumentos obligatorios). Telegram y Slack muestran un menú de botones cuando un comando admite opciones y omites el argumento. Las opciones dinámicas se resuelven con el modelo de sesión de destino, por lo que las opciones específicas del modelo, como los niveles de /think, siguen la anulación de /model de esa sesión.

/tools

/tools responde a una pregunta de runtime, no a una pregunta de configuración: qué puede usar este agente ahora mismo en esta conversación.
  • /tools predeterminado es compacto y está optimizado para una revisión rápida.
  • /tools verbose agrega descripciones breves.
  • Las superficies de comandos nativos que admiten argumentos exponen el mismo cambio de modo que compact|verbose.
  • Los resultados tienen alcance de sesión, por lo que cambiar el agente, el canal, el hilo, la autorización del remitente o el modelo puede cambiar la salida.
  • /tools incluye herramientas que realmente son accesibles en runtime, incluidas herramientas del núcleo, herramientas de plugins conectados y herramientas propiedad del canal.
Para editar perfiles y anulaciones, usa el panel Tools de la interfaz de Control o las superficies de configuración/catálogo en lugar de tratar /tools como un catálogo estático.

Superficies de uso (qué se muestra dónde)

  • Uso/cuota del proveedor (ejemplo: “Claude 80% restante”) aparece en /status para el proveedor de modelo actual cuando el seguimiento de uso está habilitado. OpenClaw normaliza las ventanas del proveedor a % left; para MiniMax, los campos de porcentaje de solo restante se invierten antes de mostrarse, y las respuestas de model_remains prefieren la entrada del modelo de chat más una etiqueta de plan con etiqueta de modelo.
  • Las líneas de token/caché en /status pueden recurrir a la entrada de uso de transcripción más reciente cuando la instantánea de la sesión en vivo es escasa. Los valores en vivo distintos de cero existentes siguen teniendo prioridad, y la alternativa de transcripción también puede recuperar la etiqueta del modelo de runtime activo más un total más grande orientado al prompt cuando los totales almacenados faltan o son menores.
  • Ejecución frente a runtime: /status informa Execution para la ruta efectiva del sandbox y Runtime para quién está ejecutando realmente la sesión: OpenClaw Pi Default, OpenAI Codex, un backend CLI o un backend ACP.
  • Los tokens/coste por respuesta se controlan con /usage off|tokens|full (añadido a las respuestas normales).
  • /model status trata sobre modelos/autenticación/endpoints, no sobre uso.

Selección de modelo (/model)

/model se implementa como una directiva. Ejemplos:
/model
/model list
/model 3
/model openai/gpt-5.4
/model opus@anthropic:default
/model status
Notas:
  • /model y /model list muestran un selector compacto y numerado (familia de modelo + proveedores disponibles).
  • En Discord, /model y /models abren un selector interactivo con menús desplegables de proveedor y modelo, además de un paso de envío. El selector respeta agents.defaults.models, incluidas las entradas provider/*, por lo que el descubrimiento con alcance de proveedor puede mantener el selector por debajo del límite de 25 opciones de componentes de Discord.
  • /model <#> selecciona desde ese selector (y prefiere el proveedor actual cuando es posible).
  • /model status muestra la vista detallada, incluido el endpoint de proveedor configurado (baseUrl) y el modo de API (api) cuando están disponibles.

Anulaciones de depuración

/debug te permite establecer anulaciones de configuración solo en runtime (memoria, no disco). Solo propietario. Deshabilitado de forma predeterminada; habilítalo con commands.debug: true. Ejemplos:
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
/debug unset messages.responsePrefix
/debug reset
Las anulaciones se aplican inmediatamente a las nuevas lecturas de configuración, pero no se escriben en openclaw.json. Usa /debug reset para borrar todas las anulaciones y volver a la configuración en disco.

Salida de traza de Plugin

/trace te permite alternar líneas de traza/depuración de Plugin con alcance de sesión sin activar el modo detallado completo. Ejemplos:
/trace
/trace on
/trace off
Notas:
  • /trace sin argumento muestra el estado de traza de la sesión actual.
  • /trace on habilita las líneas de traza de Plugin para la sesión actual.
  • /trace off las vuelve a deshabilitar.
  • Las líneas de traza de Plugin pueden aparecer en /status y como un mensaje de diagnóstico posterior después de la respuesta normal del asistente.
  • /trace no reemplaza a /debug; /debug sigue administrando las anulaciones de configuración solo en runtime.
  • /trace no reemplaza a /verbose; la salida normal detallada de herramientas/estado sigue perteneciendo a /verbose.

Actualizaciones de configuración

/config escribe en tu configuración en disco (openclaw.json). Solo propietario. Deshabilitado de forma predeterminada; habilítalo con commands.config: true. Ejemplos:
/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"
/config unset messages.responsePrefix
La configuración se valida antes de escribir; los cambios no válidos se rechazan. Las actualizaciones de /config persisten entre reinicios.

Actualizaciones de MCP

/mcp escribe definiciones de servidores MCP administradas por OpenClaw bajo mcp.servers. Solo propietario. Deshabilitado de forma predeterminada; habilítalo con commands.mcp: true. Ejemplos:
/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7
/mcp almacena la configuración en la configuración de OpenClaw, no en ajustes de proyecto propiedad de Pi. Los adaptadores de runtime deciden qué transportes son realmente ejecutables.

Actualizaciones de Plugin

/plugins permite a los operadores inspeccionar los plugins descubiertos y alternar su habilitación en la configuración. Los flujos de solo lectura pueden usar /plugin como alias. Deshabilitado de forma predeterminada; habilítalo con commands.plugins: true. Ejemplos:
/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
  • /plugins list y /plugins show usan descubrimiento real de plugins sobre el espacio de trabajo actual más la configuración en disco.
  • /plugins install instala desde ClawHub, npm, git, directorios locales y archivos.
  • /plugins enable|disable actualiza solo la configuración de plugins; no instala ni desinstala plugins.
  • Los cambios de habilitación y deshabilitación recargan en caliente las superficies de runtime de Plugin del Gateway para nuevos turnos de agente; la instalación solicita un reinicio del Gateway porque los módulos de origen del Plugin cambiaron.

Notas de superficie

  • Los comandos de texto se ejecutan en la sesión de chat normal (los DM comparten main, los grupos tienen su propia sesión).
  • Los comandos nativos usan sesiones aisladas:
    • Discord: agent:<agentId>:discord:slash:<userId>
    • Slack: agent:<agentId>:slack:slash:<userId> (prefijo configurable mediante channels.slack.slashCommand.sessionPrefix)
    • Telegram: telegram:slash:<userId> (apunta a la sesión de chat mediante CommandTargetSessionKey)
  • /stop apunta a la sesión de chat activa para que pueda abortar la ejecución actual.
channels.slack.slashCommand sigue siendo compatible con un único comando de estilo /openclaw. Si habilitas commands.native, debes crear un comando slash de Slack por cada comando integrado (los mismos nombres que /help). Los menús de argumentos de comando para Slack se entregan como botones efímeros de Block Kit.Excepción nativa de Slack: registra /agentstatus (no /status) porque Slack reserva /status. El texto /status sigue funcionando en los mensajes de Slack.

Preguntas secundarias BTW

/btw es una pregunta secundaria rápida sobre la sesión actual. /side es un alias. A diferencia del chat normal:
  • usa la sesión actual como contexto de fondo,
  • en sesiones del arnés Codex, se ejecuta como un hilo secundario efímero de Codex con los permisos actuales de Codex y la superficie de herramientas nativa,
  • en sesiones que no son Codex, mantiene el comportamiento anterior de llamada secundaria directa de una sola vez,
  • no cambia el contexto futuro de la sesión,
  • no se escribe en el historial de transcripción,
  • se entrega como un resultado secundario en vivo en lugar de un mensaje normal del asistente.
Eso hace que /btw sea útil cuando quieres una aclaración temporal mientras la tarea principal sigue avanzando. Ejemplo:
/btw what are we doing right now?
/side what changed while the main run continued?
Consulta Preguntas secundarias BTW para ver el comportamiento completo y los detalles de UX del cliente.

Relacionado