/.
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.Detalhes do comportamento das diretivas
Detalhes do comportamento das diretivas
- 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.allowFromestiver 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 decommands.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
Comandos do núcleo
Sessões e execuções
Sessões e execuções
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.Controles de modelo e execução
Controles de modelo e execução
Segurança de saída detalhada / rastreamento / modo rápido / raciocínio
Segurança de saída detalhada / rastreamento / modo rápido / raciocínio
/verbosedestina-se à depuração — mantenha-o desativado durante o uso normal./tracerevela apenas linhas de rastreamento/depuração pertencentes ao plugin; as demais mensagens detalhadas permanecem desativadas./fast auto|on|offpersiste uma substituição da sessão; use a opçãoinheritda interface de Sessões para limpá-la./fasté específico do provedor: OpenAI/Codex o mapeiam paraservice_tier=priority; solicitações diretas à Anthropic o mapeiam paraservice_tier=autooustandard_only./reasoning,/verbosee/traceapresentam riscos em ambientes de grupo — podem revelar raciocínio interno ou diagnósticos de plugins. Mantenha-os desativados em chats em grupo.
Detalhes da troca de modelo
Detalhes da troca de modelo
/modelpersiste 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.
Descoberta e status
Descoberta e status
Skills, listas de permissões, aprovações
Skills, listas de permissões, aprovações
Subagentes e ACP
Subagentes e ACP
Gravações e administração exclusivas do proprietário
Gravações e administração exclusivas do proprietário
Voz, TTS, controle de canal
Voz, TTS, controle de canal
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)
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,
/prosepara OpenProse). - O registro nativo de comandos de skills é controlado por
commands.nativeSkillsechannels.<provider>.commands.nativeSkills. - Os nomes são normalizados para
a-z0-9_(máximo de 32 caracteres); colisões recebem sufixos numéricos.
Encaminhamento de comandos de skills
Encaminhamento de comandos de skills
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.Argumentos de comandos nativos
Argumentos de comandos nativos
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.
/model: seleção de modelo
/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./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.
- 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.
Observações sobre superfícies
Escopo da sessão por superfície
Escopo da sessão por superfície
- 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 dechannels.slack.slashCommand.sessionPrefix) - Comandos nativos do Telegram:
telegram:slash:<userId>(direciona à sessão da conversa por meio deCommandTargetSessionKey) /login codexenvia 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./stopdireciona à sessão da conversa ativa para cancelar a execução atual.
Especificidades do Slack
Especificidades do Slack
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.Caminho rápido e atalhos em linha
Caminho rápido e atalhos em linha
- 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.
Observações sobre argumentos
Observações sobre argumentos
- Os comandos aceitam um
:opcional entre o comando e os argumentos (/think: high,/send: on). /new <model>aceita um alias de modelo,provider/modelou um nome de provedor (correspondência aproximada); se não houver correspondência, o texto será tratado como o corpo da mensagem./allowlist add|removeexigecommands.config: truee respeita oconfigWritesdo canal.
Uso e status do provedor
- Uso/cota do provedor (por exemplo, “Claude com 80% restante”) é exibido em
/statuspara o provedor do modelo atual quando o acompanhamento de uso está ativado. - Linhas de tokens/cache em
/statuspodem 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:
/statusinformaExecutionpara o caminho efetivo do sandbox eRuntimepara 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 statustrata 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.