Seção 4: Criando os Arquivos dos seus Agentes

O que Você Está Construindo

Cada agente precisa de um conjunto de arquivos para funcionar corretamente. O OpenClaw lê os arquivos principais automaticamente no início de cada sessão. Outros arquivos de workspace fornecem a cada agente contexto, tarefas fixas e regras de ferramentas.

Configuração do agente — gerada automaticamente pelo OpenClaw, você não cria isto aqui:

Arquivo	Localização	Finalidade
`config.json`	`agents/[id]/config.json`	Definição do agente no OpenClaw, system prompt
`models.json`	`agents/[id]/models.json`	Configurações do modelo de IA

Você não cria esses arquivos na Seção 4. Executar openclaw agents add [id] --workspace ... na Seção 5 gera ambos automaticamente ao registrar cada agente — não há nada a fazer aqui além de saber que eles existem.

Arquivos de workspace — carregados automaticamente pelo OpenClaw a cada sessão:

Arquivo	Finalidade
`SOUL.md`	Personalidade, tom, limites rígidos, missão — mantenha abaixo de 400 palavras
`AGENTS.md`	Regras de operação, procedimentos de reporte — mantenha abaixo de 400 palavras
`IDENTITY.md`	Nome, função, a quem reporta — apenas fatos, mantenha curto
`HEARTBEAT.md`	Tarefas fixas, trabalhos periódicos, resposta a anomalias
`TOOLS.md`	Ferramentas permitidas, regras de skills, ações proibidas
`USER.md`	Preferências do Comandante, estilo de comunicação, fuso horário

Arquivo de detalhe da função — lido uma vez por sessão via instrução do AGENTS.md:

Arquivo	Finalidade
`SPEC_[NOME].md`	Função detalhada, responsabilidades, caminhos-chave

CEO somente — pasta de identidade:

Arquivo	Finalidade
`identity/COMPANY_PROFILE.md`	Histórico da empresa, detalhes do negócio
`identity/PERSONAL_PROFILE.md`	Histórico do proprietário, habilidades, experiência
`identity/VALUES.md`	Estilo de pensamento, valores, princípios de decisão

Estrutura completa do workspace — todos os agentes:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← gerado automaticamente na Seção 5 │ └── models.json ← gerado automaticamente na Seção 5 └── workspaces/ └── [agentid]/ ├── SOUL.md ← carregado automaticamente ├── AGENTS.md ← carregado automaticamente ├── IDENTITY.md ← carregado automaticamente ├── HEARTBEAT.md ← carregado automaticamente ├── TOOLS.md ← carregado automaticamente ├── USER.md ← carregado automaticamente └── SPEC_[NAME].md ← lido via instrução do AGENTS.md

Workspace do CEO — pasta de identidade adicional:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

Como Funciona a Seção 4

Nesta seção, você trabalhará com seu AI concierge para projetar cada agente. Para cada agente, você decidirá:

Nome e função
Personalidade e estilo de comunicação
Quais ferramentas ele pode usar

Após finalizar o design com seu AI concierge, seu Guardião de Segurança escreverá os arquivos de configuração automaticamente. Você não precisa editar nenhum arquivo manualmente.

Como Esta Seção Funciona — Duas Partes

Esta seção tem duas partes. Complete-as em ordem:

Parte 1 — Configuração do Discord (o prompt abaixo) Crie seu servidor Discord, canais e obtenha as URLs de Webhook para cada agente. Isso leva cerca de 10 minutos.

Parte 2 — Arquivos de Agente (o próximo prompt) Gere os arquivos de agente reais usando seu Documento de Design de Equipe. A IA gera comandos de terminal — cole-os no VS Code para criar os arquivos automaticamente.

Comece com a Parte 1 agora.

URLs de Webhook do Discord — Obtenha Primeiro

Cada agente reporta ao seu próprio canal do Discord via uma URL de Webhook. Você precisa dessas URLs antes de escrever os arquivos AGENTS.md.

▶ Cole isto em seu IA para começar

Anexe seu Documento de Design da Equipe antes de enviar.

Você está me ajudando a configurar os canais do Discord e as URLs de Webhook
para minha equipe multi-agente do BALIA OS.

Me guie passo a passo. Faça uma pergunta de cada vez.
Se eu travar, peça-me para tirar uma captura de tela e descrever o que vejo.

Eu anexei meu Documento de Design da Equipe.

PASSO 1 — Verificar o Discord
Pergunte: "Você tem o Discord instalado e uma conta configurada?"
Se não: me guie para discord.com para baixar e criar uma conta.
Se sim: vá para o Passo 2.

