Ultron
Centro operacional local
N
SistemaModo demo

Ferramentas

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.

Base localDemo read-only
Modo demoVerificação efetivaSnapshot local preparado para publicação/showcase.

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

Accounting

main

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

Como Esta Camada Funciona

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.

Prioridade de Ativação

10
browser
Fora do profile

browser

UI

O onboarding local deixa o runtime em `coding`, e o browser não faz parte desse baseline.

Perfis base: manual

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart

Documentação

message
Fora do profile

message

Messaging

A tool de mensagens vive no profile `messaging`; no teu runtime `coding` fica desligada até a adicionares.

Perfis base: messaging

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart
gateway
Fora do profile

gateway

Automation

A tool existe no core, mas está fora do baseline `coding` e continua a ter restrições próprias mesmo quando permitida.

Perfis base: manualO endpoint HTTP `/tools/invoke` bloqueia esta tool por omissão.Apenas o owner a consegue invocar quando estiver 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-json

Expor 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 restart
nodes
Fora do profile

nodes

Nodes

O runtime conhece a tool, mas continua a precisar de allowlist e de nodes emparelhados.

Perfis base: manualApenas o owner a consegue invocar quando estiver permitida.

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart
agents_list
Fora do profile

agents_list

Agents

A tool lista apenas os agentes permitidos pelo `subagents.allowAgents` do agente pedinte.

Perfis base: manual

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-json

Definir 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 restart
tts
Fora do profile

tts

Media

A conversão TTS está implementada no core, mas fora do baseline `coding`.

Perfis base: manual

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-json

Afinar 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 restart

Documentação

apply_patch
Experimental desligada

apply_patch

Files

Faz parte do catálogo do profile `coding`, mas o OpenClaw só a monta quando a flag experimental estiver ligada.

Perfis base: coding

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-json

Aplicar a mudança

Reinicia o gateway para reconstruir o inventário efetivo.

./scripts/openclaw-cli.sh gateway restart

Documentação

image
Falta modelo de imagem

image

Media

O catálogo do profile `coding` inclui `image`, mas a tool só entra quando existe um modelo de visão resolvível.

Perfis base: coding

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
Falta modelo de geração

image_generate

Media

A tool existe no core, mas só aparece quando há um modelo de geração/edit configurado ou inferível.

Perfis base: coding

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 Workflow
Plugin opcional

lobster

lobster

O plugin está instalado, mas a tool não entra enquanto não a acrescentares à allowlist aditiva.

Perfis base: manualplugin:lobster

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart

Mapa Completo

28

Files

4
edit
Ativa agora

edit

Files

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

read
Ativa agora

read

Files

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

write
Ativa agora

write

Files

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

apply_patch
Experimental desligada

apply_patch

Files

Faz parte do catálogo do profile `coding`, mas o OpenClaw só a monta quando a flag experimental estiver ligada.

Perfis base: coding

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-json

Aplicar a mudança

Reinicia o gateway para reconstruir o inventário efetivo.

./scripts/openclaw-cli.sh gateway restart

Documentação

Runtime

2
exec
Ativa agora

exec

Runtime

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

Documentação

process
Ativa agora

process

Runtime

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

Web

2
web_fetch
Ativa agora

web_fetch

Web

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

web_search
Ativa agora

web_search

Web

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

Memory

2
memory_get
Ativa agora

memory_get

Memory

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

memory_search
Ativa agora

memory_search

Memory

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

Sessions

7
session_status
Ativa agora

session_status

Sessions

Disponível no inventário efetivo desta sessão.

Perfis base: minimal, coding, messaging

Porque está assim

Como ligar

sessions_history
Ativa agora

sessions_history

Sessions

Disponível no inventário efetivo desta sessão.

Perfis base: coding, messaging

Porque está assim

Como ligar

sessions_list
Ativa agora

sessions_list

Sessions

Disponível no inventário efetivo desta sessão.

Perfis base: coding, messaging

Porque está assim

Como ligar

sessions_send
Ativa agora

sessions_send

Sessions

Disponível no inventário efetivo desta sessão.

Perfis base: coding, messagingO endpoint HTTP `/tools/invoke` bloqueia esta tool por omissã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
Ativa agora

sessions_spawn

Sessions

Disponível no inventário efetivo desta sessão.

Perfis base: codingO endpoint HTTP `/tools/invoke` bloqueia esta tool por omissã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
Ativa agora

sessions_yield

Sessions

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

subagents
Ativa agora

subagents

Sessions

Disponível no inventário efetivo desta sessão.

Perfis base: coding

Porque está assim

Como ligar

Documentação

UI

2
browser
Fora do profile

browser

UI

O onboarding local deixa o runtime em `coding`, e o browser não faz parte desse baseline.

Perfis base: manual

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart

Documentação

canvas
Fora do profile

canvas

UI

O canvas é uma ponte para comandos `node.invoke`; sem pairing e sem allowlist não há inventário efetivo.

Perfis base: manual

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart

Messaging

1
message
Fora do profile

message

Messaging

A tool de mensagens vive no profile `messaging`; no teu runtime `coding` fica desligada até a adicionares.

Perfis base: messaging

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart

Automation

2
cron
Ativa agora

cron

Automation

Disponível no inventário efetivo desta sessão.

Perfis base: codingO endpoint HTTP `/tools/invoke` bloqueia esta tool por omissão.Apenas o owner a consegue invocar quando estiver permitida.

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
Fora do profile

gateway

Automation

A tool existe no core, mas está fora do baseline `coding` e continua a ter restrições próprias mesmo quando permitida.

Perfis base: manualO endpoint HTTP `/tools/invoke` bloqueia esta tool por omissão.Apenas o owner a consegue invocar quando estiver 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-json

Expor 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 restart

Nodes

1
nodes
Fora do profile

nodes

Nodes

O runtime conhece a tool, mas continua a precisar de allowlist e de nodes emparelhados.

Perfis base: manualApenas o owner a consegue invocar quando estiver permitida.

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart

Agents

1
agents_list
Fora do profile

agents_list

Agents

A tool lista apenas os agentes permitidos pelo `subagents.allowAgents` do agente pedinte.

Perfis base: manual

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-json

Definir 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 restart

Media

3
image
Falta modelo de imagem

image

Media

O catálogo do profile `coding` inclui `image`, mas a tool só entra quando existe um modelo de visão resolvível.

Perfis base: coding

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
Falta modelo de geração

image_generate

Media

A tool existe no core, mas só aparece quando há um modelo de geração/edit configurado ou inferível.

Perfis base: coding

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
Fora do profile

tts

Media

A conversão TTS está implementada no core, mas fora do baseline `coding`.

Perfis base: manual

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-json

Afinar 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 restart

Documentação

lobster

1
Lobster Workflow
Plugin opcional

lobster

lobster

O plugin está instalado, mas a tool não entra enquanto não a acrescentares à allowlist aditiva.

Perfis base: manualplugin:lobster

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-json

Aplicar a mudança

Reinicia o gateway depois de alterares a config.

./scripts/openclaw-cli.sh gateway restart