O Que Acontece Nesta Seção

Você vai registrar cada agente no OpenClaw e dar a eles o primeiro comando. Ao final, todos os 6 agentes estarão ativos — reportando para seus canais no Discord e prontos para receber suas instruções.

Duas formas de falar com seus agentes:

Método	Melhor para	Como funciona
OpenGoat UI	Iniciantes — interface visual	Painel no navegador, clique para selecionar o agente e digite sua mensagem
Terminal do VS Code	Recomendado — mais rápido e com mais controle	openclaw agent --agent [id] "sua mensagem"

Ambos os métodos funcionam. Comece com o que parecer mais confortável.

Abordagem recomendada — híbrida com IA: No início, mantenha seu chat de IA aberto enquanto trabalha com seus agentes. Se um comando não funcionar ou você não souber o que digitar, apenas descreva a situação para a IA e peça ajuda. É exatamente assim que a maioria das pessoas — incluindo a equipe do BALIA OS — trabalhou no começo. Você não precisa dominar o terminal logo de cara. A janela de chat com a IA está sempre disponível como seu copiloto.

---

Como Esta Seção Funciona

Cole o prompt abaixo no seu chat de IA. A IA vai guiá-lo pelo processo de registrar todos os 6 agentes e enviar o primeiro comando para cada um. Anexe seu Documento de Design da Equipe para que a IA conheça seus IDs de agentes e caminhos de workspace.

Se algo der errado, descreva o erro ou tire um print e compartilhe — a IA vai ajudá-lo a resolver.

---

▶ Cole isto em seu IA para começar

Anexe seu Documento de Design da Equipe antes de enviar.

Você está me ajudando a registrar e lançar minha equipe multi-agente do BALIA OS
no OpenClaw.

Eu anexei meu Documento de Design da Equipe. Leia-o para obter meus IDs de agentes
e nomes antes de começar.

Antes de começarmos, me pergunte:
"Qual é o seu nome de usuário do Windows? (O nome em C:\Users\[nomedeusuario])"
Use esse nome de usuário em todos os caminhos de arquivo durante esta sessão.
Todos os meus arquivos de agentes estão em $env:USERPROFILE/.opengoat/

Guie-me passo a passo. Um passo de cada vez. Se eu encontrar um erro,
me ajude a corrigi-lo antes de continuar. Se eu travar, peça-me para
compartilhar um print ou colar a mensagem de erro.

Aqui está o que precisamos fazer:

PASSO 1 — Iniciar o gateway
Diga-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."

Guie-me para abrir uma nova aba de terminal do VS Code e executar o comando
correto para o meu SO (pergunte qual SO eu uso, se ainda não souber):

Windows:
  $env:DEBUG="-ciao*"; openclaw gateway --force

Mac:
  DEBUG="-ciao*" openclaw gateway --force

Explique o que isso faz:
"A parte DEBUG='-ciao*' oculta os logs de descoberta de rede em segundo plano
que, do contrário, encheriam o terminal. A flag --force limpa qualquer instância
anterior do gateway. Seu terminal ficará limpo e legível."

Peça-me confirmar que vejo: "✓ Gateway running on port 18789"
Diga-me para deixar esta aba de terminal aberta — o gateway precisa continuar rodando.
Se houver um erro, me ajude a corrigi-lo antes de continuar.

PASSO 2 — Registrar cada agente no OpenClaw
Explique isto primeiro:
"Executar este comando faz duas coisas: registra o agente no OpenClaw,
e gera automaticamente o config.json e o models.json do agente em
agents/[agentid]/. Você não precisa criar esses arquivos manualmente."

Para cada um dos meus 6 agentes (IDs lidos do Documento de Design da Equipe),
guie-me para 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 — substitua pelos IDs reais dos seus agentes
do seu Documento de Design da Equipe.)

Mostre-me os 6 comandos de uma vez com meus IDs de agentes reais e nome
de usuário preenchidos.
Peça-me para executá-los um por um, confirmando cada sucesso antes de
mostrar o próximo.

Depois que os 6 estiverem registrados, guie-me para verificar:
openclaw agents list
Peça-me confirmar que todos os 6 agentes aparecem na lista.

PASSO 2b — Verificar o registro do Guardião de Segurança
O Guardião de Segurança já foi registrado no OpenClaw na Seção 4.
Guie-me para verificar sua presença:

openclaw agents list

Peça-me para confirmar que security-guardian aparece na lista.
Se estiver faltando, guie-me para 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 verifique a lista novamente antes de continuar.

PASSO 3 — Reiniciar o gateway
Depois de registrar os agentes, o gateway precisa reiniciar para carregá-los.
Guie-me para executar:
openclaw gateway restart
Peça-me confirmar que o gateway está rodando novamente antes de continuar.

PASSO 4 — Iniciar o Guardião de Segurança (PM2)
O Guardião de Segurança roda continuamente em segundo plano usando o PM2.
Guie-me para iniciá-lo:

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian

(Mac: substitua o caminho por ~/.opengoat/workspaces/security-guardian/scripts/guardian.js)

Em seguida, salve a lista de processos do PM2 para que ele reinicie automaticamente
após reiniciar o sistema:
pm2 save

Peça-me para confirmar que vejo o Guardião de Segurança na lista do PM2:
pm2 list

Depois peça-me para confirmar que vejo uma mensagem de inicialização no
canal #security-channel do Discord.

PASSO 5 — Enviar primeiro comando via terminal do VS Code (recomendado)
Explique isto primeiro:
"O terminal do VS Code é a forma recomendada de falar com seus agentes.
O comando é:
openclaw agent --agent [agentid] 'sua mensagem aqui'

Isso envia uma mensagem diretamente para aquele agente específico."

Guie-me para enviar um comando de teste ao primeiro agente:
openclaw agent --agent [primeiro-agentid] 'Por favor, apresente-se e
confirme que você leu seu SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md e USER.md.
Depois reporte no seu canal do Discord que você está online.'

Pergunte-me: "O que o agente respondeu?
Você viu uma mensagem aparecer no canal do Discord dele?"
Se sim: ótimo — passe para o próximo agente.
Se não: me ajude a resolver.

Repita para os 6 agentes.