PASSO 2 — Criar um servidor do Discord
Me guie para criar um novo servidor:
- Clique no botão + na barra lateral esquerda
- Selecione "Criar o Meu" -> "Para mim e meus amigos"
- Nomeie como "BALIA OS Team"
Confirme que eu consigo vê-lo antes de continuar.

PASSO 3 — Criar canais para cada agente
Leia meu Documento de Design da Equipe para os nomes dos canais.
Para cada agente, crie um canal de texto:
- Clique com o botão direito em "Canais de Texto" -> Adicionar Canal -> Texto
- Use o nome do canal do meu Documento de Design da Equipe
Repita para os 6 agentes. Confirme que todos os canais existem antes de continuar.

PASSO 4 — Obter uma URL de Webhook para cada canal
Um canal de cada vez:
1. Clique com o botão direito no canal -> Editar Canal
2. Integrações -> Webhooks -> Novo Webhook
3. Nomeie com o nome do agente (ex. "Marcus")
4. Copie a URL do Webhook
5. Peça-me para colar em um lugar seguro
Repita para os 6. Confirme que as 6 URLs estão salvas antes de continuar.

PASSO 5 — Adicionar ao arquivo .env
Me guie para abrir o arquivo .env no VS Code.
O arquivo está em:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Adicione cada webhook:
DISCORD_WEBHOOK_[NOMEAGENTE]=https://discord.com/api/webhooks/xxxxx/xxxxx
(nomes de agentes em MAIÚSCULAS)
Diga-me: "Nunca compartilhe este arquivo. Nunca faça commit no GitHub."

Quando todos os webhooks estiverem salvos: "Configuração do Discord concluída."

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

Usando o Prompt de IA

Cole o prompt abaixo no seu chat de IA e anexe:

Seu Documento de Design da Equipe da Seção 2

A IA gera comandos de terminal para cada agente, um de cada vez. Cole os comandos no seu terminal do VS Code para criar os arquivos automaticamente.

▶ Cole isto em seu IA para começar

Você está me ajudando a criar arquivos de agentes para o BALIA OS,
um sistema operacional de IA multi-agente construído sobre o OpenClaw.

Anexo:
1. Meu Documento de Design da Equipe (da Seção 2)

Leia antes de gerar qualquer coisa.
Extraia todos os nomes de agentes, IDs e nomes de canais do Discord deste documento.

ARQUITETURA:

1. Eu sou o Comandante. Eu comando cada agente diretamente. Sem orquestrador.

2. Cada agente tem dois locais:
   - agents/[id]/ — configuração do OpenClaw (config.json + models.json)
   - workspaces/[id]/ — arquivos de workspace (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC)
   Todos os caminhos ficam dentro de $env:USERPROFILE/.opengoat/

3. O OpenClaw auto-injeta SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
   TOOLS.md, USER.md a cada início de sessão. Não escreva instruções
   "leia a si mesmo" neles.

4. SPEC_[NOME].md NÃO é auto-injetado. Adicione ao "Início de Sessão" do AGENTS.md:
   "Ler SPEC_[NOMEAGENTE].md para detalhes completos do papel"

5. Somente o CEO tem uma pasta identity/ dentro de workspaces/ceo/:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   Gere estes arquivos apenas para o agente CEO.

6. SOUL.md e AGENTS.md: menos de 400 palavras cada (injetados a cada sessão).
   SPEC: pode ser detalhado (lido uma vez por sessão).

ANTES DE GERAR — pergunte-me:
"Qual é o seu nome de usuário do Windows? (O nome em C:\Users\[nomedeusuario])"
Aguarde minha resposta, depois use esse nome de usuário em todos os caminhos de arquivo.

GERAR PARA CADA AGENTE:

====================================
ARQUIVO 1: SOUL.md
Caminho: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Auto-injetado a cada sessão. Menos de 400 palavras.
====================================

# SOUL.md — [Nome do Agente]

## Quem Você É
[2-3 frases: identidade, personalidade, abordagem de trabalho]

## Tom
- [Regra 1]
- [Regra 2]
- [Regra 3]
- [Estilo proibido]

## Limites Absolutos
- Nunca agir fora do papel definido
- Nunca reportar completo sem verificar o resultado
- Nunca tomar ação destrutiva sem aprovação do Comandante
- [1-2 limites específicos do papel]

## Missão Atual
[1-2 frases sobre o foco atual]

