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

Skills

Comandos de 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 ACP. Los comandos de gestión del Gateway permanecen locales: /acp ... siempre llega al controlador de comandos de OpenClaw, y /status junto con /unfocus permanecen locales siempre que la gestión de comandos esté habilitada para la superficie.

Tres tipos de comandos

Comandos

Mensajes independientes /... gestionados por el Gateway. Deben enviarse como ú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; actúan como indicaciones en línea cuando se envían con otro texto.
Atajos en línea

/help, /commands, /status, /whoami: se ejecutan de inmediato 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 contienen solo directivas (el mensaje consta únicamente de directivas), estas se conservan en la sesión y responden con una confirmación.
  • En los mensajes de chat normal que contienen otro texto, actúan 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 establece commands.allowFrom, será la única lista de permitidos utilizada; de lo contrario, la autorización procede de las listas de permitidos del canal, el emparejamiento y la aplicación permanente de los grupos de acceso. 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. Automático: activado para Discord/Telegram; desactivado para Slack; se ignora para los proveedores sin compatibilidad nativa. Se puede sobrescribir por canal con channels.<provider>.commands.native. En Discord, false omite el registro de comandos con barra diagonal; los comandos registrados anteriormente pueden seguir visibles hasta que se eliminen.

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

Registra de forma nativa los comandos de Skills cuando se admite. Automático: activado para Discord/Telegram; desactivado para Slack. Se puede sobrescribir con channels.<provider>.commands.nativeSkills.

commands.bashbooleandefault: false

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

commands.bashForegroundMsnumberdefault: 2000

Tiempo que bash espera antes de pasar al modo en segundo plano (0 pasa inmediatamente a segundo plano).

commands.configbooleandefault: false

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

commands.mcpbooleandefault: false

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

commands.pluginsbooleandefault: false

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

commands.debugbooleandefault: false

Habilita /debug (sobrescrituras de configuración exclusivas del entorno de ejecución). Solo para el propietario.

commands.restartbooleandefault: true

Habilita /restart y las solicitudes externas de reinicio SIGUSR1.

commands.ownerAllowFromstring[]

Lista explícita de permitidos del propietario 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: requiere la identidad del propietario para los comandos exclusivos del propietario. Cuando true, el remitente debe coincidir con commands.ownerAllowFrom o tener el ámbito interno operator.admin. Una entrada comodín allowFrom no es suficiente.

commands.ownerDisplay"raw" | "hash"

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

commands.ownerDisplaySecretstring

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

commands.allowFromobject

Lista de permitidos por proveedor para autorizar comandos. Cuando está configurada, es la única fuente de autorización para comandos y directivas. Use "*" como valor predeterminado global; las claves específicas del proveedor lo sobrescriben.

Lista de comandos

Los comandos proceden de tres fuentes:

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

La disponibilidad depende de las opciones de configuración, la superficie 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 sustituirla. 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. Omita el título para ver el nombre actual y una sugerencia
/compact [instructions] Compacta el contexto de la sesión. Consulte Compaction
/stop Interrumpe la ejecución actual
/session idle <duration|off> Gestiona la caducidad por inactividad de la vinculación del hilo
/session max-age <duration|off> Gestiona la caducidad por antigüedad máxima de la vinculación del hilo
/export-session [path] Solo para el propietario. Exporta la sesión actual a HTML dentro del espacio de trabajo. Alias: /export
/export-trajectory [path] Exporta un paquete de trayectoria JSONL para la sesión actual. Alias: /trajectory

Las rutas explícitas /export-session sustituyen los archivos existentes dentro del espacio de trabajo. Omita la ruta para generar un nombre de archivo que evite colisiones.

Controles del modelo y de la ejecución
Comando Descripción
/think <level|default> Establece el nivel de razonamiento o borra la sobrescritura 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 de plugins 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. Consulte Cola y Dirección de la cola
/steer <message> Introduce instrucciones en la ejecución activa. Alias: /tell. Consulte Dirigir
Seguridad de los modos detallado, seguimiento, rápido y razonamiento
  • /verbose sirve para depuración; manténgalo desactivado durante el uso normal.
  • /trace muestra únicamente las líneas de seguimiento/depuración propiedad de los plugins; la salida detallada normal permanece desactivada.
  • /fast auto|on|off conserva una sobrescritura de la sesión; use la opción inherit de la interfaz de sesiones 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 son arriesgados en entornos grupales: pueden revelar razonamientos internos o diagnósticos de plugins. Manténgalos desactivados en los chats grupales.
