Skills

Comandos de barra

Os comandos são tratados pelo Gateway. A maioria dos comandos deve ser enviada como uma mensagem independente que começa com /. O comando de chat bash somente do host usa ! <cmd> (com /bash <cmd> como alias).

Quando uma conversa ou thread está vinculada a uma sessão ACP, o texto normal de acompanhamento é roteado para esse harness ACP. Os comandos de gerenciamento do Gateway continuam locais: /acp ... sempre chega ao manipulador de comandos ACP do OpenClaw, e /status mais /unfocus permanecem locais sempre que o tratamento de comandos está habilitado para a superfície.

Há dois sistemas relacionados:

Commands

Mensagens /... independentes.

Directives

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue.

  • As diretivas são removidas da mensagem antes de o modelo vê-la.
  • Em mensagens de chat normais (não apenas diretivas), elas são tratadas como "dicas inline" e não persistem as configurações da sessão.
  • Em mensagens somente com diretivas (a mensagem contém apenas diretivas), elas persistem na sessão e respondem com uma confirmação.
  • Diretivas são aplicadas apenas para remetentes autorizados. Se commands.allowFrom estiver definido, ele será a única lista de permissão usada; caso contrário, a autorização vem das listas de permissão/pareamento do canal mais commands.useAccessGroups. Remetentes não autorizados veem as diretivas tratadas como texto simples.
Inline shortcuts

Apenas remetentes permitidos/autorizados: /help, /commands, /status, /whoami (/id).

Eles são executados imediatamente, são removidos antes de o modelo ver a mensagem, e o texto restante continua pelo fluxo normal.

Configuração

