O Que Acontece Nesta Secção
Vais registar cada agente no OpenClaw e dar-lhes o primeiro comando. No final, todos os 6 agentes estarão ativos — a reportar nos seus canais do Discord e prontos para receber as tuas instruções.
Duas formas de falar com os teus agentes:
| Método | Ideal para | Como funciona |
|---|---|---|
| OpenGoat UI | Principiantes — interface visual | Painel no browser, clica para selecionar o agente e escreve a tua mensagem |
| Terminal do VS Code | Recomendado — mais rápido, mais controlo | openclaw agent --agent [id] "a tua mensagem" |
Os dois métodos funcionam. Começa pelo que te parecer mais confortável.
Abordagem recomendada — híbrida com IA: Quando estás a começar, mantém o teu chat de IA aberto enquanto trabalhas com os teus agentes. Se um comando não funcionar ou não souberes o que escrever, descreve a situação à IA e pede ajuda. É exatamente assim que a maioria das pessoas — incluindo a equipa do BALIA OS — trabalhou no início. Não precisas de dominar o terminal logo no primeiro dia. A janela de chat com a IA está sempre disponível como o teu copiloto.
Como Funciona Esta Secção
Cola o prompt abaixo no teu chat de IA. A IA vai guiar-te no registo dos 6 agentes e no envio do primeiro comando a cada um. Anexa o teu Documento de Design de Equipa para que a IA conheça os IDs dos teus agentes e os caminhos do workspace.
Se algo correr mal, descreve o erro ou tira uma captura de ecrã e partilha-a — a IA vai ajudar-te a resolver.
▶ Cola isto no teu AI para começar
Anexa o teu Documento de Design de Equipa antes de enviares.
Estás a ajudar-me a registar e lançar a minha equipa multi-agente do BALIA OS
no OpenClaw.
Anexei o meu Documento de Design de Equipa. Lê-o primeiro para obteres
os IDs e nomes dos meus agentes.
Antes de começarmos, pergunta-me:
"Qual é o teu nome de utilizador do Windows? (O nome em C:\Users\[nomedeutilizador])"
Usa esse nome de utilizador em todos os caminhos de ficheiros ao longo desta sessão.
Todos os meus ficheiros de agentes estão em $env:USERPROFILE/.opengoat/
Guia-me passo a passo. Um passo de cada vez. Se eu encontrar um erro,
ajuda-me a corrigi-lo antes de continuarmos. Se eu ficar preso, pede-me
para partilhar uma captura de ecrã ou colar a mensagem de erro.
Aqui está o que precisamos de fazer:
PASSO 1 — Iniciar o gateway
Diz-me: "Vamos iniciar o gateway do OpenClaw com um comando que filtra
os logs barulhentos em segundo plano para que o terminal fique legível."
Guia-me a abrir um novo separador de terminal do VS Code e a executar o
comando correto para o meu SO (pergunta-me qual é, se ainda não souberes):
Windows:
$env:DEBUG="-ciao*"; openclaw gateway --force
Mac:
DEBUG="-ciao*" openclaw gateway --force
Explica o que isto faz:
"A parte DEBUG='-ciao*' oculta os logs de descoberta de rede em segundo
plano que, de outra forma, encheriam o terminal. A flag --force limpa
qualquer instância anterior do gateway. O teu terminal vai ficar limpo e legível."
Pede-me para confirmar que vejo: "✓ Gateway running on port 18789"
Diz-me para deixar este separador aberto — o gateway tem de continuar a correr.
Se houver um erro, ajuda-me a corrigi-lo antes de continuarmos.
PASSO 2 — Registar cada agente no OpenClaw
Explica isto primeiro:
"Executar este comando faz duas coisas: regista o agente no OpenClaw,
e gera automaticamente o config.json e o models.json desse agente em
agents/[agentid]/. Não precisas de criar estes ficheiros manualmente."
Para cada um dos meus 6 agentes (IDs lidos do Documento de Design de Equipa),
guia-me a executar este comando no terminal do VS Code:
Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]
Mac:
openclaw agents add [agentid] --workspace ~/.opengoat/workspaces/[agentid]
Exemplo (Windows): openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
(marcus é apenas um exemplo — substitui pelos IDs reais dos teus agentes
do teu Documento de Design de Equipa.)
Mostra-me os 6 comandos de uma vez, com os IDs reais dos meus agentes e
o meu nome de utilizador preenchidos.
Pede-me para os executar um a um, confirmando cada sucesso antes de
mostrares o próximo.
Depois de os 6 estarem registados, guia-me a verificar:
openclaw agents list
Pede-me para confirmar que os 6 agentes aparecem na lista.
PASSO 2b — Verificar o registo do Guardião de Segurança
O Guardião de Segurança já foi registado no OpenClaw na Secção 4.
Guia-me a verificar a sua presença:
openclaw agents list
Pede-me para confirmar que security-guardian aparece na lista.
Se estiver em falta, guia-me a executar:
Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian
Mac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian
Depois verifica a lista novamente antes de continuarmos.
PASSO 3 — Reiniciar o gateway
Depois de registar os agentes, o gateway precisa de reiniciar para os carregar.
Guia-me a executar:
openclaw gateway restart
Pede-me para confirmar que o gateway está novamente em execução antes de continuarmos.
PASSO 4 — Iniciar o Guardião de Segurança (PM2)
O Guardião de Segurança funciona continuamente em segundo plano através do PM2.
Guia-me a iniciá-lo:
pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian
(Mac: substitui o caminho por ~/.opengoat/workspaces/security-guardian/scripts/guardian.js)
Depois guarda a lista de processos do PM2 para que reinicie automaticamente
depois de reiniciares o sistema:
pm2 save
Pede-me para confirmar que vejo o Guardião de Segurança na lista do PM2:
pm2 list
Depois pede-me para confirmar que vejo uma mensagem de arranque no canal
do Discord #security-channel.
PASSO 5 — Enviar o primeiro comando via terminal do VS Code (recomendado)
Explica isto primeiro:
"O terminal do VS Code é a forma recomendada de falar com os teus agentes.
O comando é:
openclaw agent --agent [agentid] 'a tua mensagem aqui'
Isto envia uma mensagem diretamente para esse agente específico."
Guia-me a enviar um comando de teste ao primeiro agente:
openclaw agent --agent [primeiro-agentid] 'Por favor, apresenta-te e
confirma que leste o teu SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md e USER.md.
Depois reporta no teu canal do Discord que estás online.'
Pergunta-me: "O que respondeu o agente?
Viste uma mensagem aparecer no canal do Discord dele?"
Se sim: ótimo — avança para o próximo agente.
Se não: ajuda-me a resolver.
Repete para os 6 agentes.
PASSO 6 — (Opcional) Configuração do OpenGoat UI
Depois de todos os agentes estarem confirmados a funcionar via terminal, propõe:
"Também podes falar com os teus agentes através do OpenGoat UI —
um painel visual no browser.
Queres configurá-lo também?
Dá-te uma interface clicável para selecionar agentes e enviar mensagens
sem escrever comandos no terminal."
Se sim: guia-me a:
1. Abrir um novo separador de terminal do VS Code
2. Executar: opengoat start
3. O browser vai abrir automaticamente com o OpenGoat UI
Explica-me a interface — como selecionar um agente e enviar uma mensagem.
(Se o browser não abrir automaticamente, vai a http://localhost:19123)
Se não: salta e avança para o Passo 7.
PASSO 7 — Confirmação final
Revê esta checklist comigo:
□ Todos os 6 agentes registados (openclaw agents list mostra os 6)
□ Guardião de Segurança registado (security-guardian aparece na lista)
□ Guardião de Segurança em execução no PM2 (pm2 list mostra online)
□ Gateway em execução (porta 18789)
□ Cada agente respondeu ao primeiro comando
□ Cada agente publicou no seu canal do Discord
□ (Opcional) OpenGoat UI acessível em localhost:19123
PASSO 8 — Gerar o CLAUDE.md
Assim que os 6 agentes (incluindo o Guardião de Segurança) estiverem
confirmados como registados e em execução, guia-me a gerar o CLAUDE.md —
o ficheiro de instruções que o Claude Code lê automaticamente no início
de cada sessão:
"Agora vamos gerar o teu CLAUDE.md. É criado automaticamente a partir da
configuração da equipa que já concluíste, por isso não precisas de
preencher nada manualmente."
Windows:
cd $env:USERPROFILE\.opengoat\workspaces\security-guardian
node generate_claude_md.js
Mac:
cd ~/.opengoat/workspaces/security-guardian
node generate_claude_md.js
Pede-me para confirmar que vejo uma mensagem a terminar com algo como:
[OK] CLAUDE.md generated: (o teu caminho)\.opengoat\CLAUDE.md
Se já existir um CLAUDE.md, o script faz automaticamente uma cópia de
segurança primeiro e depois pergunta se deve sobrescrevê-lo. "yes"
sobrescreve-o (a cópia de segurança já foi guardada); "no" guarda o
novo conteúdo como CLAUDE_generated_draft.md, deixando o CLAUDE.md
existente completamente intacto.
Se me perguntar qual é o meu nível adquirido (T1 / T2 / T3), guia-me
a indicar o meu nível real.
Depois de gerado, pede-me para abrir
$env:USERPROFILE\.opengoat\CLAUDE.md e confirmar que os nomes e as
funções da equipa estão corretos.
Quando todas as caixas estiverem marcadas, diz:
"A tua equipa BALIA OS está no ar. Os 6 agentes estão em execução e a
reportar ao Discord. Estás pronto para a Secção 6 — Construir a Tua
Primeira Cassete de Skills."
Começa agora. Faz-me a primeira pergunta.Sobre o CLAUDE.md
O ficheiro CLAUDE.md gerado no PASSO 8 é um ficheiro de instruções que o Claude Code no VS Code lê automaticamente no início de cada sessão. É gerado nesta fase — logo depois de confirmares que todos os agentes estão registados e em execução — diretamente em $env:USERPROFILE.opengoat.
O que é incluído automaticamente:
- Uma tabela de composição da equipa (nomes e funções dos 6 agentes)
- A proibição absoluta de operações destrutivas (confirmação obrigatória antes de eliminar/sobrescrever ficheiros, etc.)
- O tratamento de informação sensível (sem apresentar em texto simples chaves de API, webhooks, etc.)
- As regras de idioma de saída
Personalizar: Tudo o que está abaixo da secção ## Sinta-se à vontade para personalizar tudo a partir desta linha, no final do ficheiro, é teu para editares — adiciona regras específicas do projeto, comandos comuns, ou qualquer outra coisa útil.
As duas secções perto do topo — ## Proibição Absoluta de Operações Destrutivas (Crítico — Seguir Sempre — Não Eliminar) e ## Tratamento de Informação Sensível (Não Eliminar) — são regras de segurança essenciais. Aparecem no idioma selecionado (disponível em 20 idiomas). Não elimines nem alteres estas duas secções.
Se já existir um CLAUDE.md: Executar o PASSO 8 nunca sobrescreve silenciosamente um CLAUDE.md existente. O script faz automaticamente uma cópia de segurança primeiro e depois pergunta se deve sobrescrevê-lo. Responde "no" e o ficheiro existente fica completamente intacto — o novo conteúdo gerado é guardado à parte como CLAUDE_generated_draft.md.
Falar com os Teus Agentes no Dia a Dia
Assim que tudo estiver configurado, eis como dar comandos:
Inicia o gateway (faz isto primeiro, em cada sessão):
Windows:
$env:DEBUG="-ciao*"; openclaw gateway --forceMac:
DEBUG="-ciao*" openclaw gateway --forceDeixa este separador do terminal em execução. Abre um separador novo para outros comandos.
Via terminal do VS Code:
# Fala com um agente específico
openclaw agent --agent marcus "Summarize what you worked on today"
# Verifica a lista de agentes
openclaw agents list
# Reinicia o gateway se necessário
openclaw gateway restart
marcusé um exemplo — substitui pelo ID do teu próprio agente (ex.--agent ceoou--agent nova).
Via OpenGoat UI:
- Abre um novo separador de terminal do VS Code
- Executa:
opengoat start - O browser abre automaticamente com o OpenGoat UI
- Seleciona o agente no painel esquerdo
- Escreve a tua mensagem e prime Enter (Se o browser não abrir automaticamente: vai a http://localhost:19123)
Via Discord (apenas relatórios — não para comandos): O Discord é onde os teus agentes publicam os seus relatórios. Lês as atualizações deles aqui. Enviar comandos aos agentes via Discord requer um Bot do Discord — trata-se de uma configuração avançada não abrangida no T1. Por agora, usa o terminal do VS Code ou o OpenGoat UI para dares comandos.
Se um Agente Não Responder
Verifica por esta ordem:
O gateway está em execução?
openclaw gateway restartO agente está registado?
openclaw agents listSe o teu agente não aparecer na lista, executa novamente o comando
agents adddo Passo 2.Os ficheiros de workspace estão no local correto?
Verifica se SOUL.md, AGENTS.md e IDENTITY.md existem em:
Windows:
$env:USERPROFILE\.opengoat\workspaces\[agentid]\Mac:
~/.opengoat/workspaces/[agentid]/A chave de API está configurada corretamente? Abre o
.env(na tua pasta.opengoat) e confirma queANTHROPIC_API_KEYestá preenchida.
Se continuares sem conseguir resolver, cola a mensagem de erro no teu chat de IA e pede ajuda.
Verifica a Tua Configuração
Assim que todos os agentes estiverem confirmados como ativos, executa:
Windows:
node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 5Mac:
node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 5Isto confirma que os 6 agentes estão registados, que o Guardião de Segurança está em execução, e que estás pronto para a Secção 6.