PASSO 6 — (Opcional) Configuração do OpenGoat UI
Depois que todos os agentes estiverem confirmados funcionando via terminal, ofereça:
"Você também pode falar com seus agentes através do OpenGoat UI —
um painel visual no navegador.
Gostaria de configurar isso também?
Ele oferece uma interface clicável para selecionar agentes e enviar mensagens
sem digitar comandos no terminal."
Se sim: guie-me para:
1. Abrir uma nova aba de terminal do VS Code
2. Executar: opengoat start
3. O navegador abrirá automaticamente com o OpenGoat UI
Explique-me a interface — como selecionar um agente e enviar uma mensagem.
(Se o navegador não abrir automaticamente, acesse http://localhost:19123)
Se não: pule e vá para o Passo 7.

PASSO 7 — Confirmação final
Revise esta checklist comigo:
□ Todos os 6 agentes registrados (openclaw agents list mostra todos os 6)
□ Guardião de Segurança registrado (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 postou no seu canal do Discord
□ (Opcional) OpenGoat UI acessível em localhost:19123

PASSO 8 — Gerar o CLAUDE.md
Depois que todos os 6 agentes (incluindo o Guardião de Segurança) estiverem
confirmados como registrados e em execução, guie-me para gerar o CLAUDE.md —
o arquivo de instruções que o Claude Code lê automaticamente no início de
cada sessão:

"Agora vamos gerar seu CLAUDE.md. Ele é criado automaticamente a partir da
configuração da equipe que você já concluiu, então você não precisa 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

Peça-me para confirmar que vejo uma mensagem terminando com algo como:
[OK] CLAUDE.md generated: (seu caminho)\.opengoat\CLAUDE.md

Se um CLAUDE.md já existir, o script faz automaticamente um backup primeiro,
depois pergunta se deseja sobrescrevê-lo. "yes" sobrescreve (o backup já foi
salvo); "no" salva o novo conteúdo como CLAUDE_generated_draft.md, deixando
o CLAUDE.md existente completamente intocado.

Se me perguntarem qual é o meu tier adquirido (T1 / T2 / T3), guie-me para
informar meu tier real.

Depois de gerado, peça-me para abrir
$env:USERPROFILE\.opengoat\CLAUDE.md e confirmar que os nomes e papéis
da equipe estão corretos.

Quando todas as caixas estiverem marcadas, diga:
"Sua equipe do BALIA OS está no ar. Todos os 6 agentes estão funcionando e
reportando ao Discord. Você está pronto para a Seção 6 — Construindo seu
Primeiro Cassete de Habilidades."

Comece agora. Faça-me a primeira pergunta.

---

Sobre o CLAUDE.md

O arquivo CLAUDE.md gerado no PASSO 8 é um arquivo de instruções que o Claude Code no VS Code lê automaticamente no início de cada sessão. Ele é gerado neste momento — logo após a confirmação de que todos os agentes estão registrados e em execução — diretamente em $env:USERPROFILE.opengoat.

O que é incluído automaticamente:

• Uma tabela de composição da equipe (nomes e papéis dos 6 agentes)
• A proibição absoluta de operações destrutivas (confirmação necessária antes de excluir/sobrescrever arquivos, etc.)
• O tratamento de informações sensíveis (sem exibir chaves de API, webhooks, etc. em texto simples)
• As regras de idioma de saída

Personalizando: Tudo abaixo da seção ## Sinta-se à vontade para personalizar tudo abaixo desta linha, no final do arquivo, é seu para editar — adicione regras específicas do projeto, comandos comuns ou qualquer outra coisa útil.

As duas seções próximas ao topo — ## Proibição Absoluta de Operações Destrutivas (Crítico — Sempre Seguir — Não Excluir) e ## Tratamento de Informações Sensíveis (Não Excluir) — são regras essenciais de segurança. Elas aparecem no idioma selecionado (disponível em 20 idiomas). Não exclua nem modifique essas duas seções.

Se um CLAUDE.md já existir: Executar o PASSO 8 nunca sobrescreve silenciosamente um CLAUDE.md existente. O script faz automaticamente um backup primeiro e depois pergunta se deseja sobrescrevê-lo. Responda "no" e o arquivo existente permanece completamente intocado — o novo conteúdo gerado é salvo separadamente como CLAUDE_generated_draft.md.

---

Falando com Seus Agentes no Dia a Dia

Após tudo configurado, veja como dar comandos:

Inicie o gateway (faça isso primeiro, a cada sessão):

Windows:

$env:DEBUG="-ciao*"; openclaw gateway --force

Mac:

DEBUG="-ciao*" openclaw gateway --force

Deixe esta aba do terminal em execução. Abra uma nova aba para outros comandos.

Via terminal do VS Code:

# Fale com um agente específico
openclaw agent --agent marcus "Summarize what you worked on today"

# Verifique a lista de agentes
openclaw agents list

# Reinicie o gateway se necessário
openclaw gateway restart

marcus é um exemplo — substitua pelo ID do seu próprio agente (ex. --agent ceo ou --agent nova).

Via OpenGoat UI:

1. Abra uma nova aba no terminal do VS Code
2. Execute: opengoat start
3. O navegador abre automaticamente com o OpenGoat UI
4. Selecione o agente no painel à esquerda
5. Digite sua mensagem e pressione Enter (Se o navegador não abrir automaticamente: acesse http://localhost:19123)

Via Discord (apenas relatórios — não para comandos): O Discord é onde seus agentes postam seus relatórios. Você acompanha as atualizações por lá. Enviar comandos para agentes via Discord requer um Bot do Discord — esta é uma configuração avançada que não está coberta no T1. Por enquanto, use o terminal do VS Code ou o OpenGoat UI para enviar comandos.

---

Se um Agente Não Responder

Verifique nesta ordem:

1. O gateway está em execução?

   openclaw gateway restart

2. O agente está registrado?

   openclaw agents list

   Se seu agente não estiver listado, execute novamente o comando agents add do Passo 2.

3. Os arquivos de workspace estão no lugar certo?

   Verifique se SOUL.md, AGENTS.md e IDENTITY.md existem em:

   Windows: $env:USERPROFILE\.opengoat\workspaces\[agentid]\

   Mac: ~/.opengoat/workspaces/[agentid]/

4. A chave de API está configurada corretamente? Abra o .env (na sua pasta .opengoat) e confirme que ANTHROPIC_API_KEY está preenchida.

Se ainda estiver com dificuldades, cole a mensagem de erro no seu chat de IA e peça ajuda.

---

Verifique sua Configuração

Depois que todos os agentes estiverem confirmados como ativos, execute:

Windows:

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 5

Mac:

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 5

Isso confirma que todos os 6 agentes estão registrados, o Guardião de Segurança está em execução, e que você está pronto para a Seção 6.