Skip to main content
O Gateway processa comandos enviados como mensagens independentes que começam com /. Os comandos bash exclusivos do host usam ! <cmd> (com /bash <cmd> como alias). Quando uma conversa está vinculada a uma sessão ACP, o texto normal é encaminhado ao harness ACP. Os comandos de gerenciamento do Gateway permanecem locais: /acp ... sempre chega ao manipulador de comandos do OpenClaw, e /status e /unfocus permanecem locais sempre que o processamento de comandos está habilitado para a superfície.

Três tipos de comando

Comandos

Mensagens /... independentes processadas pelo Gateway. Devem ser enviadas como o único conteúdo da mensagem.

Diretivas

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue — removidas da mensagem antes que o modelo a veja. Persistem as configurações da sessão quando enviadas isoladamente; atuam como orientações em linha quando enviadas com outro texto.

Atalhos em linha

/help, /commands, /status, /whoami — são executados imediatamente e removidos antes que o modelo veja o texto restante. Somente remetentes autorizados.
  • As diretivas são removidas da mensagem antes que o modelo a veja.
  • Em mensagens somente com diretivas (a mensagem contém apenas diretivas), elas persistem na sessão e respondem com uma confirmação.
  • Em mensagens de chat normal com outro texto, elas atuam como orientações em linha e não persistem as configurações da sessão.
  • As diretivas se aplicam somente a remetentes autorizados. Se commands.allowFrom estiver definido, ele será a única lista de permissões usada; caso contrário, a autorização virá das listas de permissões/pareamento do canal e de commands.useAccessGroups. Para remetentes não autorizados, as diretivas são tratadas como texto simples.

Configuração

boolean
padrão:"true"
Habilita a análise de /... em mensagens de chat. Em superfícies sem comandos nativos (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), os comandos de texto funcionam mesmo quando definido como false.
boolean | "auto"
padrão:"\"auto\""
Registra comandos nativos. Automático: ativado para Discord/Telegram; desativado para Slack; ignorado para provedores sem suporte nativo. Substitua por canal com channels.<provider>.commands.native. No Discord, false ignora o registro de comandos de barra; comandos registrados anteriormente podem permanecer visíveis até serem removidos.
boolean | "auto"
padrão:"\"auto\""
Registra comandos de Skills nativamente quando houver suporte. Automático: ativado para Discord/Telegram; desativado para Slack. Substitua com channels.<provider>.commands.nativeSkills.
boolean
padrão:"false"
Habilita ! <cmd> para executar comandos do shell do host (alias /bash <cmd>). Requer listas de permissões tools.elevated.
number
padrão:"2000"
Por quanto tempo o bash aguarda antes de alternar para o modo em segundo plano (0 passa imediatamente para o segundo plano).
boolean
padrão:"false"
Habilita /config (lê/grava openclaw.json). Somente para o proprietário.
boolean
padrão:"false"
Habilita /mcp (lê/grava a configuração MCP gerenciada pelo OpenClaw em mcp.servers). Somente para o proprietário.
boolean
padrão:"false"
Habilita /plugins (descoberta/status de plugins, além de instalação e ativação/desativação). Somente para o proprietário em operações de gravação.
boolean
padrão:"false"
Habilita /debug (substituições de configuração somente em tempo de execução). Somente para o proprietário.
boolean
padrão:"true"
Habilita /restart e solicitações externas de reinicialização SIGUSR1.
string[]
Lista de permissões explícita do proprietário para superfícies de comandos exclusivas do proprietário. Separada de commands.allowFrom e do acesso por pareamento em mensagens diretas.
boolean
padrão:"false"
Por canal: exige a identidade do proprietário para comandos exclusivos do proprietário. Quando true, o remetente deve corresponder a commands.ownerAllowFrom ou possuir o escopo interno operator.admin. Uma entrada curinga allowFrom não é suficiente.
"raw" | "hash"
Controla como os IDs do proprietário aparecem no prompt do sistema.
string
Segredo HMAC usado quando commands.ownerDisplay: "hash".
object
Lista de permissões por provedor para autorização de comandos. Quando configurada, ela é a única fonte de autorização para comandos e diretivas. Use "*" como padrão global; chaves específicas do provedor o substituem.
boolean
padrão:"true"
Impõe listas de permissões/políticas para comandos quando commands.allowFrom não está definido.

Lista de comandos

Os comandos vêm de três fontes:
  • Comandos internos do núcleo: src/auto-reply/commands-registry.shared.ts
  • Comandos de dock gerados: src/auto-reply/commands-registry.data.ts
  • Comandos de plugins: chamadas registerCommand() do plugin
A disponibilidade depende das opções de configuração, da superfície do canal e dos plugins instalados/habilitados.

Comandos do núcleo