====================================
ARQUIVO 2: AGENTS.md
Caminho: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Auto-injetado a cada sessão. Menos de 400 palavras.
====================================

# AGENTS.md — Procedimentos de Operação de [Nome do Agente]

## Início de Sessão (Cada sessão — nesta ordem)
1. Confirmar identidade a partir do SOUL.md
2. Ler SPEC_[NOMEAGENTE].md para detalhes do papel
3. Ler HEARTBEAT.md — anotar tarefas fixas
4. Ler TOOLS.md — anotar ferramentas permitidas e restrições
5. Ler USER.md — anotar preferências do Comandante
6. Reportar no Discord: "🔷 [Nome] pronto. [tarefa ou status atual]"

(Somente CEO — após o passo 2, também ler:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## Fim de Sessão (Cada sessão)
1. Reportar no Discord: "✅ [Nome] sessão completa. [resumo]"
2. Anotar tarefas não concluídas para a próxima sessão

## Relatórios
- Canal: #[canal-discord]
- Comando: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[NOME] "mensagem"
  (discord_send.py é implantado automaticamente na seção "Implantar o Guardião
  de Segurança" abaixo)
- HTTP 204 = sucesso. Caso contrário = reportar falha imediatamente.
- Formato: Conclusão -> Detalhe -> Próxima ação recomendada
- Reportar em: início de sessão / tarefa completa / erro / fim de sessão

## Tratamento de Erros
1. Verificar SPEC_[NOME].md para padrões de erro conhecidos
2. Não resolvido -> reportar detalhes completos ao Comandante
3. Sem tentativas destrutivas sem aprovação do Comandante

## Regras Absolutas
- Verificar antes de reportar completo
- Sem ações fora do papel definido
- Sem operações destrutivas sem aprovação do Comandante

====================================
ARQUIVO 3: IDENTITY.md
Caminho: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Auto-injetado. Somente fatos, mantenha curto.
====================================

# IDENTITY.md

Name: [Nome do Agente]
Agent ID: [agentid-minúsculas]
Role: [Título do Papel]
Department: BALIA OS Team
Reports To: Commander (directly)
Discord: #[nome do canal]

====================================
ARQUIVO 4: HEARTBEAT.md
Caminho: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Auto-injetado. Tarefas fixas e resposta a anomalias.
====================================

# HEARTBEAT.md — [Nome do Agente]

## Sempre Ativo
[O que este agente monitora ou mantém continuamente]

## Tarefas Periódicas
[Obrigações recorrentes — diárias, semanais, ou acionadas por gatilho]

## No Início de Sessão
- Ler SOUL.md e AGENTS.md
- Reportar: "🔷 [Nome] pronto"

## Em Caso de Erro ou Anomalia
- Reportar imediatamente ao Comandante via Discord
- Nunca se autocorrigir sem aprovação do Comandante

====================================
ARQUIVO 5: TOOLS.md
Caminho: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Auto-injetado. Regras e restrições de ferramentas.
====================================

# TOOLS.md — Regras de Ferramentas de [Nome do Agente]

## Princípio Central
- Verificar SPEC_[NOME].md antes de cada tarefa para ferramentas permitidas
- Carregar apenas o que a tarefa exigir

## Ferramentas Permitidas
[Listar ferramentas relevantes para o papel deste agente]

## Relatórios no Discord
Sempre usar diretamente o discord_send.py:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[NOME] "mensagem"
Confirmar HTTP 204 após enviar.

## Proibido
- Codificar chaves de API ou Webhooks diretamente (sempre ler do .env)
- Ações fora do papel definido
- Comunicação externa desnecessária

====================================
ARQUIVO 6: USER.md
Caminho: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Auto-injetado. Preferências do Comandante.
====================================

# USER.md — Perfil do Comandante

## Nome
[Nome de preferência do Comandante]

## Fuso Horário
[Fuso horário — pergunte-me se não estiver no Documento de Design de Equipe]

## Estilo de Comunicação
- [Preferência 1]
- [Preferência 2]

## Fase Atual
[No que estamos focados construindo agora]

====================================
ARQUIVO 7: SPEC_[NOMEAGENTE].md
Caminho: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[NOMEAGENTE].md
Não auto-injetado. Lido uma vez por sessão via AGENTS.md.
====================================

# SPEC_[NOMEAGENTE] v1.0 — [Nome do Agente] ([Papel])
Última atualização: [hoje]

## 1. Papel
[2-3 frases]

## 2. Responsabilidades
[Lista de pontos do Documento de Design da Equipe]

## 3. O que Este Agente NÃO Faz
[Limites claros]

## 4. Missão da Fase Atual
[Foco atual]

## 5. Caminhos-Chave
- Workspace: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhook: DISCORD_WEBHOOK_[NOME] (lido do .env)

## 6. Registro de Alterações
| Versão | Data | Alterações |
|---------|------|---------|
| v1.0 | [hoje] | Criação inicial |

====================================
SOMENTE CEO — ARQUIVOS 8, 9, 10: pasta identity/
Faça estas 3 perguntas uma por uma antes de gerar.
====================================

Q1: "Fale-me sobre seu negócio — o que faz, há quanto tempo
    está em operação, que mercados atende."

Q2: "Fale-me sobre você — experiência, habilidades, formação
    relevantes para este negócio."

Q3: "Como você toma decisões? Que valores te guiam?
    Que estilos de pensamento ou perspectivas você gostaria de ter mais?"

Após as 3 respostas, gerar:

COMPANY_PROFILE.md — conteúdo da Q1, estruturado
PERSONAL_PROFILE.md — conteúdo da Q2, estruturado
VALUES.md — conteúdo da Q3, estruturado

Caminho: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

Quanto mais detalhes forem fornecidos aqui, mais o CEO pensa e
decide como o proprietário.

====================================

COMO ENTREGAR OS ARQUIVOS:

Após gerar o conteúdo de cada arquivo, gere o comando python exato
para criá-lo. Formato:

--- COLE NO TERMINAL (Windows) ---
python -c "
content = '''[conteúdo completo do arquivo aqui]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- COLE NO TERMINAL (Mac) ---
python3 -c "
content = '''[conteúdo completo do arquivo aqui]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

Aguarde eu colar o comando e confirmar que rodou antes de passar
para o próximo arquivo. Pergunte: "Você viu 'Created: [caminho]'?"

COMO PROCEDER:
- Comece com o Agente #1 (não o CEO)
- Gere um arquivo de cada vez, um agente de cada vez
- Sempre aguarde a confirmação do terminal antes do próximo arquivo
- Ao chegar ao CEO: faça primeiro as 3 perguntas de identidade,
  depois gere os 7 arquivos principais + 3 arquivos de identidade
- Termine com uma tabela de resumo de todos os arquivos criados

Assim que seu AI concierge confirmar o design, peça ao Guardião de Segurança que escreva os arquivos:

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

O Guardian confirmará quando os arquivos estiverem escritos corretamente.

Passo 2 — Confirme que os Arquivos Foram Criados

Depois que a IA te guiar por todos os arquivos, confirme o workspace de cada agente:

Windows:

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

Mac:

ls ~/.opengoat/workspaces/[agentid]

Você deve ver:

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[NAME].md

O CEO adicionalmente terá:

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

Passo 3 — Verifique Antes de Passar para o Próximo Agente

Abra o AGENTS.md. A seção "Início de Sessão" lista todos os passos, incluindo HEARTBEAT.md, TOOLS.md e USER.md?

Sim -> avance. Não -> peça à IA para corrigir primeiro.

Quando Esta Seção Estiver Completa

O workspace de cada agente:

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[NAME].md ✅

O CEO adicionalmente terá:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

Nota: O Guardião de Segurança foi implantado na Seção 3. Se você pulou a Seção 3, volte e conclua antes de continuar para a Seção 5.

Verifique sua Configuração

Depois de concluir todos os arquivos de agentes, execute:

Windows:

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

Mac:

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

Isso confirma que todos os arquivos de agentes estão prontos antes de você lançar sua equipe na Seção 5.

O que Você Está Construindo ​

Como Funciona a Seção 4 ​

Como Esta Seção Funciona — Duas Partes ​

URLs de Webhook do Discord — Obtenha Primeiro ​

▶ Cole isto em seu IA para começar

Usando o Prompt de IA ​

▶ Cole isto em seu IA para começar

Passo 2 — Confirme que os Arquivos Foram Criados ​

Passo 3 — Verifique Antes de Passar para o Próximo Agente ​

Quando Esta Seção Estiver Completa ​

Verifique sua Configuração ​

O que Você Está Construindo

Como Funciona a Seção 4

Como Esta Seção Funciona — Duas Partes

URLs de Webhook do Discord — Obtenha Primeiro

Usando o Prompt de IA

Passo 2 — Confirme que os Arquivos Foram Criados

Passo 3 — Verifique Antes de Passar para o Próximo Agente

Quando Esta Seção Estiver Completa

Verifique sua Configuração