Detalles del cambio de modelo
  • /model conserva inmediatamente el nuevo modelo en la sesión.
  • Si el agente está inactivo, la siguiente ejecución lo utiliza de inmediato.
  • Si hay una ejecución activa, el cambio se marca como pendiente y se aplica en el siguiente punto de reintento limpio.
Detección y estado
Comando Descripción
/help Muestra el resumen breve de la ayuda
/commands Muestra el catálogo de comandos generado
/tools [compact|verbose] Muestra lo que el agente actual puede utilizar en este momento
/status Muestra el estado de ejecución y del entorno de ejecución, el tiempo de actividad del Gateway y del sistema, el estado de los plugins, además del uso y la cuota del proveedor
/status plugins Muestra información detallada sobre el estado de los plugins: errores de carga, cuarentenas, fallos de plugins de canales, 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 informe de soporte exclusivo del propietario. Solicita la aprobación de ejecución cada vez
/openclaw <request> Ejecuta el asistente de configuración y reparación de OpenClaw 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 su identificador de remitente. Alias: /id
/usage off|tokens|full|reset|cost Controla el pie de uso por respuesta (reset/inherit/clear/default borra la sobrescritura de la sesión para volver a heredar el valor predeterminado configurado) o muestra un resumen local de costes
Skills, listas de permitidos, aprobaciones
Comando Descripción
/skill <name> [input] Ejecutar una skill por nombre
/learn [request] Redactar una skill revisable a partir de la conversación actual o de fuentes indicadas mediante Taller de skills
/allowlist [list|add|remove] ... Gestionar entradas de la lista de permitidos. Solo texto
/approve <id> <decision> Resolver solicitudes de aprobación de ejecución o de plugins
/btw <question> Hacer una pregunta secundaria sin cambiar el contexto de la sesión. Alias: /side. Consulte BTW
Subagentes y ACP
Comando Descripción
/subagents list|log|info Inspeccionar 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 Gestionar sesiones ACP y opciones de tiempo de ejecución. Los controles de tiempo de ejecución requieren la identidad de un propietario externo o de un administrador interno del Gateway
/focus <target> Vincular el hilo actual de Discord o el tema de Telegram a un destino de sesión
/unfocus Eliminar la vinculación del hilo actual
/agents Enumerar los agentes vinculados a hilos de la sesión actual
Escrituras y administración exclusivas del propietario
Comando Requiere Descripción
/config show|get|set|unset commands.config: true Leer o escribir openclaw.json. Solo para el propietario
/mcp show|get|set|unset commands.mcp: true Leer o escribir la configuración de servidores MCP gestionada por OpenClaw. Solo para el propietario
/plugins list|inspect|show|get|install|enable|disable commands.plugins: true Inspeccionar o modificar el estado de los plugins. Las escrituras son exclusivas del propietario. Alias: /plugin
/debug show|set|unset|reset commands.debug: true Sustituciones de configuración solo en tiempo de ejecución. Solo para el propietario
/restart commands.restart: true (predeterminado) Reiniciar OpenClaw
/send on|off|inherit propietario Establecer 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 Controlar TTS. Consulte TTS
/activation mention|always Establecer el modo de activación de grupos
/bash <command> Ejecutar un comando del shell del host. Alias: ! <command>. Requiere commands.bash: true
!poll [sessionId] Comprobar una tarea de bash en segundo plano
!stop [sessionId] Detener 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. Consulte Acoplamiento de canales para obtener información sobre la configuración y la resolución de problemas.

Generados a partir de plugins de canales 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 identidad.

Comandos de plugins incluidos

Comando Descripción
/dreaming [on|off|status|help] Activar o desactivar Dreaming de la memoria (propietario o administrador del Gateway). Consulte Dreaming
/pair [qr|status|pending|approve|cleanup|notify] Gestionar el emparejamiento de dispositivos. Consulte Emparejamiento
/phone status|arm ...|disarm Habilitar temporalmente comandos de Node de alto riesgo (cámara/pantalla/equipo/escrituras). Consulte Uso del equipo
/voice status|list|set <voiceId> Gestionar la configuración de voz de Talk. Nombre nativo en Discord: /talkvoice
/card ... Enviar preajustes de tarjetas enriquecidas de LINE. Consulte LINE
/codex <action> ... Vincular, dirigir e inspeccionar 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). Consulte Entorno de Codex

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

Comandos de skills

