English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Skills

Comandos de barra

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

Cuando una conversación está vinculada a una sesión ACP, el texto normal se enruta al arnés ACP. Los comandos de administración del Gateway siguen siendo locales: /acp ... siempre llega al manejador de comandos de OpenClaw, y /status más /unfocus permanecen locales siempre que el manejo 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. Persisten 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 remitentes autorizados.
Detalles del comportamiento de las directivas
  • Las directivas se eliminan del mensaje antes de que el modelo lo vea.
  • En mensajes solo de directivas (el mensaje contiene solo directivas), persisten en la sesión y responden con un acuse de recibo.
  • En mensajes de chat normal con otro texto, actúan como indicaciones en línea y no persisten la configuración de la sesión.
  • Las directivas solo se aplican a remitentes autorizados. Si commands.allowFrom está definido, es la única lista de permitidos que se usa; de lo contrario, la autorización proviene de listas de permitidos/emparejamiento del canal más commands.useAccessGroups. Los remitentes no autorizados ven las directivas tratadas 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 mensajes de chat. En superficies sin comandos nativos (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), los comandos de texto funcionan incluso cuando se define en false.

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

Registra comandos nativos. Automático: activado para Discord/Telegram; desactivado para Slack; se ignora para proveedores sin soporte nativo. Sobrescríbelo por canal con channels.<provider>.commands.native. En Discord, false omite el registro de comandos de barra diagonal; los comandos registrados previamente pueden seguir visibles hasta que se eliminen.

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

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

commands.bashbooleandefault: false

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

commands.bashForegroundMsnumberdefault: 2000

Cuánto tiempo espera bash antes de cambiar al modo en segundo plano (0 pasa a segundo plano de inmediato).

commands.configbooleandefault: false

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

commands.mcpbooleandefault: false

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

commands.pluginsbooleandefault: false

Habilita /plugins (descubrimiento/estado de plugins más instalación y activación/desactivación). Solo propietario para escrituras.

commands.debugbooleandefault: false

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

commands.restartbooleandefault: true

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

commands.ownerAllowFromstring[]

Lista explícita de permitidos del propietario para superficies de comandos solo del propietario. Separada de commands.allowFrom y del acceso por emparejamiento de MD.

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

commands.ownerDisplay"raw" | "hash"

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

commands.ownerDisplaySecretstring

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

commands.allowFromobject

Lista de permitidos por proveedor para 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 del proveedor lo sobrescriben.

commands.useAccessGroupsbooleandefault: true

Aplica listas de permitidos/políticas para comandos cuando commands.allowFrom no está definido.

Lista de comandos

Los comandos provienen de tres fuentes:

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

