OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

Comandos con barra diagonal

El Gateway gestiona los comandos enviados como mensajes independientes que comienzan por /. Los comandos bash exclusivos del host usan ! <cmd> (con /bash <cmd> como alias).

Cuando una conversación está vinculada a una sesión ACP, el texto normal se dirige al entorno de ejecución ACP. Los comandos de administración del Gateway permanecen locales: /acp ... siempre llega al controlador de comandos de OpenClaw, y /status junto con /unfocus permanecen locales siempre que el procesamiento de comandos esté habilitado para la superficie.

Tres tipos de comandos

Comandos

Mensajes /... independientes gestionados por el Gateway. Deben enviarse como el único contenido del mensaje.
Directivas

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue: se eliminan del mensaje antes de que el modelo lo vea. Conservan la configuración de la sesión cuando se envían solas; funcionan como indicaciones en línea cuando se envían con otro texto.
Atajos en línea

/help, /commands, /status, /whoami: se ejecutan inmediatamente y se eliminan antes de que el modelo vea el texto restante. Solo para remitentes autorizados.
Detalles del comportamiento de las directivas
  • Las directivas se eliminan del mensaje antes de que el modelo lo vea.
  • En los mensajes que solo contienen directivas (el mensaje contiene únicamente directivas), se conservan en la sesión y responden con una confirmación.
  • En los mensajes de chat normal con otro texto, funcionan como indicaciones en línea y no conservan la configuración de la sesión.
  • Las directivas solo se aplican a remitentes autorizados. Si se configura commands.allowFrom, esa será la única lista de permitidos utilizada; de lo contrario, la autorización proviene de las listas de permitidos o el emparejamiento del canal, junto con commands.useAccessGroups. Para los remitentes no autorizados, las directivas se tratan como texto sin formato.

Configuración