Caminhos /export-session explícitos substituem arquivos existentes dentro do espaço de trabalho. Omita o caminho para gerar um nome de arquivo sem risco de colisão.
A Control UI intercepta /new digitado para criar e alternar para uma nova sessão do painel, exceto quando session.dmScope: "main" está configurado e o pai atual é a sessão principal do agente — nesse caso, /new redefine a sessão principal no local. /reset digitado ainda executa a redefinição no local do Gateway. Use /model default quando quiser limpar uma seleção de modelo fixada à sessão.
  • /verbose destina-se à depuração — mantenha-o desativado durante o uso normal.
  • /trace revela apenas linhas de rastreamento/depuração pertencentes ao plugin; as demais mensagens detalhadas permanecem desativadas.
  • /fast auto|on|off persiste uma substituição da sessão; use a opção inherit da interface de Sessões para limpá-la.
  • /fast é específico do provedor: OpenAI/Codex o mapeiam para service_tier=priority; solicitações diretas à Anthropic o mapeiam para service_tier=auto ou standard_only.
  • /reasoning, /verbose e /trace apresentam riscos em ambientes de grupo — podem revelar raciocínio interno ou diagnósticos de plugins. Mantenha-os desativados em chats em grupo.
  • /model persiste imediatamente o novo modelo na sessão.
  • Se o agente estiver ocioso, a próxima execução o usará imediatamente.
  • Se houver uma execução ativa, a troca será marcada como pendente e aplicada no próximo ponto seguro de nova tentativa.

Comandos de acoplamento

Os comandos de acoplamento mudam a rota de resposta da sessão ativa para outro canal vinculado. Consulte Acoplamento de canais para configuração e solução de problemas. Gerados por plugins de canal com suporte a comandos nativos:
  • /dock-discord (alias: /dock_discord)
  • /dock-mattermost (alias: /dock_mattermost)
  • /dock-slack (alias: /dock_slack)
  • /dock-telegram (alias: /dock_telegram)
Os comandos de acoplamento exigem session.identityLinks. O remetente de origem e o par de destino devem estar no mesmo grupo de identidades.

Comandos de plugins incluídos

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

Comandos de skills

As skills invocáveis pelo usuário são disponibilizadas como comandos de barra:
  • /skill <name> [input] sempre funciona como ponto de entrada genérico.
  • As skills podem ser registradas como comandos diretos (por exemplo, /prose para OpenProse).
  • O registro nativo de comandos de skills é controlado por commands.nativeSkills e channels.<provider>.commands.nativeSkills.
  • Os nomes são normalizados para a-z0-9_ (máximo de 32 caracteres); colisões recebem sufixos numéricos.
Por padrão, os comandos de skills são encaminhados ao modelo como uma solicitação normal.As skills podem declarar command-dispatch: tool para encaminhar diretamente a uma ferramenta (determinístico, sem participação do modelo). Exemplo: /prose (plugin OpenProse) — consulte OpenProse.
O Discord usa preenchimento automático para opções dinâmicas e menus de botões quando os argumentos obrigatórios são omitidos. O Telegram e o Slack exibem um menu de botões para comandos com opções. As opções dinâmicas são resolvidas de acordo com o modelo da sessão de destino, portanto opções específicas do modelo, como os níveis de /think, seguem a substituição de /model da sessão.

/tools: o que o agente pode usar agora

/tools responde a uma pergunta de runtime: o que este agente pode usar agora nesta conversa — não um catálogo estático de configuração.
Os resultados são específicos da sessão. Alterar o agente, canal, thread, autorização do remetente ou modelo pode alterar a saída. Para editar perfis e substituições, use o painel Ferramentas da IU de Controle ou as superfícies de configuração.

/model: seleção de modelo

