Estrutura de pastas .opengoat no final desta secção
Estas pastas são construídas passo a passo ao longo das Secções 1–8. Não te preocupes se parecer vazio agora — cada secção acrescenta os ficheiros de que precisas.
📁 Estrutura completa de pastas .opengoat
$env:USERPROFILE\.opengoat\ ← diretório principal do BALIA OS
├── identity\ ← criado na Secção 2
│ └── team_design.md ← Documento de Design de Equipa
├── .env ← criado na Secção 3 (chaves de API e webhooks)
├── workspaces\ ← criado na Secção 3
│ ├── [agentid]\ ← criado por agente na Secção 4
│ │ ├── SOUL.md
│ │ ├── AGENTS.md
│ │ ├── IDENTITY.md
│ │ ├── HEARTBEAT.md
│ │ ├── TOOLS.md
│ │ ├── USER.md
│ │ └── SPEC_[nome].md
│ └── security-guardian\ ← implementado automaticamente na Secção 3
├── agents\ ← ficheiros de configuração do OpenClaw, gerados automaticamente na Secção 5
│ └── [agentid]
│ ├── config.json
│ └── models.json
├── memory\ ← criado na Secção 6
│ └── _SKILL_STATUS.md ← lista ON/OFF das cassetes (fonte única de verdade)
└── skills\ ← cassetes adicionadas na Secção 6
└── [nome-da-cassete]\
└── SKILL.mdEsta pasta é a "casa" do BALIA OS. Todas as identidades, memórias e skills dos agentes ficam guardadas aqui.
💡 O que é uma API? — E porque precisas de uma?
Pensa nos teus agentes de IA como funcionários que precisam de pensar antes de agir.
Sempre que um agente analisa uma situação, escreve um relatório ou toma uma decisão, precisa de chamar um modelo de IA para fazer esse pensamento. A API é o canal que faz essa chamada — e o combustível que a alimenta.
Chat AI vs API — duas coisas diferentes:
| Chat AI | API | |
|---|---|---|
| O que é | O teu concierge pessoal | O motor de pensamento dos teus agentes |
| Quem usa | Tu, diretamente | Os teus agentes, automaticamente |
| Modelo de custo | Subscrição (taxa fixa) | Pagamento por utilização (tokens de input + output) |
| Recomendado | Plano pago — melhor raciocínio | Começa com um crédito de $5 |
Porquê usar os dois? (Configuração híbrida)
A faturação da API funciona com tokens de input + output — cada palavra enviada ao agente e cada palavra que ele responde custa uma pequena quantia.
Isto significa que a forma como instruis os teus agentes importa.
Usa o teu chat de IA (plano pago recomendado para melhor raciocínio) para:
- Rascunhar instruções claras e concisas antes de as enviares aos agentes
- Resumir documentos longos antes de os passares aos agentes
- Pré-estruturar tarefas para que os agentes não desperdicem tokens a tentar perceber o que queres
Uma instrução bem estruturada de 200 tokens custa uma fração de um diálogo vago de 2.000 tokens. O teu Chat AI é o estratega. Os teus agentes são os executores. Esta combinação mantém os custos da API baixos e a qualidade do resultado alta.
Antes de começar — Transparência nos custos da API
O BALIA OS exige uma chave de API de IA para executar os teus agentes. Isto é separado do custo de $48 do guia.
O que precisas:
- Uma conta Anthropic com pelo menos $5 em créditos pré-pagos
- Todos os agentes deste guia usam o Claude Sonnet 5
Porque $5 chega para começar: O Claude Sonnet 5 custa $2 por milhão de tokens de entrada e $10 por milhão de tokens de saída (preço de lançamento válido até 31 de agosto de 2026; depois disso passa para $3 na entrada e $15 na saída). Uma sessão típica de agente usa alguns milhares de tokens. Com $5 tens dezenas de sessões para aprender e experimentar antes de gastares mais.
Não existe nível gratuito na API da Anthropic. É necessário cartão de crédito. Adiciona créditos em: console.anthropic.com → Billing → Add credits (mínimo $5)
Este é o único custo externo necessário para executar o BALIA OS. Para teres uma ideia: contratar um assistente humano custa $2.000–$5.000 por mês. A tua equipa de IA funciona com $5 em créditos de API para começar. O mesmo trabalho. Uma fração do custo.
O Que Vais Instalar
No final desta secção, terás cinco coisas prontas:
- VS Code — o teu workspace para editar ficheiros de agentes e executar comandos
- Claude Code — o executor da configuração híbrida da Secção 1, que automatiza correções de erros e edição de ficheiros dentro do VS Code. Se já usares o Claude Pro, não precisas de comprar nada extra
- Node.js — necessário para correr o OpenClaw e o Claude Code
- OpenClaw — a framework de agentes de IA que alimenta o BALIA OS
- Chave de API Anthropic — o motor de IA que os teus agentes usam para pensar
- Guardião de Segurança — o teu assistente de configuração automatizado que gere ficheiros e verifica a tua configuração
Como funciona esta secção: Copia o prompt abaixo e cola-o no teu chat de IA. A IA vai guiar-te ao longo de toda a instalação — perguntando o teu sistema operativo, conduzindo-te por cada passo e ajudando-te a resolver qualquer problema. Se ficares preso nalgum momento, basta descrever o problema à IA e ela ajuda-te a resolvê-lo.
▶ Cola isto no teu AI para começar
Estás a ajudar-me a instalar e configurar o BALIA OS — um sistema operativo de IA multi-agente construído sobre o OpenClaw.
O teu trabalho é guiar-me pela instalação passo a passo. Faz-me uma pergunta de cada vez. Aguarda a minha resposta antes de continuares. Se eu encontrar um erro, ajuda-me a corrigi-lo antes de continuarmos.
Aqui está tudo o que precisamos de instalar e configurar, por ordem:
PASSO 1 — Verificar o meu sistema operativo
Pergunta-me: "Usas Windows ou Mac?"
Depois dá-me as instruções corretas para o meu SO em todos os passos.
PASSO 2 — Instalar o VS Code
Guia-me para instalar o VS Code em code.visualstudio.com
- Windows: descarrega e executa o instalador. Confirma que "Add to PATH" está marcado.
- Mac: descarrega, descomprime, arrasta para Aplicações, depois executa o comando shell para adicionar "code" ao PATH: Cmd+Shift+P → "Shell Command: Install 'code' command in PATH"
Depois da instalação, pede-me para abrir um terminal no VS Code e executar:
code --version
Pergunta-me o que aparece. Se houver erro, ajuda-me a corrigi-lo.
PASSO 2b — Alterar o idioma de exibição do VS Code (opcional)
O VS Code vem em inglês por predefinição. Se eu quiser usá-lo em português, explica-me primeiro:
"Atenção: a Microsoft não disponibiliza oficialmente um pacote de idioma específico para português europeu (pt-PT) — só o pacote oficial 'Portuguese (Brazil)' está disponível na Marketplace do VS Code."
Depois diz-me que tenho duas opções:
- Instalar o pacote "Portuguese (Brazil)" (versão brasileira), seguindo estes passos:
1. Abrir o VS Code e premir Ctrl+Shift+X (Mac: Cmd+Shift+X) para abrir o painel de extensões
2. Procurar "Portuguese (Brazil) Language Pack" (da Microsoft) e instalar
3. Clicar em "Change Language and Restart" quando aparecer
(se não aparecer: Ctrl+Shift+P → "Configure Display Language" → escolher "pt-br")
4. Confirmar que o VS Code reiniciou com os menus em português
- Ou, visto não existir pacote oficial em português europeu, saltar este passo e continuar com o VS Code em inglês — isto não afeta o resto da instalação.
Deixa claro que é sempre seguro saltar este passo e avançar, caso eu prefira.
PASSO 3 — Instalar o Python
No terminal do VS Code, orienta o utilizador a executar:
python --version
Se aparecer "Python 3.x.x", o Python já está instalado. Segue para o próximo PASSO.
Se não aparecer, diz para instalar em https://www.python.org/downloads/
- Windows: Executa o instalador. Marca "Add Python to PATH".
- Mac: Executa o instalador e segue as opções predefinidas.
Depois de instalar, reinicia o VS Code e executa python --version novamente para confirmar.
PASSO 4 — Instalar o Node.js
Guia-me para instalar o Node.js 22 ou superior em nodejs.org (versão LTS).
Depois da instalação, pede-me para executar: node --version
Pergunta-me o que aparece.
- Se v22 ou superior: ótimo, avança.
- Se abaixo de v22: guia-me a atualizar usando o nvm (Mac/Linux) ou o nvm-windows (Windows).
- Se der erro: ajuda-me a resolver.
PASSO 5 — Instalar o OpenClaw
Guia-me para executar no terminal do VS Code:
npm install -g openclaw
Depois verificar:
openclaw --version
Erros comuns:
- EACCES no Mac: guiar a correção do prefixo global do npm
- "openclaw not found": pede-me para fechar e reabrir o terminal, tentar novamente
PASSO 5b — Instalar o Claude Code
Explica-me primeiro:
"O Claude Code é o executor da configuração híbrida da Secção 1.
Lê os erros diretamente no VS Code e trata da correção de ficheiros e
da execução de comandos por ti.
Se já tiveres um plano Claude Pro ou superior ($20/mês ou mais), não precisas
de contratar nada extra — o chat em claude.ai e o Claude Code partilham
a mesma subscrição e o mesmo limite de utilização.
Se escolheste o Claude Pro como o teu chat de IA na Secção 1, podes
iniciar sessão com essa mesma conta aqui.
Se usares outro chat de IA que não o Claude (ChatGPT, Gemini, etc.),
vais precisar de uma subscrição Claude Pro (ou superior) à parte, ou
de acesso à API da Anthropic, para usares o Claude Code."
Depois guia-me para:
1. Executar no terminal do VS Code para instalar a CLI:
npm install -g @anthropic-ai/claude-code
2. Confirmar a instalação:
claude --version
Verificar se aparece um número de versão
3. No painel de extensões do VS Code (Ctrl+Shift+X), procurar "Claude Code"
(editor: Anthropic) e instalar
4. Executar o seguinte comando no terminal do VS Code para iniciar sessão
pela primeira vez:
claude
Abre-se uma janela do browser — guia-me a iniciar sessão com a minha
conta Claude Pro (ou chave de API)
5. Depois de iniciar sessão, confirma que o terminal volta a mostrar o
prompt de comandos
Erros comuns:
- EACCES no npm install (erro de permissões, Mac/Linux): guia-me a executar,
por esta ordem:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
e depois tentar novamente.
- "claude: command not found": pede-me para fechar e reabrir o terminal,
depois tentar novamente.
- O ecrã de login não abre: pede-me para confirmar em console.anthropic.com
se tenho uma subscrição válida ou acesso à API.
PASSO 6 — Obter uma chave de API da Anthropic
Explica primeiro:
"O BALIA OS usa o Claude (Anthropic) como motor de IA predefinido para os
teus agentes. Por agora configuramos só o Claude. Outros motores de IA
podem ser adicionados mais tarde, consoante o que quiseres construir:
- Ao criares a tua própria cassete (Secção 6), vais escolher a melhor
IA para essa cassete — por exemplo, Gemini para YouTube (analisa vídeo
diretamente), ou GPT-4o para textos de vendas.
- Depois de o BALIA Skill Market abrir, também vais poder instalar
cassetes construídas por outros utilizadores, cada uma com o seu
próprio motor de IA recomendado."
Depois guia-me para:
1. Ir a console.anthropic.com
2. Registar-me ou iniciar sessão
3. Ir a API Keys → Create Key
4. Nomear como "balia-os"
5. Copiar a chave (começa com sk-ant-)
Diz-me: "Guarda isto num sítio seguro — só a podes ver uma vez."
Pede-me para confirmar que tenho a chave antes de continuarmos.
NÃO me peças para colar a chave no chat.
PASSO 7 — Executar a configuração do OpenClaw
Guia-me para executar no terminal do VS Code:
openclaw setup
Diz-me o que esperar:
- Vai pedir a minha chave de API Anthropic — cola-a lá
- Vai criar automaticamente a pasta ~/.opengoat/ (Mac) ou
$env:USERPROFILE\.opengoat\ (Windows)
Este é o diretório principal do BALIA OS — todos os ficheiros dos
agentes ficam aqui.
Depois da configuração, guia-me a executar este comando para iniciar o gateway:
Windows: $env:DEBUG="-ciao*"; openclaw gateway --force
Mac: DEBUG="-ciao*" openclaw gateway --force
Pede-me para confirmar que vejo:
"✓ Gateway running on port 18789"
Diz-me: "Mantém este separador aberto — é o teu gateway. Abre um separador novo para todos os próximos comandos."
Depois pede-me para confirmar que a pasta foi criada:
- Windows: dir $env:USERPROFILE\.opengoat
- Mac: ls ~/.opengoat
Pergunta-me: "Vês a pasta .opengoat?"
Se não, ajuda-me a resolver.
PASSO 9 — Criar o ficheiro .env
Guia-me a criar um ficheiro .env dentro da pasta .opengoat.
- Windows: No VS Code, abre a pasta $env:USERPROFILE\.opengoat
Clica com o botão direito no painel esquerdo → Novo Ficheiro → chama-lhe .env
- Mac: No VS Code, abre a pasta ~/.opengoat
Clica com o botão direito no painel esquerdo → Novo Ficheiro → chama-lhe .env
Depois cola este modelo:
# BALIA OS
BALIA_TOKEN=cola-aqui-o-teu-token
AGENT_ID=ceo
# Anthropic API
ANTHROPIC_API_KEY=sk-ant-cola-aqui-a-tua-chave
# Modelo do agente
CLAUDE_MODEL=claude-sonnet-5
# Discord Webhooks — a preencher na Secção 4
# Exemplo: DISCORD_WEBHOOK_MAYA=https://discord.com/api/webhooks/123456789/xxxxxxxxxxxx
DISCORD_WEBHOOK_[AGENT1NAME]=
DISCORD_WEBHOOK_[AGENT2NAME]=
DISCORD_WEBHOOK_[AGENT3NAME]=
DISCORD_WEBHOOK_[AGENT4NAME]=
DISCORD_WEBHOOK_[AGENT5NAME]=
DISCORD_WEBHOOK_SECURITY=
Preencher BALIA_TOKEN:
"Verifica o e-mail que recebeste depois da compra.
O assunto diz 'Your BALIA OS Access Token'.
Copia o token (começa com BALIA-) e cola a seguir a BALIA_TOKEN=
Só precisas de o inserir uma vez —
o instalador da Secção 6 lê-o automaticamente deste ficheiro.
NÃO o coles neste chat."
Preencher AGENT_ID:
"Este é o ID do teu agente CEO — o agente principal com quem mais falas.
O ID é fixo: ceo. Deixa AGENT_ID=ceo exatamente como está acima.
Não o alteres. Os scripts de instalação e a Secção 4 dependem deste valor."
Diz-me: "Deixa os webhooks do Discord em branco por agora — vais obter os
URLs reais na Secção 4.
O formato do URL é: https://discord.com/api/webhooks/números/letras
Substitui [AGENT1NAME] até [AGENT5NAME] pelos nomes dos teus agentes em MAIÚSCULAS.
DISCORD_WEBHOOK_SECURITY é sempre o último — é para o agente Guardião de Segurança."
Nota de segurança — diz isto:
"Se não te sentires confortável em colocar o teu token num ficheiro:
Podes saltar BALIA_TOKEN por agora e inseri-lo manualmente
quando for pedido durante a instalação da Secção 6."
Diz-me: "Nunca partilhes este ficheiro. Nunca o submetas (commit) ao GitHub."
PASSO 9b — Escrever a chave de API no ficheiro .env
Nota: A chave de API já foi inserida no PASSO 7 (openclaw setup). Explica porque também é necessária aqui.
Diz: "Estás a configurar a mesma chave de API em dois sítios:
- O openclaw setup guarda-a dentro da própria configuração do OpenClaw.
- O teu ficheiro .env guarda-a para os agentes do BALIA OS — os agentes
leem a sua chave diretamente do .env.
Ambos têm de ter a mesma chave. Isto só se faz uma vez."
Guia-me para:
1. Abrir o ficheiro .env no VS Code (está na pasta .opengoat)
2. Encontrar a linha: ANTHROPIC_API_KEY=sk-ant-cola-aqui-a-tua-chave
3. Substituir "sk-ant-cola-aqui-a-tua-chave" pela minha chave real
4. Guardar o ficheiro (Ctrl+S no Windows / Cmd+S no Mac)
Confirma: "A tua chave de API já está guardada no teu ficheiro .env.
Nunca partilhes este ficheiro nem o submetas ao GitHub."
NÃO me peças para colar a chave no chat.
Quando terminares o PASSO 9b, diz-me: "O teu ambiente está pronto. A seguir vamos configurar o Guardião de Segurança — o teu assistente de configuração automatizado."
Começa agora. Faz-me a primeira pergunta.🛡️ A configurar primeiro o teu Guardião de Segurança
Antes de criares os teus agentes, vamos iniciar o teu Guardião de Segurança. A partir deste momento, o Guardião de Segurança vai verificar automaticamente a tua configuração, mover ficheiros para o local correto quando necessário e criar quaisquer ficheiros em falta. Não precisas de te preocupar em cometer erros — o Guardião trata disso por ti.
🛡️ Implementar o Guardião de Segurança
⚠️ Aviso: Custos de API fora de controlo
[Um incidente real no estrangeiro — sem relação com o BALIA OS] Em novembro de 2025, um agente de IA numa equipa de desenvolvimento no estrangeiro entrou num ciclo infinito e continuou a funcionar durante 11 dias sem que ninguém reparasse, resultando numa fatura de API de $47.000. (Fonte: Tech Startups / Hacker News)
Os agentes de IA podem continuar a chamar APIs sem que o utilizador se aperceba. Para prevenir este risco, o Guardião de Segurança monitoriza os custos 24 horas por dia e envia um alerta imediato no Discord assim que deteta uma anomalia.
Configura sempre também o seguinte:
- Define um alerta de custos na consola do teu fornecedor de IA (recomendado: $3–5/dia) (para utilizadores Anthropic) → https://console.anthropic.com/settings/billing
- Verifica as definições de monitorização de custos do Guardião de Segurança (Passo 2.5)
O teu ambiente está pronto.
Existe mais um agente no BALIA OS: o Guardião de Segurança (security-guardian).
Este agente é pré-configurado pela BALIA. Não alteres o seu nome, ID ou caminhos. Fazê-lo vai quebrar a integração com os teus outros agentes.
Pré-requisito: Instalar o PM2
O PM2 é um gestor de processos do Node.js. Mantém o Guardião de Segurança em execução automaticamente, mesmo depois de reiniciares o PC.
Abre o terminal do VS Code e cola o seguinte comando para instalar:
bash
npm install -g pm2Salta este passo se o PM2 já estiver instalado.
Descarregar e Executar o Instalador
💡 O que é um Token?
É a string a seguir a ?token= no URL de acesso recebido depois da compra.
Exemplo: https://guide.baliaos.com/?token=BALIA-XXXX-XXXX-0001 Neste caso, o teu token é BALIA-XXXX-XXXX-0001.
Se não encontrares o e-mail, contacta o suporte.
Passo 1 — Descarregar o instalador
No teu terminal do VS Code:
Windows:
powershell
Invoke-WebRequest -Uri "https://balia-os-guide.vercel.app/scripts/install_core_pack.py" -OutFile install_core_pack.py
python install_core_pack.pyMac / Linux:
bash
curl -o install_core_pack.py https://balia-os-guide.vercel.app/scripts/install_core_pack.py
python3 install_core_pack.pyPasso 2 — Registar o Guardião de Segurança no OpenClaw
Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardianMac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardianIsto regista o security-guardian para que o OpenClaw possa encaminhar comandos para ele.
Passo 2.5 — Verifica o registo
Confirma que o OpenClaw consegue ver o agente:
openclaw agents listDeves ver security-guardian na lista. Se não estiver listado, repete o Passo 2.
📋 Guia de personalização do guardian_config.json
As definições seguintes podem ser alteradas a qualquer momento. Localização do ficheiro:
$env:USERPROFILE\.opengoat\workspaces\security-guardian\guardian_config.json| Chave | Predefinição | Descrição |
|---|---|---|
cost.alertHourly | 1.0 | Alerta de custo de API por hora ($) |
cost.alertDaily | 5.0 | Alerta de custo de API diário ($) |
rollback.threshold | 6 | Ficheiros em falta antes de acionar o rollback |
rollback.autoRecovery | true | Rollback automático (false = aprovação manual) |
snapshot.intervalMinutes | 10 | Frequência de instantâneos (minutos) |
snapshot.maxSnapshots | 3 | Número de instantâneos a manter |
watchdog.checkGateway | true | Monitorizar o gateway do OpenClaw |
watchdog.checkWSL2 | false | Monitorizar o WSL2 (desativado por predefinição) |
scanner.runIntervalHours | 4 | Frequência de análise de quarentena (horas) |
git.autoPushEnabled | true | Cópia de segurança automática para o GitHub |
git.autoPushIntervalMinutes | 30 | Frequência de cópia de segurança (minutos) |
Depois de alterares as definições, reinicia o Guardião de Segurança:
powershell
pm2 restart security-guardianPasso 3 — Pedir ao Guardião de Segurança para executar o instalador
openclaw agent --agent security-guardian "Run: python install_core_pack.py --lang pt (token loads from .env automatically). Tell me when done."O token é lido automaticamente de
BALIA_TOKENno teu ficheiro.env.
O teu agente vai automaticamente:
- Autenticar o teu token
- Descarregar os ficheiros do Guardião de Segurança
- Instalar em
.opengoat/agents/security-guardian/e.opengoat/workspaces/security-guardian/ - Mostrar "✓ Security Guardian deployed successfully" no terminal
⚠️ Importante: Não alteres o ID, nome ou caminho da pasta do Guardião de Segurança. Outros ficheiros de configuração referenciam este agente diretamente. Alterá-los vai quebrar o sistema de quarentena de skills.
Quando o terminal mostrar "✓ Security Guardian deployed successfully", continua para o próximo passo abaixo.
INFO
agents/security-guardian/ vs workspaces/[agentid]/
O BALIA OS usa dois tipos de pasta para cada agente:
agents/[id]/— ficheiros de configuração do OpenClaw (config.json, models.json) — o OpenClaw lê-os para iniciar o agenteworkspaces/[id]/— ficheiros de workspace (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC) — o agente lê-os no início de cada sessão
O Guardião de Segurança usa ambos:
agents/security-guardian/— config.json e models.jsonworkspaces/security-guardian/— SOUL.md, SPEC_SECURITY.md, scripts/ e mais
Os teus próprios agentes usam a mesma estrutura. Ambas as pastas ficam dentro de $env:USERPROFILE/.opengoat/.
Passo 3.5 — Parar o gateway, iniciar o Guardian com PM2 e reiniciar
Depois de a instalação estar completa, reinicia o gateway em segurança.
① Parar o gateway
No PowerShell onde o openclaw gateway está em execução, pressiona:
Ctrl + CSe perguntar "Terminar?", pressiona Y e depois Enter.
② Iniciar o Guardião de Segurança com PM2
Abre um novo PowerShell e executa o seguinte, linha a linha:
powershell
pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\security_guardian.js --name security-guardianpowershell
pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\watchdog.js --name guardian-watchdogpowershell
pm2 savepowershell
pm2 listConfirma que security-guardian e guardian-watchdog aparecem como online.
③ Reiniciar o gateway
No mesmo PowerShell, executa o seguinte, linha a linha:
powershell
$env:DEBUG="-ciao*"powershell
openclaw gateway --forceNão fechas esta janela do PowerShell.
▶ Continuar: cola isto no teu AI
O Guardião de Segurança já está em execução. Vamos criar as tuas pastas de workspace e concluir a configuração.
PASSO 8 — Criar pastas de workspace para cada agente
Diz-me: "Vou ler o teu Documento de Design de Equipa da Secção 2 para obter
automaticamente os IDs dos teus agentes. Por favor, anexa-o agora."
Lê o Documento de Design de Equipa anexado.
Extrai os 6 nomes/IDs de agentes (converte para minúsculas, sem espaços,
usa hífen para os espaços).
Mostra-me a lista:
"Encontrei estes 6 agentes: [id1], [id2], [id3], [id4], [id5], [id6]
Está correto?"
Aguarda a minha confirmação.
Depois dá-me os comandos exatos para criar as 6 pastas de workspace de uma vez,
já com os IDs reais preenchidos.
Usa esta estrutura de pastas: workspaces\[id]\ (não workspace-[id]).
- Windows: cd $env:USERPROFILE\.opengoat
mkdir workspaces\[id1] workspaces\[id2] workspaces\[id3] workspaces\[id4] workspaces\[id5] workspaces\[id6]
- Mac: cd ~/.opengoat
mkdir -p workspaces/[id1] workspaces/[id2] workspaces/[id3] workspaces/[id4] workspaces/[id5] workspaces/[id6]
Depois de executar, pede-me para confirmar que as pastas foram criadas:
- Windows: dir $env:USERPROFILE\.opengoat\workspaces
- Mac: ls ~/.opengoat/workspaces
PASSO 10 — Verificação final
Revê esta lista comigo, um item de cada vez:
□ code --version → mostra número de versão
□ node --version → mostra v22 ou superior
□ openclaw --version → mostra número de versão
□ claude --version → mostra número de versão
□ O VS Code tem a extensão Claude Code instalada e com sessão iniciada
□ O terminal do gateway mostra "✓ Gateway running"
□ A pasta .opengoat existe e foi confirmada
□ As subpastas de workspaces/ foram criadas para os 6 agentes
□ Existe um ficheiro .env na pasta .opengoat
□ BALIA_TOKEN preenchido (ou anotado para inserir manualmente na Secção 6)
□ AGENT_ID definido como ceo
□ ANTHROPIC_API_KEY preenchido
□ Guardião de Segurança implementado (confirmado através do terminal)
Quando todas as caixas estiverem marcadas, diz:
"Instalação concluída. Estás pronto para a Secção 4 —
Criar os Ficheiros dos Teus Agentes."
Começa pelo PASSO 8. Pede-me para anexar o meu Documento de Design de Equipa.🛡️ Auditoria do Guardião de Segurança
O teu Guardião de Segurança vai agora verificar toda a tua configuração e corrigir automaticamente quaisquer problemas.
O que o Guardian verifica:
- Se todas as pastas necessárias existem em
$env:USERPROFILE\.opengoat\ - Se todos os ficheiros necessários estão no local correto
- Ficheiros no lugar errado são movidos automaticamente
- Ficheiros em falta são criados automaticamente (vazios — vais preenchê-los na Secção 4)
O que o Guardian ainda NÃO altera nesta secção:
- O conteúdo dos ficheiros (as personalidades e configurações dos agentes vêm na Secção 4)
Executa a auditoria:
Windows:
node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --fixO Guardian vai reportar o que encontrou e corrigiu. Se estiver tudo verde, estás pronto para a Secção 4.