json5
{  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.textbooleandefault: true

Habilita el análisis de /... en los mensajes de chat. En las superficies sin comandos nativos (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), los comandos de texto funcionan incluso cuando se establece en false.

commands.nativeboolean | "auto"default: "auto"

Registra comandos nativos. En modo automático: se activa para Discord/Telegram; se desactiva para Slack; se ignora para los proveedores sin compatibilidad nativa. Se puede sobrescribir por canal mediante channels.<provider>.commands.native. En Discord, false omite el registro de comandos con barra diagonal; los comandos registrados anteriormente pueden permanecer visibles hasta que se eliminen.

commands.nativeSkillsboolean | "auto"default: "auto"

Registra comandos de Skills de forma nativa cuando se admite. En modo automático: se activa para Discord/Telegram y se desactiva para Slack. Se puede sobrescribir mediante channels.<provider>.commands.nativeSkills.

commands.bashbooleandefault: false

Habilita ! <cmd> para ejecutar comandos del shell del host (alias /bash <cmd>). Requiere listas de permitidos de tools.elevated.

commands.bashForegroundMsnumberdefault: 2000

Tiempo que bash espera antes de cambiar al modo en segundo plano (0 cambia inmediatamente al segundo plano).

commands.configbooleandefault: false

Habilita /config (lee y escribe openclaw.json). Solo para el propietario.

commands.mcpbooleandefault: false

Habilita /mcp (lee y escribe la configuración de MCP administrada por OpenClaw en mcp.servers). Solo para el propietario.

commands.pluginsbooleandefault: false

Habilita /plugins (detección y estado de plugins, además de instalación y activación o desactivación). Solo el propietario puede realizar escrituras.

commands.debugbooleandefault: false

Habilita /debug (sobrescrituras de configuración solo en tiempo de ejecución). Solo para el propietario.

commands.restartbooleandefault: true

Habilita /restart y las acciones de herramientas para reiniciar el Gateway.

commands.ownerAllowFromstring[]

Lista explícita de propietarios permitidos para las superficies de comandos exclusivas del propietario. Es independiente de commands.allowFrom y del acceso mediante emparejamiento de mensajes directos.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> Por canal: exige la identidad del propietario para los comandos exclusivos del propietario. Cuando es true, el remitente debe coincidir con commands.ownerAllowFrom o disponer del ámbito interno operator.admin. Una entrada comodín de allowFrom no es suficiente.

commands.ownerDisplay"raw" | "hash"

Controla cómo aparecen los identificadores de propietario en el prompt del sistema.

commands.ownerDisplaySecretstring

Secreto HMAC utilizado cuando commands.ownerDisplay: "hash".

commands.allowFromobject

Lista de permitidos por proveedor para la autorización de comandos. Cuando se configura, es la única fuente de autorización para comandos y directivas. Usa "*" como valor predeterminado global; las claves específicas de cada proveedor lo reemplazan.

commands.useAccessGroupsbooleandefault: true

Aplica listas de permitidos y políticas a los comandos cuando no se establece commands.allowFrom.

Lista de comandos

Los comandos provienen de tres fuentes:

  • Comandos integrados del núcleo: src/auto-reply/commands-registry.shared.ts
  • Comandos de acoplamiento generados: src/auto-reply/commands-registry.data.ts
  • Comandos de plugins: llamadas a registerCommand() del plugin

La disponibilidad depende de los indicadores de configuración, la interfaz del canal y los plugins instalados y habilitados.

Comandos del núcleo

Sesiones y ejecuciones
Comando Descripción
/new [model] Archiva la sesión actual e inicia una nueva
/reset [soft [message]] Restablece la sesión actual sin reemplazarla. soft conserva la transcripción, descarta los identificadores reutilizados de sesiones del backend de la CLI y vuelve a ejecutar el inicio
/name <title> Asigna o cambia el nombre de la sesión actual. Omite el título para ver el nombre actual y una sugerencia
/compact [instructions] Compacta el contexto de la sesión. Consulta Compaction
/stop Cancela la ejecución actual
/session idle <duration|off> Gestiona la caducidad por inactividad de la vinculación al hilo
/session max-age <duration|off> Gestiona la caducidad por antigüedad máxima de la vinculación al hilo
/export-session [path] Exporta la sesión actual a HTML. Alias: /export
/export-trajectory [path] Exporta un paquete de trayectoria JSONL para la sesión actual. Alias: /trajectory
Controles del modelo y de la ejecución
Comando Descripción
/think <level|default> Establece el nivel de razonamiento o borra la anulación de la sesión. Alias: /thinking, /t
/verbose on|off|full Activa o desactiva la salida detallada. Alias: /v
/trace on|off Activa o desactiva la salida de seguimiento del plugin para la sesión actual
/fast [status|auto|on|off|default] Muestra, establece o borra el modo rápido
/reasoning [on|off|stream] Activa o desactiva la visibilidad del razonamiento. Alias: /reason
/elevated [on|off|ask|full] Activa o desactiva 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 ejecución
/login [codex|openai|openai-codex] Vincula el inicio de sesión de Codex/OpenAI desde un chat privado o una sesión de la interfaz web. Solo para propietarios y administradores
/model [name|#|status] Muestra o establece el modelo
/models [provider] [page] [limit=<n>|all] Enumera los proveedores o modelos configurados o disponibles mediante autenticación
/queue <mode> Gestiona el comportamiento de la cola de ejecuciones activas. Consulta Cola y Dirección de la cola
/steer <message> Inyecta indicaciones en la ejecución activa. Alias: /tell. Consulta Dirigir
Seguridad de verbose / trace / fast / reasoning
  • /verbose sirve para la depuración; mantenlo desactivado durante el uso normal.
  • /trace solo revela las líneas de seguimiento y depuración propiedad del plugin; el resto de mensajes detallados permanece desactivado.
  • /fast auto|on|off conserva una anulación de la sesión; usa la opción inherit de la interfaz Sessions para borrarla.
  • /fast depende del proveedor: OpenAI/Codex lo asignan a service_tier=priority; las solicitudes directas a Anthropic lo asignan a service_tier=auto o standard_only.
  • /reasoning, /verbose y /trace presentan riesgos en entornos grupales: pueden revelar razonamientos internos o diagnósticos de plugins. Mantenlos desactivados en los chats grupales.
Detalles del cambio de modelo
  • /model guarda inmediatamente el nuevo modelo en la sesión.
  • Si el agente está inactivo, la siguiente ejecución lo usa de inmediato.
  • Si hay una ejecución activa, el cambio se marca como pendiente y se aplica en el siguiente punto de reintento seguro.
Descubrimiento y estado
Comando Descripción
/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 en este momento
/status Muestra el estado de ejecución y del entorno, el tiempo de actividad del Gateway y del sistema, el estado de los plugins y el uso y la cuota del proveedor
/status plugins Muestra el estado detallado de los plugins: errores de carga, cuarentenas, fallos de plugins de canal, problemas de dependencias y avisos de compatibilidad. Requiere commands.plugins: true
/goal [status|start|edit|pause|resume|complete|block|clear] ... Gestiona el objetivo persistente de la sesión actual
/diagnostics [note] Flujo de informes de soporte solo para propietarios. Solicita aprobación de ejecución cada vez
/crestodian <request> Ejecuta el asistente de configuración y reparación de Crestodian desde un mensaje directo del propietario
/tasks Enumera las tareas en segundo plano activas o recientes de la sesión actual
/context [list|detail|map|json] Explica cómo se compone el contexto
/whoami Muestra tu identificador de remitente. Alias: /id
/usage off|tokens|full|reset|cost Controla el pie de uso de cada respuesta (reset/inherit/clear/default borra la anulación de la sesión para volver a heredar el valor predeterminado configurado) o muestra un resumen local de costes
Skills, listas de permitidos y aprobaciones
Comando Descripción
/skill <name> [input] Ejecuta una Skill por nombre
/learn [request] Prepara el borrador de una Skill revisable a partir de la conversación actual o de fuentes indicadas mediante el Taller de Skills
/allowlist [list|add|remove] ... Gestiona las entradas de la lista de permitidos. Solo texto
/approve <id> <decision> Resuelve las solicitudes de aprobación de ejecución o de plugins
/btw <question> Formula una pregunta secundaria sin cambiar el contexto de la sesión. Alias: /side. Consulta Por cierto
Subagentes y ACP
Comando Descripción
/subagents list|log|info Inspecciona las ejecuciones de subagentes de la sesión actual
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help Gestiona las sesiones ACP y las opciones de ejecución. Los controles de ejecución requieren la identidad del propietario externo o de un administrador interno del Gateway
/focus <target> Vincula el hilo actual de Discord o el tema de Telegram a un destino de sesión
/unfocus Elimina la vinculación del hilo actual
/agents Enumera los agentes vinculados al hilo para la sesión actual
Escrituras y administración exclusivas del propietario
Comando Requiere Descripción
/config show|get|set|unset commands.config: true Lee o escribe openclaw.json. Solo para el propietario
/mcp show|get|set|unset commands.mcp: true Lee o escribe la configuración de servidores MCP gestionada por OpenClaw. Solo para el propietario
/plugins list|inspect|show|get|install|enable|disable commands.plugins: true Inspecciona o modifica el estado de los plugins. Las escrituras son solo para el propietario. Alias: /plugin
/debug show|set|unset|reset commands.debug: true Modificaciones de configuración solo durante la ejecución. Solo para el propietario
/restart commands.restart: true (predeterminado) Reinicia OpenClaw
/send on|off|inherit propietario Establece la política de envío
Voz, TTS y control de canales
Comando Descripción
/tts on|off|status|chat|latest|provider|limit|summary|audio|help Controla TTS. Consulta TTS
/activation mention|always Establece el modo de activación en grupos
/bash <command> Ejecuta un comando del shell del host. Alias: ! <command>. Requiere commands.bash: true
!poll [sessionId] Comprueba una tarea de bash en segundo plano
!stop [sessionId] Detiene una tarea de bash en segundo plano

Comandos de acoplamiento

Los comandos de acoplamiento cambian la ruta de respuesta de la sesión activa a otro canal vinculado. Consulta Acoplamiento de canales para obtener información sobre la configuración y la solución de problemas.

Generados a partir de plugins de canal compatibles con comandos nativos:

  • /dock-discord (alias: /dock_discord)
  • /dock-mattermost (alias: /dock_mattermost)
  • /dock-slack (alias: /dock_slack)
  • /dock-telegram (alias: /dock_telegram)

Los comandos de acoplamiento requieren session.identityLinks. El remitente de origen y el interlocutor de destino deben pertenecer al mismo grupo de identidades.

Comandos de plugins incluidos

Comando Descripción
/dreaming [on|off|status|help] Activa o desactiva el Dreaming de memoria (propietario o administrador del Gateway). Consulta Dreaming
/pair [qr|status|pending|approve|cleanup|notify] Gestiona el emparejamiento de dispositivos. Consulta Emparejamiento
/phone status|arm ...|disarm Habilita temporalmente comandos de Node de alto riesgo (cámara/pantalla/equipo/escrituras). Consulta Uso del equipo
/voice status|list|set <voiceId> Gestiona la configuración de voz de Talk. Nombre nativo en Discord: /talkvoice
/card ... Envía preajustes de tarjetas enriquecidas de LINE. Consulta LINE
/codex <action> ... Vincula, dirige e inspecciona el entorno del servidor de aplicaciones de Codex (estado, hilos, reanudación, modelo, modo rápido, permisos, compactación, revisión, MCP, Skills y más). Consulta Entorno de Codex

Solo para QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Comandos de Skills

Las Skills que puede invocar el usuario se exponen como comandos de barra:

  • /skill <name> [input] siempre funciona como punto de entrada genérico.
  • Las Skills pueden registrarse como comandos directos (por ejemplo, /prose para OpenProse).
  • El registro de comandos nativos de Skills se controla mediante commands.nativeSkills y channels.<provider>.commands.nativeSkills.
  • Los nombres se normalizan a a-z0-9_ (máximo de 32 caracteres); las colisiones reciben sufijos numéricos.
Enrutamiento de comandos de Skills

De forma predeterminada, los comandos de Skills se enrutan al modelo como una solicitud normal.

Las Skills pueden declarar command-dispatch: tool para enrutarse directamente a una herramienta (de forma determinista, sin intervención del modelo). Ejemplo: /prose (plugin OpenProse) — consulta OpenProse.

Argumentos de comandos nativos

Discord utiliza el autocompletado para las opciones dinámicas y menús de botones cuando se omiten los argumentos obligatorios. Telegram y Slack muestran un menú de botones para los comandos con opciones. Las opciones dinámicas se resuelven según el modelo de la sesión de destino, por lo que las opciones específicas del modelo, como los niveles de /think, respetan la modificación de /model de la sesión.

/tools: qué puede usar el agente ahora

/tools responde a una pregunta sobre la ejecución: qué puede usar este agente ahora mismo en esta conversación, no un catálogo estático de configuración.

text
/tools         # vista compacta/tools verbose # con descripciones breves

Los resultados se limitan a la sesión. Cambiar de agente, canal, hilo, autorización del remitente o modelo puede cambiar el resultado. Para editar perfiles y modificaciones, usa el panel Tools de la interfaz de control o las superficies de configuración.

/model: selección del modelo

text
/model             # muestra el selector de modelos/model list        # lo mismo/model 3           # selecciona por número en el selector/model openai/gpt-5.4/model opus@anthropic:default/model default     # borra la selección de modelo de la sesión/model status      # vista detallada con el endpoint y el modo de API

En Discord, /model y /models abren un selector interactivo con listas desplegables de proveedores y modelos. El selector respeta agents.defaults.models, incluidas las entradas provider/*.

/config: escrituras de configuración en disco

text
/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 escribirla. Los cambios no válidos se rechazan. Las actualizaciones de /config persisten después de los reinicios.

/mcp: configuración de servidores MCP

text
/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 los ajustes del proyecto del agente integrado. /mcp show oculta los campos que contienen credenciales, los valores de indicadores reconocidos de credenciales y los argumentos conocidos con forma de secreto. Cuando se ejecuta desde un grupo, la configuración se envía al propietario de forma privada; si no hay disponible una ruta privada hacia el propietario, el comando se cierra de forma segura y solicita al propietario que vuelva a intentarlo desde un chat directo.

/debug: modificaciones solo durante la ejecución

text
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset

/plugins: gestión de plugins

text
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin

/plugins enable|disable actualiza la configuración del plugin y recarga en caliente el entorno de plugins del Gateway para las nuevas interacciones del agente. /plugins install reinicia automáticamente los Gateways gestionados porque los módulos de código fuente del plugin han cambiado.

/trace: salida de seguimiento de plugins

text
/trace          # muestra el estado actual del seguimiento/trace on/trace off

/trace muestra las líneas de seguimiento y depuración de plugins limitadas a la sesión sin activar el modo detallado completo. No sustituye a /debug (modificaciones durante la ejecución) ni a /verbose (salida normal de las herramientas).

/btw: preguntas secundarias

/btw es una pregunta secundaria rápida sobre el contexto de la sesión actual. Alias: /side.

text
/btw what are we doing right now?/side what changed while the main run continued?

A diferencia de un mensaje normal:

  • Utiliza la sesión actual como contexto de fondo.
  • En las sesiones del entorno de Codex, se ejecuta como un hilo secundario efímero de Codex.
  • No cambia el contexto futuro de la sesión.
  • No se escribe en el historial de la transcripción.

Consulta Preguntas secundarias con BTW para conocer el comportamiento completo.

Notas sobre las superficies

Ámbito de sesión por superficie
  • Comandos de texto: se ejecutan en la sesión de chat normal (los mensajes directos comparten main; los grupos tienen su propia sesión).
  • Comandos nativos de Discord: agent:<agentId>:discord:slash:<userId>
  • Comandos nativos de Slack: agent:<agentId>:slack:slash:<userId> (prefijo configurable mediante channels.slack.slashCommand.sessionPrefix)
  • Comandos nativos de Telegram: telegram:slash:<userId> (apuntan a la sesión de chat mediante CommandTargetSessionKey)
  • /login codex envía códigos de emparejamiento del dispositivo únicamente a través de un chat privado o de las rutas de respuesta de la interfaz web. Las invocaciones desde grupos o temas de Telegram solicitan al propietario que envíe un mensaje directo al bot.
  • /stop apunta a la sesión de chat activa para cancelar la ejecución actual.
Aspectos específicos de Slack

channels.slack.slashCommand admite un único comando del tipo /openclaw. Con commands.native: true, crea un comando de barra de Slack por cada comando integrado. Registra /agentstatus (no /status) porque Slack reserva /status. El comando de texto /status sigue funcionando en los mensajes de Slack.

Ruta rápida y atajos en línea
  • Los mensajes que contienen únicamente comandos de remitentes incluidos en la lista de permitidos se procesan de inmediato (omiten la cola y el modelo).
  • Los atajos en línea (/help, /commands, /status, /whoami) también funcionan incrustados en mensajes normales y se eliminan antes de que el modelo vea el texto restante.
  • Los mensajes no autorizados que contienen únicamente comandos se ignoran silenciosamente; los elementos /... en línea se tratan como texto sin formato.
Notas sobre los argumentos
  • Los comandos aceptan un : opcional entre el comando y los argumentos (/think: high, /send: on).
  • /new <model> acepta un alias de modelo, provider/model o el nombre de un proveedor (coincidencia aproximada); si no hay coincidencia, el texto se trata como el cuerpo del mensaje.
  • /allowlist add|remove requiere commands.config: true y respeta configWrites del canal.

Uso y estado de proveedores

  • El uso/cuota del proveedor (p. ej., «Claude: 80 % restante») se muestra en /status para el proveedor del modelo actual cuando el seguimiento del uso está habilitado.
  • Las líneas de tokens/caché de /status pueden recurrir a la entrada de uso más reciente de la transcripción cuando la instantánea de la sesión activa contiene pocos datos.
  • Ejecución frente a entorno de ejecución: /status muestra Execution para la ruta efectiva del entorno aislado y Runtime para indicar quién ejecuta la sesión: OpenClaw Default, OpenAI Codex, un backend de CLI o un backend de ACP.
  • Tokens/coste por respuesta: se controla mediante /usage off|tokens|full.
  • /model status se refiere a modelos, autenticación y endpoints, no al uso.

Contenido relacionado

Skills

Cómo se registran y restringen los comandos de barra de Skills.
Creación de Skills

Crea una Skill que registre su propio comando de barra.
BTW

Preguntas secundarias sin cambiar el contexto de la sesión.
Orientar

Guía al agente durante la ejecución con /steer.
Was this useful?
On this page

On this page