Skip to content

O Discord É a Sua Camada de Relatórios

Seus agentes não esperam você perguntar como as coisas estão indo. Eles reportam.

Cada tarefa concluída, cada erro encontrado, cada sessão iniciada — tudo flui para o Discord. Essa é a sua janela para o que sua equipe está fazendo, agora e ao longo do dia.

Na Seção 4, você criou canais e URLs de Webhook para cada agente. Esta seção é sobre transformar essa configuração inicial em um workspace organizado — onde você pode entrar toda manhã, dar uma olhada nos seus canais e imediatamente saber o estado da sua equipe.

O que você vai configurar nesta seção:

  • Organização e nomenclatura de canais
  • Configurações de notificação para não ser sobrecarregado
  • Uma rotina de leitura que leva menos de 5 minutos

Nota importante sobre o escopo: O Discord é de mão única para seus agentes — eles reportam para o Discord, mas não podem receber comandos do Discord sem um Bot do Discord. Configurar um Bot para que você possa digitar comandos diretamente no Discord é uma configuração avançada não abordada no T1. Por enquanto, dê comandos pelo terminal do VS Code ou pela interface do OpenGoat UI, e leia os relatórios da sua equipe no Discord.


Uma Estrutura de Canais que Funciona

Ao final da Seção 4, você tinha um canal por agente. Essa é a estrutura inicial correta. Veja como organizá-la para que continue legível à medida que sua equipe cresce.

Layout recomendado do servidor Discord:

INFO

BALIA OS Team ├── 📋 TEAM OVERVIEW │ └── #announcements ← Fixe atualizações importantes aqui │ ├── 🤖 AGENT REPORTS │ ├── #[agent1-channel] ← ex: #operations │ ├── #[agent2-channel] ← ex: #marketing │ ├── #[agent3-channel] ← ex: #finance │ ├── #[agent4-channel] ← ex: #specialist-a │ ├── #[agent5-channel] ← ex: #specialist-b │ └── #security ← O Agente #6 sempre reporta aqui │ └── 📁 LOGS └── #errors ← Opcional: direcione relatórios de erros aqui

Você não precisa criar essa estrutura exatamente assim — os nomes dos seus canais vieram da Seção 2. O objetivo é agrupar os canais dos agentes para que você possa visualizá-los de uma vez.


Como Organizar Seus Canais

Se seus canais de agentes estão espalhados pelo servidor Discord, veja como agrupá-los:

Crie uma categoria de canal:

  1. Clique com o botão direito no nome do seu servidor Discord (barra lateral esquerda) → Create Category
  2. Nomeie como AGENT REPORTS
  3. Arraste cada canal de agente para dentro da categoria

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

Fixe uma mensagem em cada canal: Para cada canal de agente, fixe uma nota com o nome e o cargo do agente. Isso ajuda você a lembrar rapidamente quem reporta onde.

Clique com o botão direito em qualquer mensagem → Pin Message Ou crie uma mensagem e fixe-a: 📌 [Nome do Agente] — [Cargo]. Reporta aqui após cada tarefa.


Configurações de Notificação

Seus agentes podem reportar várias vezes por sessão. Se você deixar as notificações padrão ativadas, o Discord vai te notificar o tempo todo. Isso é o oposto do que você quer.

Configuraçõ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 notificado para alertas críticos

Você vai verificar o Discord no seu próprio horário — não porque ele está te notificando a cada poucos minutos.

Quando verificar o Discord:

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

Como Ler os Relatórios da Sua Equipe

Cada agente formata seus relatórios de forma consistente — você configurou isso no AGENTS.md na Seção 4. O formato padrão é:

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

O que procurar a cada manhã:

Í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 — agente não conseguiu concluir

Se você ver um ⚠️ ou ❌, abra a mensagem para ver todos os detalhes e, em seguida, envie um comando de acompanhamento ao agente pelo terminal do VS Code ou pela interface do OpenGoat UI.