No Discord, /model e /models abrem um seletor interativo com listas suspensas de provedor e modelo. O seletor respeita agents.defaults.models, incluindo entradas de provider/*.

/config: gravações de configuração em disco

Exclusivo do proprietário. Desativado por padrão — ative com commands.config: true.
A configuração é validada antes da gravação. Alterações inválidas são rejeitadas. As atualizações de /config persistem após reinicializações.

/mcp: configuração de servidores MCP

Exclusivo do proprietário. Desativado por padrão — ative com commands.mcp: true.
/mcp armazena a configuração na configuração do OpenClaw, não nas configurações de projeto do agente incorporado. /mcp show oculta campos que contêm credenciais, valores reconhecidos de flags de credenciais e argumentos conhecidos com formato de segredo. Quando executada em um grupo, a configuração é enviada de forma privada ao proprietário; se não houver uma rota privada disponível para o proprietário, o comando falhará de forma segura e solicitará que o proprietário tente novamente em uma conversa direta.

/debug: substituições somente para o runtime

Exclusivo do proprietário. Desativado por padrão — ative com commands.debug: true. As substituições são aplicadas imediatamente a novas leituras de configuração, mas não são gravadas em disco.

/plugins: gerenciamento de plugins

Gravações exclusivas do proprietário. Desativado por padrão — ative com commands.plugins: true.
/plugins enable|disable atualiza a configuração dos plugins e recarrega a quente o runtime de plugins do Gateway para novas interações do agente. /plugins install reinicia automaticamente os Gateways gerenciados porque os módulos-fonte dos plugins foram alterados. Instalações confiáveis do ClawHub e do catálogo oficial não precisam de confirmação adicional. Fontes arbitrárias de npm, git, arquivo, npm-pack: e caminho local exibem um aviso de procedência e exigem um --force ao final depois que a fonte for revisada. Essa flag confirma a fonte e permite substituir uma instalação existente; ela não ignora security.installPolicy nem as verificações de segurança do instalador. Versões do ClawHub com avisos de risco ainda exigem a flag separada e exclusiva do shell --acknowledge-clawhub-risk. Instalações do marketplace, vinculadas e fixadas também continuam exclusivas do shell.

/trace: saída de rastreamento de plugins

/trace revela linhas de rastreamento/depuração de plugins específicas da sessão sem o modo detalhado completo. Ele não substitui /debug (substituições de runtime) nem /verbose (saída normal de ferramentas).

/btw: perguntas paralelas

/btw é uma pergunta paralela rápida sobre o contexto da sessão atual. Alias: /side.
Diferentemente de uma mensagem normal:
  • Usa a sessão atual como contexto de fundo.
  • Em sessões do harness do Codex, é executada como uma thread paralela efêmera do Codex.
  • Não altera o contexto futuro da sessão.
  • Não é gravada no histórico da transcrição.
Consulte Perguntas paralelas BTW para conhecer o comportamento completo.

Observações sobre superfícies

  • Comandos de texto: são executados na sessão normal da conversa (mensagens diretas compartilham main; grupos têm sua própria sessão).
  • Comandos nativos do Discord: agent:<agentId>:discord:slash:<userId>
  • Comandos nativos do Slack: agent:<agentId>:slack:slash:<userId> (prefixo configurável por meio de channels.slack.slashCommand.sessionPrefix)
  • Comandos nativos do Telegram: telegram:slash:<userId> (direciona à sessão da conversa por meio de CommandTargetSessionKey)
  • /login codex envia códigos de pareamento de dispositivos somente por conversa privada ou pelos caminhos de resposta da IU da Web. Invocações em grupos/tópicos do Telegram solicitam que o proprietário envie uma mensagem direta ao bot.
  • /stop direciona à sessão da conversa ativa para cancelar a execução atual.
channels.slack.slashCommand oferece suporte a um único comando no estilo /openclaw. Com commands.native: true, crie um comando de barra do Slack para cada comando integrado. Registre /agentstatus (não /status), pois o Slack reserva /status. O texto /status ainda funciona em mensagens do Slack.
  • Mensagens que contêm apenas comandos, enviadas por remetentes na lista de permissões, são processadas imediatamente (ignoram a fila e o modelo).
  • Atalhos em linha (/help, /commands, /status, /whoami) também funcionam incorporados a mensagens normais e são removidos antes que o modelo veja o texto restante.
  • Mensagens não autorizadas que contêm apenas comandos são ignoradas silenciosamente; tokens /... em linha são tratados como texto simples.
  • Os comandos aceitam um : opcional entre o comando e os argumentos (/think: high, /send: on).
  • /new <model> aceita um alias de modelo, provider/model ou um nome de provedor (correspondência aproximada); se não houver correspondência, o texto será tratado como o corpo da mensagem.
  • /allowlist add|remove exige commands.config: true e respeita o configWrites do canal.

Uso e status do provedor

  • Uso/cota do provedor (por exemplo, “Claude com 80% restante”) é exibido em /status para o provedor do modelo atual quando o acompanhamento de uso está ativado.
  • Linhas de tokens/cache em /status podem usar como alternativa a entrada de uso mais recente da transcrição quando o instantâneo da sessão ativa contém poucos dados.
  • Execução versus ambiente de execução: /status informa Execution para o caminho efetivo do sandbox e Runtime para indicar quem está executando a sessão: OpenClaw Default, OpenAI Codex, um backend de CLI ou um backend de ACP.
  • Tokens/custo por resposta: controlados por /usage off|tokens|full.
  • /model status trata de modelos/autenticação/endpoints, não de uso.

Conteúdo relacionado

Skills

Como os comandos de barra de Skills são registrados e controlados.

Criação de Skills

Crie uma Skill que registre seu próprio comando de barra.

BTW

Perguntas paralelas sem alterar o contexto da sessão.

Direcionamento

Oriente o agente durante a execução com /steer.