Skip to content

O Discord É a Sua Camada de Relatórios

Os seus agentes não esperam que pergunte como as coisas estão a correr. Eles reportam.

Cada tarefa que concluem, cada erro que encontram, cada sessão que iniciam — tudo isso flui para o Discord. Esta é a sua janela para o que a sua equipa está a fazer, agora e ao longo do dia.

Na Secção 4, criou canais e URLs de Webhook para cada agente. Esta secção trata de transformar essa configuração inicial num workspace organizado — onde pode entrar todas as manhãs, percorrer os seus canais e saber imediatamente o estado da sua equipa.

O que vai configurar nesta secção:

  • Organização e nomenclatura dos canais
  • Definições de notificações para não ficar sobrecarregado
  • Uma rotina de leitura que demora menos de 5 minutos

Nota importante sobre o âmbito: O Discord é unidirecional para os seus agentes — eles reportam para o Discord, mas não podem receber comandos do Discord sem um Discord Bot. Configurar um Bot para poder escrever comandos diretamente no Discord é uma configuração avançada que não está abrangida no T1. Por agora, dê comandos através do terminal VS Code ou da interface OpenGoat, e leia os relatórios da sua equipa no Discord.


Uma Estrutura de Canais Que Funciona

No final da Secção 4, tinha um canal por agente. Essa é a estrutura de partida correta. Veja como organizá-la para que permaneça legível à medida que a sua equipa cresce.

Disposição recomendada do servidor Discord:

INFO

BALIA OS Team ├── 📋 TEAM OVERVIEW │ └── #announcements ← Pin important updates here │ ├── 🤖 AGENT REPORTS │ ├── #[agent1-channel] ← e.g. #operations │ ├── #[agent2-channel] ← e.g. #marketing │ ├── #[agent3-channel] ← e.g. #finance │ ├── #[agent4-channel] ← e.g. #specialist-a │ ├── #[agent5-channel] ← e.g. #specialist-b │ └── #security ← Agent #6 always reports here │ └── 📁 LOGS └── #errors ← Optional: route error reports here

Não precisa de criar esta estrutura exatamente como está — os nomes dos seus canais vieram da Secção 2. O objetivo é agrupar os canais dos agentes para os poder percorrer de uma só vez.


Como Organizar os Seus Canais

Se os seus canais de agentes estiverem atualmente dispersos no seu servidor Discord, veja como agrupá-los:

Criar uma categoria de canais:

  1. Clique com o botão direito no nome do seu servidor Discord (barra lateral esquerda) → Create Category
  2. Dê-lhe o nome AGENT REPORTS
  3. Arraste cada canal de agente para a categoria

Renomear canais se necessário: Os nomes dos canais foram definidos na Secção 2, durante o design da sua equipa. Se quiser renomear algum agora, clique com o botão direito no canal → Edit Channel → atualize o nome.

Fixar uma mensagem em cada canal: Em cada canal de agente, fixe uma nota com o nome e a função do agente. Isto ajuda-o a recordar de relance quem reporta onde.

Clique com o botão direito em qualquer mensagem → Pin Message Ou crie uma mensagem e fixe-a: 📌 [Nome do Agente] — [Função]. Reports here after each task.


Definições de Notificações

Os seus agentes podem reportar várias vezes por sessão. Se deixar as notificações predefinidas ativas, o Discord irá alertá-lo constantemente. Isto é o oposto do que pretende.

Definições recomendadas por canal:

  1. Clique com o botão direito em cada canal de agente → Notification Settings
  2. Defina como Nothing — ou Only @mentions se quiser ser alertado para avisos críticos

Vai consultar o Discord quando quiser — não porque ele esteja a notificá-lo a cada poucos minutos.

Quando consultar o Discord:

  • De manhã: percorra todos os canais para ver o que cada agente fez durante a noite ou no dia anterior
  • Após dar um comando: volte a verificar para ver o relatório de conclusão
  • Uma vez por dia: reveja o canal #security para verificar eventuais alertas sinalizados

Como Ler os Relatórios da Sua Equipa

Cada agente formata os seus relatórios de forma consistente — configurou isto no AGENTS.md na Secção 4. O formato padrão é:

Conclusão → Detalhe de suporte → Próxima ação recomendada

O que procurar todas as manhãs:

ÍconeSignificado
🔷Agente iniciou uma sessão
Tarefa ou sessão concluída
📦Modo ativo — agente carregou SKILL, WORKFLOW, LIVE_LEDGER, KNOWLEDGE
⚠️Aviso — algo precisa de atenção
Erro — o agente não conseguiu concluir

Se vir um ⚠️ ou ❌, abra a mensagem para ver os detalhes completos e envie ao agente um comando de seguimento através do terminal VS Code ou da interface OpenGoat.


Configuração de Backup no GitHub (Recomendado)

BALIA OS faz backup automaticamente do seu workspace no GitHub a cada 30 minutos via Security Guardian. Isso significa que você pode reverter para qualquer ponto dos últimos 30 minutos se algo der errado.

O que é feito backup:

  • Configurações de agentes (agents/)
  • Memória compartilhada (memory/)
  • Skills (skills/)
  • Scripts (scripts/)
  • Espaços de trabalho dos agentes (workspace-*/)

O que nunca é enviado (protegido automaticamente):

  • .env (chaves de API, Webhooks)
  • Qualquer arquivo correspondendo a *.key, *.pem
  • Diretório secrets/

Configuração:

  1. Initialize ~/.opengoat/ as a Git repository:
    cd ~/.opengoat
    git init
    git branch -M main
  2. Crie um repositório privado no GitHub
  3. Adicione o remoto ao seu diretório .opengoat: git -C ~/.opengoat remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
  4. Defina git.autoPushEnabled: true em workspace-security-guardian/guardian_config.json
  5. Security Guardian cuida do resto automaticamente