Las skills que el usuario puede invocar se exponen como comandos con barra:

  • /skill <name> [input] siempre funciona como punto de entrada genérico.
  • Las skills pueden registrarse como comandos directos (p. ej., /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) — consulte OpenProse.

Argumentos de comandos nativos

Discord usa la función de autocompletar para las opciones dinámicas y menús de botones cuando se omiten 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 sustitución /model de la sesión.

/tools: lo que el agente puede usar ahora

/tools responde a una pregunta sobre el tiempo de 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 sustituciones, use el panel Tools de Control UI o las superficies de configuración.

/model: selección de modelos

text
/model             # mostrar el selector de modelos/model list        # lo mismo/model 3           # seleccionar por número en el selector/model openai/gpt-5.4/model opus@anthropic:default/model default     # borrar 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 proveedor y modelo. El selector respeta agents.defaults.modelPolicy.allow, incluidas las entradas provider/*. Sin una lista de permitidos explícita, las entradas y los alias de modelos no restringen la selección.

/config: escrituras de configuración en disco

text
/config show/config show channels.whatsapp.responsePrefix/config get channels.whatsapp.responsePrefix/config set channels.whatsapp.responsePrefix="[openclaw]"/config unset channels.whatsapp.responsePrefix

La configuración se valida antes de escribirla. Los cambios no válidos se rechazan. Las actualizaciones de /config persisten entre reinicios.

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

/debug: sustituciones solo en tiempo de ejecución

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

/plugins: gestión de plugins

text
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install clawhub:<package>/plugins install npm:@openclaw/<official-package>/plugins install npm:<package> --force/plugins install git:<repository>@<ref> --force

/plugins enable|disable actualiza la configuración de los plugins y recarga en caliente el tiempo de ejecución de plugins del Gateway para los nuevos turnos del agente. /plugins install reinicia automáticamente los Gateways gestionados porque han cambiado los módulos de código fuente de los plugins. Las instalaciones de confianza de ClawHub y del catálogo oficial no necesitan confirmación adicional. Las fuentes arbitrarias de npm, git, archivos, npm-pack: y rutas locales muestran una advertencia de procedencia y requieren un --force al final después de revisar el código fuente. Este indicador confirma el código fuente y permite sustituir una instalación existente; no omite security.installPolicy ni las comprobaciones de seguridad del instalador. Las versiones de ClawHub con advertencias de riesgo siguen requiriendo el indicador independiente y exclusivo del shell --acknowledge-clawhub-risk. Las instalaciones del marketplace, vinculadas y fijadas también siguen siendo exclusivas del shell.

/trace: salida de rastreo de plugins

text
/trace          # mostrar el estado de rastreo actual/trace on/trace off

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

/btw: preguntas secundarias

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

text
/btw ¿qué estamos haciendo ahora mismo?/side ¿qué cambió mientras continuaba la ejecución principal?

A diferencia de un mensaje normal:

  • Usa 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 transcripciones.

Consulte Preguntas secundarias de BTW para conocer el comportamiento completo.

Notas sobre las superficies

Ámbito de la sesión por superficie
  • Comandos de texto: se ejecutan en la sesión normal de chat (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> (se dirigen a la sesión de chat mediante CommandTargetSessionKey)
  • /login codex envía códigos de emparejamiento de dispositivos únicamente mediante chats privados o rutas de respuesta de la interfaz web. Las invocaciones desde grupos o temas de Telegram piden al propietario que envíe un mensaje directo al bot.
  • /stop se dirige a la sesión de chat activa para cancelar la ejecución actual.
Detalles específicos de Slack

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

Vía rápida y atajos en línea
  • Los mensajes que solo contienen comandos y proceden de remitentes incluidos en la lista de permitidos se gestionan de inmediato (omiten la cola y el modelo).
  • Los atajos en línea (/help, /commands, /status, /whoami) también funcionan integrados en mensajes normales y se eliminan antes de que el modelo vea el texto restante.
  • Los mensajes no autorizados que solo contienen comandos se ignoran silenciosamente; los tokens /... 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 coincidencias, el texto se trata como el cuerpo del mensaje.
  • /allowlist add|remove requiere commands.config: true y respeta la opción configWrites del canal.

Uso y estado del proveedor

  • El uso o la cuota del proveedor (p. ej., «Claude: 80 % restante») se muestra en /status para el proveedor del modelo actual cuando el seguimiento del uso está activado.
  • Las líneas de tokens y 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 en vivo 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 y coste por respuesta: se controlan 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

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

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

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

On this page