La disponibilidad depende de las marcas de configuración, la superficie del canal y los plugins instalados/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 en el mismo lugar. soft conserva la transcripción, descarta los id. de sesión de backend CLI reutilizados y vuelve a ejecutar el arranque
/name <title> Nombra o renombra 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 Anula la ejecución actual
/session idle <duration|off> Administra la expiración por inactividad de la vinculación de hilo
/session max-age <duration|off> Administra la expiración por edad máxima de la vinculación de 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 de modelo y ejecución
Comando Descripción
/think <level|default> Define el nivel de pensamiento o borra la sobrescritura de sesión. Alias: /thinking, /t
/verbose on|off|full Alterna la salida detallada. Alias: /v
/trace on|off Alterna la salida de traza del plugin para la sesión actual
/fast [status|auto|on|off|default] Muestra, define 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 define los valores predeterminados de exec
/login [codex|openai|openai-codex] Empareja el inicio de sesión de Codex/OpenAI desde un chat privado o una sesión de Web UI. Solo propietario/admin
/model [name|#|status] Muestra o define el modelo
/models [provider] [page] [limit=<n>|all] Lista proveedores o modelos configurados/con autenticación disponible
/queue <mode> Administra el comportamiento de la cola de ejecuciones activas. Consulta Cola y Dirección de cola
/steer <message> Inyecta orientación en la ejecución activa. Alias: /tell. Consulta Dirigir
seguridad de verbose / trace / fast / reasoning
  • /verbose es para depuración: mantenlo desactivado en el uso normal.
  • /trace revela solo líneas de traza/depuración propiedad del plugin; la charla detallada normal permanece desactivada.
  • /fast auto|on|off persiste una sobrescritura de sesión; usa la opción inherit de la IU Sesiones para borrarla.
  • /fast es específico 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 riesgosos en contextos de grupo: pueden revelar razonamiento interno o diagnósticos de plugins. Mantenlos desactivados en chats grupales.
Detalles del cambio de modelo
  • /model persiste el nuevo modelo inmediatamente en la sesión.
  • Si el agente está inactivo, la próxima 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 limpio.
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 lo que el agente actual puede usar ahora mismo
/status Muestra el estado de ejecución/tiempo de ejecución, el tiempo activo de Gateway y del sistema, el estado de plugins, además del uso/cuota del proveedor
/status plugins Muestra el estado detallado de plugins: errores de carga, cuarentenas, fallos de canal, problemas de dependencias, avisos de compatibilidad
/goal [status|start|pause|resume|complete|block|clear] ... Administra el objetivo durable de la sesión actual
/diagnostics [note] Flujo de informe de soporte solo del propietario. Pide aprobación de exec cada vez
/crestodian <request> Ejecuta el ayudante de configuración y reparación de Crestodian desde un MD del propietario
/tasks Lista las tareas en segundo plano activas/recientes de la sesión actual
/context [list|detail|map|json] Explica cómo se ensambla el contexto
/whoami Muestra tu id. 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 sesión para volver a heredar el valor predeterminado configurado) o imprime un resumen local de costes
Skills, listas de permitidos, aprobaciones
Comando Descripción
/skill <name> [input] Ejecuta una skill por nombre
/allowlist [list|add|remove] ... Administra entradas de lista de permitidos. Solo texto
/approve <id> <decision> Resuelve prompts de aprobación de exec o plugin
/btw <question> Haz una pregunta secundaria sin cambiar el contexto de la sesión. Alias: /side. Consulta BTW
Subagentes y ACP
Comando Descripción
/subagents list|log|info Inspecciona 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 Gestiona sesiones ACP y opciones de runtime. Los controles de runtime requieren propietario externo o identidad interna de administrador 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 Lista los agentes vinculados al hilo para la sesión actual
Escrituras solo para propietarios y administración
Comando Requiere Descripción
/config show|get|set|unset commands.config: true Lee o escribe openclaw.json. Solo para propietarios
/mcp show|get|set|unset commands.mcp: true Lee o escribe la configuración del servidor MCP gestionado por OpenClaw. Solo para propietarios
/plugins list|inspect|show|get|install|enable|disable commands.plugins: true Inspecciona o modifica el estado de Plugins. Solo para propietarios en escrituras. Alias: /plugin
/debug show|set|unset|reset commands.debug: true Sobrescrituras de configuración solo en runtime. Solo para propietarios
/restart commands.restart: true (predeterminado) Reinicia OpenClaw
/send on|off|inherit propietario Establece la política de envío
Voz, TTS, control de canal
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 de grupo
/bash <command> Ejecuta un comando de shell del host. Alias: ! <command>. Requiere commands.bash: true
!poll [sessionId] Comprueba un trabajo bash en segundo plano
!stop [sessionId] Detiene un trabajo bash en segundo plano

Comandos de Dock

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

Generado a partir de Plugins de canal con soporte para 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 Dock requieren session.identityLinks. El remitente de origen y el par de destino deben estar en el mismo grupo de identidad.

Comandos de Plugins incluidos

Comando Descripción
/dreaming [on|off|status|help] Activa o desactiva 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 Arma temporalmente comandos de nodo telefónico de alto riesgo
/voice status|list|set <voiceId> Gestiona la configuración de voz de Talk. Nombre nativo de Discord: /talkvoice
/card ... Envía preajustes de tarjetas enriquecidas de LINE. Consulta LINE
/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills Controla el arnés de servidor de aplicaciones Codex. Consulta Arnés de Codex

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

Comandos de Skills

Las Skills invocables por 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 nativo de comandos de Skills se controla mediante commands.nativeSkills y channels.<provider>.commands.nativeSkills.
  • Los nombres se saneen a a-z0-9_ (máximo 32 caracteres); las colisiones reciben sufijos numéricos.