{
  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.textboolean

Habilita o parsing de /... em mensagens de chat. Em superfícies sem comandos nativos (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), comandos de texto ainda funcionam mesmo que você defina isto como false.

commands.nativeboolean | "auto"

Registra comandos nativos. Auto: ativado para Discord/Telegram; desativado para Slack (até você adicionar comandos slash); ignorado para provedores sem suporte nativo. Defina channels.discord.commands.native, channels.telegram.commands.native ou channels.slack.commands.native para substituir por provedor (bool ou "auto"). No Discord, false ignora o registro e a limpeza de comandos slash durante a inicialização; comandos registrados anteriormente podem permanecer visíveis até você removê-los do app do Discord. Comandos do Slack são gerenciados no app do Slack e não são removidos automaticamente.

No Discord, especificações de comandos nativos podem incluir descriptionLocalizations, que o OpenClaw publica como description_localizations do Discord e inclui nas comparações de reconciliação.

commands.nativeSkillsboolean | "auto"

Registra comandos de skill nativamente quando houver suporte. Auto: ativado para Discord/Telegram; desativado para Slack (o Slack exige a criação de um comando slash por skill). Defina channels.discord.commands.nativeSkills, channels.telegram.commands.nativeSkills ou channels.slack.commands.nativeSkills para substituir por provedor (bool ou "auto").

commands.bashboolean

Habilita ! <cmd> para executar comandos de shell do host (/bash <cmd> é um alias; requer listas de permissão tools.elevated).

commands.bashForegroundMsnumber

Controla por quanto tempo o bash espera antes de alternar para o modo em segundo plano (0 coloca em segundo plano imediatamente).

commands.configboolean

Habilita /config (lê/grava openclaw.json).

commands.mcpboolean

Habilita /mcp (lê/grava a configuração MCP gerenciada pelo OpenClaw em mcp.servers).

commands.pluginsboolean

Habilita /plugins (descoberta/status de plugins mais controles de instalação e ativação/desativação).

commands.debugboolean

Habilita /debug (substituições somente em runtime).

commands.restartboolean

Habilita /restart mais ações de ferramenta para reiniciar o gateway.

commands.ownerAllowFromstring[]

Define a lista de permissão explícita de proprietário para superfícies de comando/ferramenta somente de proprietário. Esta é a conta do operador humano que pode aprovar ações perigosas e executar comandos como /diagnostics, /export-trajectory e /config. Ela é separada de commands.allowFrom e do acesso de pareamento por DM.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> Por canal: faz com que comandos somente de proprietário exijam identidade de proprietário para serem executados nessa superfície. Quando true, o remetente deve corresponder a um candidato a proprietário resolvido (por exemplo, uma entrada em commands.ownerAllowFrom ou metadados de proprietário nativos do provedor) ou ter o escopo interno operator.admin em um canal de mensagens interno. Uma entrada curinga em allowFrom do canal, ou uma lista vazia/não resolvida de candidatos a proprietário, não é suficiente — comandos somente de proprietário falham fechados nesse canal. Deixe isto desativado se você quiser que comandos somente de proprietário sejam protegidos apenas por ownerAllowFrom e pelas listas de permissão de comandos padrão.

commands.ownerDisplay"raw" | "hash"

Controla como ids de proprietário aparecem no prompt do sistema.

commands.ownerDisplaySecretstring

Opcionalmente define o segredo HMAC usado quando commands.ownerDisplay="hash".

commands.allowFromobject

Lista de permissão por provedor para autorização de comandos. Quando configurada, ela é a única fonte de autorização para comandos e diretivas (listas de permissão/pareamento de canais e commands.useAccessGroups são ignorados). Use "*" para um padrão global; chaves específicas de provedor o substituem.

commands.useAccessGroupsboolean

Impõe listas de permissão/políticas para comandos quando commands.allowFrom não está definido.

Lista de comandos

Fonte da verdade atual:

  • comandos internos do core vêm de src/auto-reply/commands-registry.shared.ts
  • comandos de dock gerados vêm de src/auto-reply/commands-registry.data.ts
  • comandos de plugins vêm de chamadas registerCommand() de plugins
  • a disponibilidade real no seu gateway ainda depende de flags de configuração, superfície do canal e plugins instalados/habilitados

Comandos internos do core

Sessions and runs
  • /new [model] inicia uma nova sessão; /reset é o alias de redefinição.
  • A Control UI intercepta /new digitado para criar e alternar para uma nova sessão de dashboard; /reset digitado ainda executa a redefinição no local do Gateway.
  • /reset soft [message] mantém a transcrição atual, descarta ids de sessão de backend CLI reutilizados e reexecuta o carregamento de inicialização/prompt do sistema no local.
  • /compact [instructions] compacta o contexto da sessão. Consulte Compaction.
  • /stop aborta a execução atual.
  • /session idle <duration|off> e /session max-age <duration|off> gerenciam a expiração do vínculo de thread.
  • /export-session [path] exporta a sessão atual para HTML. Alias: /export.
  • /export-trajectory [path] solicita aprovação de exec e, em seguida, exporta um pacote de trajetória JSONL para a sessão atual. Use-o quando você precisar da linha do tempo de prompt, ferramenta e transcrição para uma sessão do OpenClaw. Em chats de grupo, o prompt de aprovação e o resultado da exportação vão para o proprietário em privado. Alias: /trajectory.
Model and run controls
  • /think <level> define o nível de raciocínio. As opções vêm do perfil de provedor do modelo ativo; níveis comuns são off, minimal, low, medium e high, com níveis personalizados como xhigh, adaptive, max ou binário on apenas onde houver suporte. Aliases: /thinking, /t.
  • /verbose on|off|full alterna a saída detalhada. Alias: /v.
  • /trace on|off alterna a saída de trace de plugin para a sessão atual.
  • /fast [status|on|off] mostra ou define o modo rápido.
  • /reasoning [on|off|stream] alterna a visibilidade do raciocínio. Alias: /reason.
  • /elevated [on|off|ask|full] alterna o modo elevado. Alias: /elev.
  • /exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> mostra ou define padrões de exec.
  • /model [name|#|status] mostra ou define o modelo.
  • /models [provider] [page] [limit=<n>|size=<n>|all] lista provedores ou modelos configurados/com autenticação disponível para um provedor; adicione all para navegar pelo catálogo completo desse provedor.
  • /queue <mode> gerencia o comportamento da fila (steer, legado queue, followup, collect, steer-backlog, interrupt) mais opções como debounce:0.5s cap:25 drop:summarize; /queue default ou /queue reset limpa a substituição da sessão. Consulte Fila de comandos e Fila de direcionamento.
  • /steer <message> injeta orientação na execução ativa para a sessão atual, independentemente do modo /queue. Ele não inicia uma nova execução quando a sessão está ociosa. Alias: /tell. Consulte Direcionar.
Discovery and status
  • /help mostra o resumo curto de ajuda.
  • /commands mostra o catálogo de comandos gerado.
  • /tools [compact|verbose] mostra o que o agente atual pode usar agora.
  • /status mostra status de execução/runtime, uptime do Gateway e do sistema, além de uso/cota do provedor quando disponível.
  • /diagnostics [note] é o fluxo de relatório de suporte somente do proprietário para bugs do Gateway e execuções do harness Codex. Ele solicita aprovação explícita de exec todas as vezes antes de executar openclaw gateway diagnostics export --json; não aprove diagnósticos com uma regra de permitir tudo. Após a aprovação, ele envia um relatório colável com o caminho do pacote local, resumo do manifesto, notas de privacidade e ids de sessão relevantes. Em chats de grupo, o prompt de aprovação e o relatório vão para o proprietário em privado. Quando a sessão ativa usa o harness OpenAI Codex, a mesma aprovação também envia feedback relevante do Codex para servidores da OpenAI, e a resposta concluída lista os ids de sessão do OpenClaw, ids de thread do Codex e comandos codex resume <thread-id>. Consulte Exportação de diagnósticos.
  • /crestodian <request> executa o auxiliar de configuração e reparo Crestodian a partir de uma DM do proprietário.
  • /tasks lista tarefas em segundo plano ativas/recentes para a sessão atual.
  • /context [list|detail|json] explica como o contexto é montado.
  • /whoami mostra seu id de remetente. Alias: /id.
  • /usage off|tokens|full|cost controla o rodapé de uso por resposta ou imprime um resumo local de custo.
Skills, allowlists, approvals
  • /skill <name> [input] executa uma skill por nome.
  • /allowlist [list|add|remove] ... gerencia entradas da lista de permissão. Somente texto.
  • /approve <id> <decision> resolve prompts de aprovação de exec.
  • /btw <question> faz uma pergunta paralela sem alterar o contexto futuro da sessão. Alias: /side. Consulte BTW.
Subagentes e ACP
  • /subagents list|kill|log|info|send|steer|spawn gerencia execuções de subagentes para a sessão atual.
  • /acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help gerencia sessões ACP e opções de runtime.
  • /focus <target> vincula o thread atual do Discord ou o tópico/conversa do Telegram a um destino de sessão.
  • /unfocus remove o vínculo atual.
  • /agents lista agentes vinculados ao thread para a sessão atual.
  • /kill <id|#|all> interrompe um ou todos os subagentes em execução.
  • /subagents steer <id|#> <message> envia direcionamento para um subagente em execução. Consulte Direcionar.
Gravações somente pelo proprietário e administração
  • /config show|get|set|unset lê ou grava openclaw.json. Somente proprietário. Exige commands.config: true.
  • /mcp show|get|set|unset lê ou grava a configuração de servidor MCP gerenciada pelo OpenClaw em mcp.servers. Somente proprietário. Exige commands.mcp: true.
  • /plugins list|inspect|show|get|install|enable|disable inspeciona ou altera o estado de plugins. /plugin é um alias. Gravações somente pelo proprietário. Exige commands.plugins: true.
  • /debug show|set|unset|reset gerencia substituições de configuração apenas de runtime. Somente proprietário. Exige commands.debug: true.
  • /restart reinicia o OpenClaw quando habilitado. Padrão: habilitado; defina commands.restart: false para desabilitar.
  • /send on|off|inherit define a política de envio. Somente proprietário.
Voz, TTS, controle de canal
  • /tts on|off|status|chat|latest|provider|limit|summary|audio|help controla TTS. Consulte TTS.
  • /activation mention|always define o modo de ativação em grupo.
  • /bash <command> executa um comando de shell do host. Somente texto. Alias: ! <command>. Exige commands.bash: true mais allowlists de tools.elevated.
  • !poll [sessionId] verifica uma tarefa bash em segundo plano.
  • !stop [sessionId] interrompe uma tarefa bash em segundo plano.

Comandos de encaixe gerados

Comandos de encaixe alternam a rota de resposta da sessão atual para outro canal vinculado. Consulte Encaixe de canais para configuração, exemplos e solução de problemas.

Comandos de encaixe são gerados a partir de plugins de canal com suporte a comandos nativos. Conjunto empacotado atual:

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

Use comandos de encaixe em uma conversa direta para alternar a rota de resposta da sessão atual para outro canal vinculado. O agente mantém o mesmo contexto de sessão, mas as respostas futuras dessa sessão são entregues ao par do canal selecionado.

Comandos de encaixe exigem session.identityLinks. O remetente de origem e o par de destino devem estar no mesmo grupo de identidades, por exemplo ["telegram:123", "discord:456"]. Se um usuário do Telegram com id 123 enviar /dock_discord, o OpenClaw armazena lastChannel: "discord" e lastTo: "456" na sessão ativa. Se o remetente não estiver vinculado a um par do Discord, o comando responde com uma dica de configuração em vez de seguir para o chat normal.

O encaixe altera apenas a rota da sessão ativa. Ele não cria contas de canal, concede acesso, ignora allowlists de canais nem move o histórico de transcrição para outra sessão. Use /dock-telegram, /dock-slack, /dock-mattermost ou outro comando de encaixe gerado para alternar a rota novamente.

Comandos de plugins empacotados

Plugins empacotados podem adicionar mais comandos de barra. Comandos empacotados atuais neste repositório:

  • /dreaming [on|off|status|help] alterna Dreaming de memória. Consulte Dreaming.
  • /pair [qr|status|pending|approve|cleanup|notify] gerencia o fluxo de emparelhamento/configuração de dispositivos. Consulte Emparelhamento.
  • /phone status|arm <camera|screen|writes|all> [duration]|disarm arma temporariamente comandos de Node de telefone de alto risco.
  • /voice status|list [limit]|set <voiceId|name> gerencia a configuração de voz do Talk. No Discord, o nome do comando nativo é /talkvoice.
  • /card ... envia predefinições de cartão rico do LINE. Consulte LINE.
  • /codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills inspeciona e controla o harness de servidor de app Codex empacotado. Consulte Harness Codex.
  • Comandos somente do QQBot:
    • /bot-ping
    • /bot-version
    • /bot-help
    • /bot-upgrade
    • /bot-logs

Comandos dinâmicos de Skills

Skills invocáveis pelo usuário também são expostas como comandos de barra:

  • /skill <name> [input] sempre funciona como o ponto de entrada genérico.
  • Skills também podem aparecer como comandos diretos, como /prose, quando a skill/plugin os registra.
  • o registro de comandos nativos de Skills é controlado por commands.nativeSkills e channels.<provider>.commands.nativeSkills.
  • especificações de comando podem fornecer descriptionLocalizations para superfícies nativas que dão suporte a descrições localizadas, incluindo Discord.
Observações sobre argumentos e parser
  • Comandos aceitam um : opcional entre o comando e os argumentos (por exemplo, /think: high, /send: on, /help:).
  • /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 é tratado como o corpo da mensagem.
  • Para o detalhamento completo de uso por provedor, use openclaw status --usage.
  • /allowlist add|remove exige commands.config=true e respeita configWrites do canal.
  • Em canais com várias contas, /allowlist --account <id> direcionado à configuração e /config set channels.<provider>.accounts.<id>... também respeitam o configWrites da conta de destino.
  • /usage controla o rodapé de uso por resposta; /usage cost imprime um resumo local de custos a partir dos logs de sessão do OpenClaw.
  • /restart é habilitado por padrão; defina commands.restart: false para desabilitar.
  • /plugins install <spec> aceita as mesmas especificações de Plugin que openclaw plugins install: caminho/arquivo local, pacote npm, git:<repo> ou clawhub:<pkg>, então solicita uma reinicialização do Gateway porque os módulos de origem do Plugin mudaram.
  • /plugins enable|disable atualiza a configuração do Plugin e aciona o recarregamento de plugins do Gateway para novas interações do agente.
Comportamento específico do canal
  • Comando nativo somente do Discord: /vc join|leave|status controla canais de voz (não disponível como texto). join exige um servidor e canal de voz/palco selecionado. Exige channels.discord.voice e comandos nativos.
  • Comandos de vinculação de thread do Discord (/focus, /unfocus, /agents, /session idle, /session max-age) exigem que vínculos efetivos de thread estejam habilitados (session.threadBindings.enabled e/ou channels.discord.threadBindings.enabled).
  • Referência de comandos ACP e comportamento de runtime: Agentes ACP.
Segurança de detalhado / trace / rápido / raciocínio
  • /verbose serve para depuração e visibilidade extra; mantenha-o desligado no uso normal.
  • /trace é mais restrito que /verbose: ele revela apenas linhas de trace/depuração de propriedade do Plugin e mantém desligada a verbosidade normal de ferramentas.
  • /fast on|off persiste uma substituição de sessão. Use a opção inherit da UI de Sessões para limpá-la e voltar aos padrões da configuração.
  • /fast é específico do provedor: OpenAI/OpenAI Codex o mapeiam para service_tier=priority em endpoints Responses nativos, enquanto solicitações públicas diretas da Anthropic, incluindo tráfego autenticado por OAuth enviado para api.anthropic.com, o mapeiam para service_tier=auto ou standard_only. Consulte OpenAI e Anthropic.
  • Resumos de falhas de ferramentas ainda são mostrados quando relevantes, mas o texto detalhado da falha só é incluído quando /verbose está on ou full.
  • /reasoning, /verbose e /trace são arriscados em contextos de grupo: eles podem revelar raciocínio interno, saída de ferramentas ou diagnósticos de plugins que você não pretendia expor. Prefira deixá-los desligados, especialmente em chats de grupo.
Troca de modelo
  • /model persiste o novo modelo da sessão imediatamente.
  • Se o agente estiver ocioso, a próxima execução o usa imediatamente.
  • Se uma execução já estiver ativa, o OpenClaw marca uma troca ao vivo como pendente e só reinicia no novo modelo em um ponto limpo de nova tentativa.
  • Se a atividade de ferramentas ou a saída de resposta já tiver começado, a troca pendente pode permanecer na fila até uma oportunidade posterior de nova tentativa ou a próxima interação do usuário.
  • Na TUI local, /crestodian [request] retorna da TUI normal do agente para o Crestodian. Isso é separado do modo de resgate de canal de mensagens e não concede autoridade remota de configuração.
Caminho rápido e atalhos inline
  • Caminho rápido: mensagens somente de comando de remetentes na allowlist são processadas imediatamente (ignora fila + modelo).
  • Bloqueio por menção em grupo: mensagens somente de comando de remetentes na allowlist ignoram requisitos de menção.
  • Atalhos inline (somente remetentes na allowlist): certos comandos também funcionam quando incorporados em uma mensagem normal e são removidos antes que o modelo veja o texto restante.
    • Exemplo: hey /status aciona uma resposta de status, e o texto restante continua pelo fluxo normal.
  • Atualmente: /help, /commands, /status, /whoami (/id).
  • Mensagens somente de comando não autorizadas são ignoradas silenciosamente, e tokens inline /... são tratados como texto comum.
Comandos de Skills e argumentos nativos
  • Comandos de Skills: Skills user-invocable são expostas como comandos de barra. Os nomes são sanitizados para a-z0-9_ (máx. 32 caracteres); colisões recebem sufixos numéricos (por exemplo, _2).
    • /skill <name> [input] executa uma skill pelo nome (útil quando limites de comandos nativos impedem comandos por skill).
    • Por padrão, comandos de Skills são encaminhados ao modelo como uma solicitação normal.
    • Skills podem opcionalmente declarar command-dispatch: tool para rotear o comando diretamente para uma ferramenta (determinístico, sem modelo).
    • Exemplo: /prose (Plugin OpenProse) — consulte OpenProse.
  • Argumentos de comando nativo: Discord usa preenchimento automático para opções dinâmicas (e menus de botões quando você omite argumentos obrigatórios). Telegram e Slack mostram um menu de botões quando um comando dá suporte a escolhas e você omite o argumento. Escolhas dinâmicas são resolvidas com base no modelo da sessão de destino, então opções específicas de modelo, como níveis de /think, seguem a substituição de /model dessa sessão.

/tools

/tools responde a uma pergunta de runtime, não a uma pergunta de configuração: o que este agente pode usar agora nesta conversa.

  • O /tools padrão é compacto e otimizado para varredura rápida.
  • /tools verbose adiciona descrições curtas.
  • Superfícies de comando nativo que dão suporte a argumentos expõem a mesma troca de modo como compact|verbose.
  • Os resultados têm escopo de sessão, então alterar agente, canal, thread, autorização do remetente ou modelo pode alterar a saída.
  • /tools inclui ferramentas que são realmente acessíveis em runtime, incluindo ferramentas principais, ferramentas de Plugin conectadas e ferramentas de propriedade do canal.

Para edição de perfil e substituições, use o painel Ferramentas da UI de Controle ou superfícies de configuração/catálogo em vez de tratar /tools como um catálogo estático.

Superfícies de uso (o que aparece onde)

  • Uso/cota do provedor (exemplo: "Claude 80% restante") aparece em /status para o provedor do modelo atual quando o rastreamento de uso está habilitado. O OpenClaw normaliza as janelas do provedor para % restante; para MiniMax, campos percentuais somente de restante são invertidos antes da exibição, e respostas model_remains preferem a entrada do modelo de chat mais um rótulo de plano com tag de modelo.
  • Linhas de tokens/cache em /status podem recorrer à entrada de uso mais recente da transcrição quando o snapshot da sessão em tempo real é esparso. Valores em tempo real não zero existentes ainda têm prioridade, e o fallback da transcrição também pode recuperar o rótulo do modelo de runtime ativo mais um total maior orientado a prompt quando os totais armazenados estão ausentes ou são menores.
  • Execução vs runtime: /status relata Execution para o caminho efetivo do sandbox e Runtime para quem está realmente executando a sessão: OpenClaw Pi Default, OpenAI Codex, um backend de CLI ou um backend ACP.
  • Tokens/custo por resposta é controlado por /usage off|tokens|full (anexado às respostas normais).
  • /model status trata de modelos/autenticação/endpoints, não de uso.

Seleção de modelo (/model)

/model é implementado como uma diretiva.

Exemplos:

/model
/model list
/model 3
/model openai/gpt-5.4
/model opus@anthropic:default
/model status

Observações:

  • /model e /model list mostram um seletor compacto e numerado (família do modelo + provedores disponíveis).
  • No Discord, /model e /models abrem um seletor interativo com menus suspensos de provedor e modelo, além de uma etapa de Enviar.
  • /model <#> seleciona a partir desse seletor (e prefere o provedor atual quando possível).
  • /model status mostra a visualização detalhada, incluindo o endpoint configurado do provedor (baseUrl) e o modo de API (api) quando disponíveis.

Substituições de depuração

/debug permite definir substituições de configuração somente de runtime (memória, não disco). Somente proprietário. Desabilitado por padrão; habilite com commands.debug: true.

Exemplos:

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

Saída de rastreamento de Plugin

/trace permite alternar linhas de rastreamento/depuração de Plugin com escopo de sessão sem ativar o modo verboso completo.

Exemplos:

/trace
/trace on
/trace off

Observações:

  • /trace sem argumento mostra o estado atual de rastreamento da sessão.
  • /trace on habilita linhas de rastreamento de Plugin para a sessão atual.
  • /trace off as desabilita novamente.
  • Linhas de rastreamento de Plugin podem aparecer em /status e como uma mensagem diagnóstica de acompanhamento após a resposta normal do assistente.
  • /trace não substitui /debug; /debug ainda gerencia substituições de configuração somente de runtime.
  • /trace não substitui /verbose; a saída verbosa normal de ferramentas/status ainda pertence a /verbose.

Atualizações de configuração

/config grava na sua configuração em disco (openclaw.json). Somente proprietário. Desabilitado por padrão; habilite com commands.config: true.

Exemplos:

/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"
/config unset messages.responsePrefix

Atualizações de MCP

/mcp grava definições de servidor MCP gerenciadas pelo OpenClaw em mcp.servers. Somente proprietário. Desabilitado por padrão; habilite com commands.mcp: true.

Exemplos:

/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7

Atualizações de Plugin

/plugins permite que operadores inspecionem Plugins descobertos e alternem a habilitação na configuração. Fluxos somente leitura podem usar /plugin como alias. Desabilitado por padrão; habilite com commands.plugins: true.

Exemplos:

/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7

Observações de superfície

Sessões por superfície
  • Comandos de texto são executados na sessão de chat normal (DMs compartilham main, grupos têm sua própria sessão).
  • Comandos nativos usam sessões isoladas:
    • Discord: agent:<agentId>:discord:slash:<userId>
    • Slack: agent:<agentId>:slack:slash:<userId> (prefixo configurável via channels.slack.slashCommand.sessionPrefix)
    • Telegram: telegram:slash:<userId> (aponta para a sessão de chat via CommandTargetSessionKey)
  • /stop aponta para a sessão de chat ativa para que ela possa abortar a execução atual.
Especificidades do Slack

channels.slack.slashCommand ainda é compatível com um único comando no estilo /openclaw. Se você habilitar commands.native, deverá criar um comando de barra do Slack por comando integrado (mesmos nomes que /help). Menus de argumentos de comando para Slack são entregues como botões efêmeros do Block Kit.

Exceção nativa do Slack: registre /agentstatus (não /status) porque o Slack reserva /status. O texto /status ainda funciona em mensagens do Slack.

Perguntas paralelas BTW

/btw é uma pergunta paralela rápida sobre a sessão atual. /side é um alias.

Ao contrário do chat normal:

  • usa a sessão atual como contexto de fundo,
  • executa como uma chamada única separada sem ferramentas,
  • não altera o contexto futuro da sessão,
  • não é gravado no histórico de transcrição,
  • é entregue como um resultado paralelo em tempo real em vez de uma mensagem normal do assistente.

Isso torna /btw útil quando você quer um esclarecimento temporário enquanto a tarefa principal continua em andamento.

Exemplo:

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

Consulte Perguntas paralelas BTW para ver o comportamento completo e os detalhes de UX do cliente.

Relacionado