Configuração de Backup no GitHub (Recomendado)

BALIA OS faz backup automático 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/)

O que nunca é enviado (protegido automaticamente):

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

Configuração:

  1. Crie um repositório privado no GitHub
  2. Adicione o remote ao seu diretório .opengoat: git -C ~/.opengoat remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
  3. Defina git.autoPushEnabled: true em workspaces/security_guardian/guardian_config.json
  4. Security Guardian cuida do resto automaticamente

▶ Cole isto em seu IA para começar

Você já fez a parte difícil — os canais foram 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 no Claude, ChatGPT ou Gemini e anexe o seu Documento de Design de Equipe.

You are helping me organize my Discord workspace for BALIA OS — 
a multi-agent AI operating system where each agent reports their 
activity to their own Discord channel.

I have attached my Team Design Document. Read it to get my 
agent names and Discord channel names.

Guide me step by step through the following. 
Ask one question at a time. Wait for my answer before moving on.
If I get stuck, ask me to take a screenshot — I'll describe 
what I see and you'll tell me what to do next.

STEP 1 — Check my current Discord setup
Ask me: "Open your Discord server. How many channels do you 
currently have in the agent section?"
Based on my answer, tell me if anything is missing or 
if all 6 agent channels are present.

STEP 2 — Create a channel category
Guide me to group all agent channels into a category:
1. Right-click the server name in the left sidebar
2. Select "Create Category"
3. Name it: AGENT REPORTS (or a name I prefer)
4. Drag each agent channel into the category

Read my Team Design Document to give me the exact 
list of channels to move.

STEP 3 — Add an announcements channel (optional)
Ask me: "Would you like an #announcements channel 
for pinning important updates — like when you restart agents 
or install a new cassette?"
If yes: guide me to create it above the AGENT REPORTS category.
If no: skip.

STEP 4 — Set up notification settings
Guide me through turning off pings for each agent channel:
For each channel in AGENT REPORTS:
1. Right-click the channel → Notification Settings
2. Set to "Nothing" (or "Only @mentions" if I want critical alerts)

Tell me: "This stops Discord from pinging you every time an 
agent reports. You'll check reports on your own schedule."

STEP 5 — Pin a role reminder in each channel
For each agent channel, guide me to pin a short note 
so I can remember at a glance who reports there:
1. Click into the channel
2. Type and send: 📌 [Agent Name] — [Role]. Reports here.
3. Right-click the message → Pin Message
4. Confirm "Got it" to dismiss the pin notification

Read my Team Design Document for the correct name and role 
for each channel.

STEP 6 — Create a morning reading routine
Based on my Team Design Document, write me a 
5-minute morning check-in checklist I can print or save:

---
MORNING DISCORD CHECK — [My Business Name]
Time required: ~5 minutes

1. Open Discord → AGENT REPORTS category
2. Scan each channel for overnight activity:
   □ #[channel 1] — [agent name]: look for ✅ completions or ⚠️ warnings
   □ #[channel 2] — [agent name]: ...
   [continue for all 6]
3. If you see ⚠️ or ❌: note the issue, send a follow-up command
   via VS Code terminal or OpenGoat UI
4. Check #security for any flagged alerts
5. Done — close Discord until your next check-in
---

STEP 7 — Final check
Run through this checklist:
□ All 6 agent channels exist in Discord
□ Channels are grouped under AGENT REPORTS category
□ Notification settings set to Nothing or @mentions only
□ Role reminder pinned in each channel
□ Morning reading checklist saved

When all boxes are checked, say:
"Your Discord workspace is organized. 
You're ready for Section 8 — Your First Week."

Start now. Ask me the first question.

Discord de Relance — Cenários Comuns

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.

→ Nada a fazer. A equipe está trabalhando.

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 acompanhamento: openclaw agent --agent [agentid] "Retry the market scan now."

Seu agente está iniciando uma sessão:

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

→ Nenhuma ação necessária — volte para ver o relatório de conclusão.