Comandos de barra

O Gateway lida com comandos enviados como mensagens avulsas que começam com /. Comandos bash somente do host usam ! <cmd> (com /bash <cmd> como alias).

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

Três tipos de comando

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,  },}

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> Por canal: exige identidade de proprietário para comandos somente 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.

Lista de comandos

Os comandos vêm de três fontes:

• Integrados do core: src/auto-reply/commands-registry.shared.ts
• Comandos de dock gerados: src/auto-reply/commands-registry.data.ts
• Comandos de Plugin: chamadas registerCommand() do Plugin

A disponibilidade depende de flags de configuração, superfície do canal e plugins instalados/habilitados.

Comandos do core

Comandos dock

Comandos dock alternam 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 a partir de plugins de canal com suporte a comando nativo:

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

Comandos dock exigem session.identityLinks. O remetente de origem e o par de destino devem estar no mesmo grupo de identidade.

Comandos de plugins integrados

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

Comandos de Skills

Skills invocáveis pelo usuário são expostas como comandos slash:

• /skill <name> [input] sempre funciona como o ponto de entrada genérico.
• Skills podem se registrar como comandos diretos (por exemplo, /prose para OpenProse).
• O registro de comandos nativos de Skills é controlado por commands.nativeSkills e channels.<provider>.commands.nativeSkills.
• Os nomes são sanitizados para a-z0-9_ (máx. 32 caracteres); colisões recebem sufixos numéricos.

/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 de configuração estático.

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

Os resultados têm escopo de sessão. Alterar agente, canal, thread, autorização do remetente ou modelo pode alterar a saída. Para edição de perfil e substituição, use o painel Ferramentas da Control UI ou superfícies de configuração.

/model — seleção de modelo

/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

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

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

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

A configuração é validada antes da gravação. Alterações inválidas são rejeitadas. /config persiste atualizações entre reinicializações.

/mcp — configuração de servidor MCP

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

/mcp armazena a configuração na configuração do OpenClaw, não nas configurações de projeto do agente incorporado.

/debug — substituições somente em runtime

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

/plugins — gerenciamento de plugins

/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin

/plugins enable|disable atualiza a configuração de plugin e recarrega a quente o runtime de plugins do Gateway para novas rodadas do agente. /plugins install reinicia Gateways gerenciados automaticamente porque os módulos-fonte do plugin mudaram.

/trace — saída de rastreamento de plugin

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

/trace revela linhas de rastreamento/depuração de plugin com escopo de sessão sem o modo verboso 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.

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

Ao contrário de uma mensagem normal:

• Usa a sessão atual como contexto de fundo.
• Em sessões do harness Codex, executa como uma thread lateral efêmera do Codex.
• Não altera o contexto futuro da sessão.
• Não é gravada no histórico de transcrição.

Consulte Perguntas paralelas BTW para o comportamento completo.

Observações de superfície

Uso e status de provedor

• Uso/cota do provedor (por exemplo, "Claude 80% left") aparece em /status para o provedor do modelo atual quando o rastreamento de uso está habilitado.
• Linhas de token/cache em /status podem recorrer à entrada de uso mais recente da transcrição quando o snapshot da sessão ao vivo está esparso.
• Execução vs runtime: /status relata Execution para o caminho efetivo de sandbox e Runtime para quem está executando a sessão: OpenClaw Default, OpenAI Codex, um backend de CLI ou um backend ACP.
• Tokens/custo por resposta: controlado por /usage off|tokens|full.
• /model status trata de modelos/autenticação/endpoints, não de uso.

Relacionados