▶ Cole isto no seu AI para começar

Já fez a parte mais trabalhosa — os canais estão criados e os webhooks estão configurados. Use o prompt abaixo para obter uma lista de verificação personalizada e ajuda para organizar o seu layout específico do Discord.

Cole-o no seu chat de IA e anexe o seu Documento de Design de Equipa.

Você está me ajudando a organizar meu workspace do Discord para o BALIA OS —
um sistema operacional de IA multiagente onde cada agente reporta
sua atividade para seu próprio canal do Discord.

Eu anexei meu Documento de Design de Equipe.
Leia-o para obter os nomes dos meus agentes e os nomes dos canais do Discord.

Me guie passo a passo pelo seguinte.
Faça uma pergunta de cada vez. Aguarde minha resposta antes de continuar.
Se eu travar, me peça para tirar um screenshot —
Eu descreverei o que vejo e você me dirá o que fazer a seguir.

STEP 1 — Verificar minha configuração atual do Discord
Pergunte-me: "Abra seu servidor do Discord. Quantos canais você
tem atualmente na seção de agentes?"
Com base na minha resposta, me diga se está faltando algo
ou se todos os 6 canais de agentes estão presentes.

STEP 2 — Criar uma categoria de canais
Me guie para agrupar todos os canais de agentes em uma categoria:
1. Clique com o botão direito no nome do servidor na barra lateral esquerda
2. Selecione "Criar Categoria"
3. Nomeie como: AGENT REPORTS (ou um nome que eu prefira)
4. Arraste cada canal de agente para a categoria

Leia meu Documento de Design de Equipe para me dar a lista exata
de canais a mover.

STEP 3 — Adicionar um canal de anúncios (opcional)
Pergunte-me: "Você gostaria de um canal #announcements
para fixar atualizações importantes — como quando você reinicia agentes
ou instala um novo cassette?"
Se sim: me guie para criá-lo acima da categoria AGENT REPORTS.
Se não: pular.

STEP 4 — Configurar as configurações de notificação
Me guie para desativar as notificações para cada canal de agentes:
Para cada canal em AGENT REPORTS:
1. Clique com o botão direito no canal → Configurações de Notificação
2. Defina como "Nada" (ou "Apenas @menções" se eu quiser alertas críticos)

Diga-me: "Isso impede o Discord de notificar você toda vez que um
agente reporta. Você verificará os relatórios no seu próprio ritmo."

STEP 5 — Fixar um lembrete de função em cada canal
Para cada canal de agente, me guie para fixar uma nota curta
para que eu possa lembrar rapidamente quem reporta lá:
1. Clicar no canal
2. Digite e envie: 📌 [Nome do Agente] — [Função]. Reporta aqui.
3. Clique com o botão direito na mensagem → Fixar Mensagem
4. Confirme "Entendido" para descartar a notificação de fixação

Leia meu Documento de Design de Equipe para o nome e função corretos
para cada canal.

STEP 6 — Criar uma rotina de leitura matinal
Com base no meu Documento de Design de Equipe, escreva para mim uma
lista de verificação de check-in matinal de 5 minutos que eu possa imprimir ou salvar:

---
VERIFICAÇÃO MATINAL DO DISCORD — [Nome do Meu Negócio]
Tempo necessário: ~5 minutos

1. Abrir Discord → categoria AGENT REPORTS
2. Verificar cada canal para atividade noturna:
   □ #[canal 1] — [nome do agente]: procurar ✅ concluídos ou ⚠️ avisos
   □ #[canal 2] — [nome do agente]: ...
   [continuar para todos os 6]
3. Se você ver ⚠️ ou ❌: anotar o problema, enviar um comando de acompanhamento
   via terminal VS Code ou OpenGoat UI
4. Verificar #security para alertas sinalizados
5. Concluído — fechar Discord até o próximo check-in
---

STEP 7 — Verificação final
Percorra esta lista de verificação:
□ Todos os 6 canais de agentes existem no Discord
□ Canais estão agrupados sob a categoria AGENT REPORTS
□ Configurações de notificação definidas como Nada ou apenas @menções
□ Lembrete de função fixado em cada canal
□ Lista de verificação de leitura matinal salva

Quando todas as caixas estiverem marcadas, diga:
"Seu workspace do Discord está organizado.
Você está pronto para a Seção 8 — Sua Primeira Semana."

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

Discord de Relance — Cenários Comuns

O seu agente concluiu uma tarefa com sucesso:

✅ Finance — Daily P&L report complete.
Balance: $9,847 | Net today: +$235 | Win rate (30d): 68.2%
Output saved: workspace/finance/outputs/2026-06-04_pl_report.md
Next: Waiting for next session command.

→ Não há nada a fazer. A equipa está a trabalhar.

O seu agente encontrou um erro:

❌ Operations — Failed to complete market scan.
Error: API rate limit reached on third data source.
Completed 2 of 3 sources. Partial output saved.
Recommended action: Retry in 60 minutes or expand data source list.

→ Envie um comando de seguimento: openclaw agent --agent [agentid] "Retry the market scan now."

O seu agente está a iniciar uma sessão:

🔷 Marketing ready. Cassette youtube-ops loaded. 
Today's task: Generate 3 title options for this week's upload.

→ Não é necessária nenhuma ação — volte a verificar quando o relatório de conclusão estiver disponível.


Verifica a Tua Configuração

Assim que o teu espaço de trabalho do Discord estiver organizado, executa:

Windows:

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

Mac:

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

Isto confirma que o Guardião de Segurança continua em execução e que o teu ambiente BALIA OS está intacto antes de avançares para a Secção 8.