Despacho 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 enrutar directamente a una herramienta (determinista, sin intervención del modelo). Ejemplo: /prose (Plugin OpenProse) — consulta OpenProse.

Argumentos de comandos nativos

Discord usa autocompletado para opciones dinámicas y menús de botones cuando se omiten argumentos requeridos. Telegram y Slack muestran un menú de botones para comandos con opciones. Las opciones dinámicas se resuelven respecto al modelo de sesión de destino, por lo que las opciones específicas del modelo, como niveles de /think, siguen la sobrescritura de /model de la sesión.

/tools — qué puede usar el agente ahora

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

text
/tools         # compact view/tools verbose # with short descriptions

Los resultados tienen alcance de sesión. Cambiar de agente, canal, hilo, autorización del remitente o modelo puede cambiar la salida. Para editar perfiles y sobrescrituras, usa el panel Tools de la Control UI o las superficies de configuración.

/model — selección de modelo

text
/model             # show model picker/model list        # same/model 3           # select by number from picker/model openai/gpt-5.4/model opus@anthropic:default/model default     # clear the session model selection/model status      # detailed view with endpoint and API mode

En Discord, /model y /models abren un selector interactivo con desplegables de proveedor y modelo. 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 escribir. 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 ajustes de proyecto de agente integrado.

/debug — sobrescrituras solo en runtime

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 de Plugins y recarga en caliente el runtime de Plugins del Gateway para nuevos turnos de agente. /plugins install reinicia automáticamente los Gateways gestionados porque cambiaron los módulos fuente de Plugins.

/trace — salida de traza de Plugins

text
/trace          # show current trace state/trace on/trace off

/trace revela líneas de traza/depuración de Plugins con alcance de sesión sin el modo detallado completo. No reemplaza a /debug (sobrescrituras de runtime) ni a /verbose (salida normal de herramientas).

/btw — preguntas laterales

/btw es una pregunta lateral 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:

  • Usa la sesión actual como contexto de fondo.
  • En sesiones del arnés de Codex, se ejecuta como un hilo lateral efímero de Codex.
  • No cambia el contexto futuro de la sesión.
  • No se escribe en el historial de transcripción.

Consulta Preguntas laterales BTW para ver el comportamiento completo.

Notas de superficie

Alcance de sesión por superficie
  • Comandos de texto: se ejecutan en la sesión de chat normal (los DM 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> (dirige a la sesión de chat mediante CommandTargetSessionKey)
  • /login codex envía códigos de emparejamiento de dispositivo solo mediante chat privado o rutas de respuesta de Web UI. Las invocaciones en grupos/temas de Telegram piden al propietario que envíe un DM al bot en su lugar.
  • /stop apunta a la sesión de chat activa para abortar la ejecución actual.
Detalles de Slack

channels.slack.slashCommand admite un único comando de estilo /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 texto /status sigue funcionando en mensajes de Slack.

Ruta rápida y atajos en línea
  • Los mensajes solo con comandos de remitentes en allowlist se gestionan inmediatamente (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 solo con comandos se ignoran silenciosamente; los tokens /... en línea se tratan como texto plano.
Notas de 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 un nombre de proveedor (coincidencia difusa); si no hay coincidencia, el texto se trata como cuerpo del mensaje.
  • /allowlist add|remove requiere commands.config: true y respeta configWrites del canal.

Uso y estado del proveedor

  • Uso/cuota del proveedor (por ejemplo, "Claude 80% left") se muestra en /status para el proveedor del modelo actual cuando el seguimiento de uso está habilitado.
  • Líneas de tokens/caché en /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 es escasa.
  • Ejecución frente a runtime: /status informa Execution para la ruta de sandbox efectiva y Runtime para quién ejecuta la sesión: OpenClaw Default, OpenAI Codex, un backend CLI o un backend ACP.
  • Tokens/costo por respuesta: controlado por /usage off|tokens|full.
  • /model status trata de modelos/autenticación/endpoints, no de uso.

Relacionado

Skills

Cómo se registran y controlan los comandos de barra de Skills.
Crear Skills

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

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

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

On this page