Catálogo
28
Camada real do OpenClaw: catálogo, inventário efetivo da sessão, regras de onboarding e instruções de ativação sem dupla verdade nem registo manual local.
Inventário efetivo confirmado com `agent:accounting:main`.
Catálogo
28
Ativas agora
17
Fora do profile
7
Precisam de setup
3
Restritas
0
Sessão
Profile
coding
Profile efetivo
coding
Modelo
openai-codex/gpt-5.4
Provider TTS
microsoft
Modelo imagem
—
Modelo geração
—
Canais
telegram, whatsapp
Plugins
lobster, telegram, whatsapp, xai
Último onboarding
onboard · local · 25/03/2026, 09:09
Onboarding
O `openclaw onboard` grava o baseline local. No teu caso, o runtime ficou em `tools.profile = coding`, por isso várias tools continuam fora por defeito.
Catálogo
`tools.catalog` mostra o que o runtime conhece: core, plugins, grupos e perfis onde cada tool entra por defeito.
Inventário Efetivo
`tools.effective(sessionKey)` é a verdade operacional: a sessão atual já passou por profile, provider, ownerOnly, channel, sandbox e subagentes.
Frontend
Uma UI deve ler o catálogo e o inventário efetivo, e só chamar tools sensíveis através de um backend teu. `POST /tools/invoke` tem uma denylist própria.
browser
O onboarding local deixa o runtime em `coding`, e o browser não faz parte desse baseline.
Porque está assim
Onboarding
A instalação local ficou com `tools.profile = "coding"`, que exclui `browser` por defeito.
Dependência local
Precisa de um Chromium compatível detetável no host ou de `browser.executablePath` definido explicitamente.
Como ligar
Adicionar ao baseline
Usa `tools.alsoAllow` para somar a tool ao profile atual.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["browser"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartDocumentação
message
A tool de mensagens vive no profile `messaging`; no teu runtime `coding` fica desligada até a adicionares.
Porque está assim
Profile
`message` faz parte do profile `messaging`, não do `coding`.
Backends de canal
Já tens canais ativos (whatsapp, telegram), por isso aqui o bloqueio principal é policy.
Como ligar
Somar ao profile atual
Permite a tool sem sair do profile `coding`.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["message"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartgateway
A tool existe no core, mas está fora do baseline `coding` e continua a ter restrições próprias mesmo quando permitida.
Porque está assim
Profile
`gateway` não faz parte do profile `coding`; tens de a adicionar via `tools.alsoAllow`.
Owner-only
Mesmo permitida, a tool só fica disponível para o owner.
Frontend HTTP
Se quiseres botões de UI a chamar `/tools/invoke`, ainda tens de abrir `gateway.tools.allow` para `gateway`.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["gateway"]' --strict-jsonExpor ao HTTP (opcional)
Só necessário se fores invocar a tool por HTTP a partir de um backend teu.
config: gateway.tools.allow
["gateway"]Aplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartnodes
O runtime conhece a tool, mas continua a precisar de allowlist e de nodes emparelhados.
Porque está assim
Profile
`nodes` está fora do profile `coding` e precisa de `tools.alsoAllow`.
Owner-only
A execução fica reservada ao owner.
Pairing
Sem nodes/dispositivos emparelhados, a tool não terá alvos reais para listar ou invocar.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["nodes"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartagents_list
A tool lista apenas os agentes permitidos pelo `subagents.allowAgents` do agente pedinte.
Porque está assim
Profile
`agents_list` está fora do profile `coding` e precisa de `tools.alsoAllow`.
Allowlist por agente
Accounting não tem `subagents.allowAgents` definido, por isso a tool tende a devolver apenas o próprio agente.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["agents_list"]' --strict-jsonDefinir targets permitidos
Configura a allowlist no próprio agente para a tool ficar realmente útil.
config: agents.list[id=accounting].subagents.allowAgents
["donna-paulsen", "accounting"]Aplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restarttts
A conversão TTS está implementada no core, mas fora do baseline `coding`.
Porque está assim
Profile
`tts` está fora do profile `coding` e precisa de `tools.alsoAllow`.
Provider
Se não configurares nada, o OpenClaw resolve TTS para Microsoft; OpenAI e ElevenLabs exigem credenciais próprias.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["tts"]' --strict-jsonAfinar provider (opcional)
Só precisas disto se quiseres um provider ou voz diferente.
config: messages.tts.provider
"microsoft"Aplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartDocumentação
apply_patch
Faz parte do catálogo do profile `coding`, mas o OpenClaw só a monta quando a flag experimental estiver ligada.
Porque está assim
Flag de execução
`tools.exec.applyPatch.enabled` está desligada ou ausente. O runtime não expõe `apply_patch` por omissão.
Compatibilidade de modelo
A tool só entra com modelos `openai` ou `openai-codex`, e pode ainda ser limitada por `tools.exec.applyPatch.allowModels`.
Como ligar
Ligar a tool
Ativa a flag experimental do runtime.
config: tools.exec.applyPatch.enabled
./scripts/openclaw-cli.sh config set tools.exec.applyPatch.enabled true --strict-jsonAplicar a mudança
Reinicia o gateway para reconstruir o inventário efetivo.
./scripts/openclaw-cli.sh gateway restartDocumentação
image
O catálogo do profile `coding` inclui `image`, mas a tool só entra quando existe um modelo de visão resolvível.
Porque está assim
Modelo de imagem
Não tens `agents.defaults.imageModel` definido, e a auth atual não chega para o runtime inferir um modelo de visão utilizável.
Auth do provider
Providers com auth detetada: openai-codex. O provider da tool de imagem tem de corresponder a uma auth realmente suportada para visão.
Como ligar
Escolher um modelo de imagem
Define explicitamente o backend de visão que queres usar.
config: agents.defaults.imageModel.primary
"openai/gpt-5-mini"image_generate
A tool existe no core, mas só aparece quando há um modelo de geração/edit configurado ou inferível.
Porque está assim
Modelo de geração
Não tens `agents.defaults.imageGenerationModel` configurado e o runtime não inferiu nenhum provider de geração a partir da auth atual.
Provider externo
Quando escolhes `openai/*`, `google/*`, `fal/*` ou outro provider, também tens de configurar a auth/API key correspondente.
Como ligar
Escolher um modelo de geração
Define explicitamente o provider/model que queres para gerar ou editar imagens.
config: agents.defaults.imageGenerationModel.primary
"google/gemini-3-pro-image-preview"lobster
O plugin está instalado, mas a tool não entra enquanto não a acrescentares à allowlist aditiva.
Porque está assim
Plugin detectado
O plugin `lobster` está ativo no runtime.
Como ligar
Permitir a tool do plugin
O caminho recomendado é usar `tools.alsoAllow` em vez de trocar o profile inteiro.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["lobster"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartedit
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
read
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
write
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
apply_patch
Faz parte do catálogo do profile `coding`, mas o OpenClaw só a monta quando a flag experimental estiver ligada.
Porque está assim
Flag de execução
`tools.exec.applyPatch.enabled` está desligada ou ausente. O runtime não expõe `apply_patch` por omissão.
Compatibilidade de modelo
A tool só entra com modelos `openai` ou `openai-codex`, e pode ainda ser limitada por `tools.exec.applyPatch.allowModels`.
Como ligar
Ligar a tool
Ativa a flag experimental do runtime.
config: tools.exec.applyPatch.enabled
./scripts/openclaw-cli.sh config set tools.exec.applyPatch.enabled true --strict-jsonAplicar a mudança
Reinicia o gateway para reconstruir o inventário efetivo.
./scripts/openclaw-cli.sh gateway restartDocumentação
exec
Disponível no inventário efetivo desta sessão.
process
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
web_fetch
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
web_search
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
memory_get
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
memory_search
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
session_status
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
sessions_history
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
sessions_list
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
sessions_send
Disponível no inventário efetivo desta sessão.
Porque está assim
UI direta
Mesmo ativa na sessão, continua bloqueada para chamadas HTTP diretas até ajustares a policy do gateway.
Como ligar
sessions_spawn
Disponível no inventário efetivo desta sessão.
Porque está assim
UI direta
Mesmo ativa na sessão, continua bloqueada para chamadas HTTP diretas até ajustares a policy do gateway.
Como ligar
sessions_yield
Disponível no inventário efetivo desta sessão.
Porque está assim
Como ligar
subagents
Disponível no inventário efetivo desta sessão.
browser
O onboarding local deixa o runtime em `coding`, e o browser não faz parte desse baseline.
Porque está assim
Onboarding
A instalação local ficou com `tools.profile = "coding"`, que exclui `browser` por defeito.
Dependência local
Precisa de um Chromium compatível detetável no host ou de `browser.executablePath` definido explicitamente.
Como ligar
Adicionar ao baseline
Usa `tools.alsoAllow` para somar a tool ao profile atual.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["browser"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartDocumentação
canvas
O canvas é uma ponte para comandos `node.invoke`; sem pairing e sem allowlist não há inventário efetivo.
Porque está assim
Profile
`canvas` não entra no profile `coding` e tem de ser acrescentada via `tools.alsoAllow`.
Node emparelhado
Mesmo depois de allowlisted, precisa de um node/dispositivo com capacidade de canvas disponível.
Como ligar
Adicionar ao profile atual
Permite a tool a partir da allowlist aditiva.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["canvas"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartmessage
A tool de mensagens vive no profile `messaging`; no teu runtime `coding` fica desligada até a adicionares.
Porque está assim
Profile
`message` faz parte do profile `messaging`, não do `coding`.
Backends de canal
Já tens canais ativos (whatsapp, telegram), por isso aqui o bloqueio principal é policy.
Como ligar
Somar ao profile atual
Permite a tool sem sair do profile `coding`.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["message"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartcron
Disponível no inventário efetivo desta sessão.
Porque está assim
UI direta
Mesmo ativa na sessão, continua bloqueada para chamadas HTTP diretas até ajustares a policy do gateway.
Como ligar
gateway
A tool existe no core, mas está fora do baseline `coding` e continua a ter restrições próprias mesmo quando permitida.
Porque está assim
Profile
`gateway` não faz parte do profile `coding`; tens de a adicionar via `tools.alsoAllow`.
Owner-only
Mesmo permitida, a tool só fica disponível para o owner.
Frontend HTTP
Se quiseres botões de UI a chamar `/tools/invoke`, ainda tens de abrir `gateway.tools.allow` para `gateway`.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["gateway"]' --strict-jsonExpor ao HTTP (opcional)
Só necessário se fores invocar a tool por HTTP a partir de um backend teu.
config: gateway.tools.allow
["gateway"]Aplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartnodes
O runtime conhece a tool, mas continua a precisar de allowlist e de nodes emparelhados.
Porque está assim
Profile
`nodes` está fora do profile `coding` e precisa de `tools.alsoAllow`.
Owner-only
A execução fica reservada ao owner.
Pairing
Sem nodes/dispositivos emparelhados, a tool não terá alvos reais para listar ou invocar.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["nodes"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartagents_list
A tool lista apenas os agentes permitidos pelo `subagents.allowAgents` do agente pedinte.
Porque está assim
Profile
`agents_list` está fora do profile `coding` e precisa de `tools.alsoAllow`.
Allowlist por agente
Accounting não tem `subagents.allowAgents` definido, por isso a tool tende a devolver apenas o próprio agente.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["agents_list"]' --strict-jsonDefinir targets permitidos
Configura a allowlist no próprio agente para a tool ficar realmente útil.
config: agents.list[id=accounting].subagents.allowAgents
["donna-paulsen", "accounting"]Aplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartimage
O catálogo do profile `coding` inclui `image`, mas a tool só entra quando existe um modelo de visão resolvível.
Porque está assim
Modelo de imagem
Não tens `agents.defaults.imageModel` definido, e a auth atual não chega para o runtime inferir um modelo de visão utilizável.
Auth do provider
Providers com auth detetada: openai-codex. O provider da tool de imagem tem de corresponder a uma auth realmente suportada para visão.
Como ligar
Escolher um modelo de imagem
Define explicitamente o backend de visão que queres usar.
config: agents.defaults.imageModel.primary
"openai/gpt-5-mini"image_generate
A tool existe no core, mas só aparece quando há um modelo de geração/edit configurado ou inferível.
Porque está assim
Modelo de geração
Não tens `agents.defaults.imageGenerationModel` configurado e o runtime não inferiu nenhum provider de geração a partir da auth atual.
Provider externo
Quando escolhes `openai/*`, `google/*`, `fal/*` ou outro provider, também tens de configurar a auth/API key correspondente.
Como ligar
Escolher um modelo de geração
Define explicitamente o provider/model que queres para gerar ou editar imagens.
config: agents.defaults.imageGenerationModel.primary
"google/gemini-3-pro-image-preview"tts
A conversão TTS está implementada no core, mas fora do baseline `coding`.
Porque está assim
Profile
`tts` está fora do profile `coding` e precisa de `tools.alsoAllow`.
Provider
Se não configurares nada, o OpenClaw resolve TTS para Microsoft; OpenAI e ElevenLabs exigem credenciais próprias.
Como ligar
Somar ao profile atual
Permite a tool no runtime do agente.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["tts"]' --strict-jsonAfinar provider (opcional)
Só precisas disto se quiseres um provider ou voz diferente.
config: messages.tts.provider
"microsoft"Aplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restartDocumentação
lobster
O plugin está instalado, mas a tool não entra enquanto não a acrescentares à allowlist aditiva.
Porque está assim
Plugin detectado
O plugin `lobster` está ativo no runtime.
Como ligar
Permitir a tool do plugin
O caminho recomendado é usar `tools.alsoAllow` em vez de trocar o profile inteiro.
config: tools.alsoAllow
./scripts/openclaw-cli.sh config set tools.alsoAllow '["lobster"]' --strict-jsonAplicar a mudança
Reinicia o gateway depois de alterares a config.
./scripts/openclaw-cli.sh gateway restart