Competência balia-design v1.2.0.1

Versão: v1.2.0.1 Preço: $9.8（pagamento único） Compatível com: BALIA OS T1 ou superior

---

⬇️ Transferência

📦 Transferir balia-design v1.2.0.1

Extraia o ZIP e faça duplo clique em install.bat para que os ficheiros sejam configurados automaticamente. De seguida, inicie a configuração com o prompt do assistente abaixo

🚀 Início rápido（3 passos）

Passo 1 — Transfira o ZIP pelo botão acima e extraia

Passo 2 — Faça duplo clique em install.bat dentro da pasta extraída

⚠️ Se aparecer "O Windows protegeu o seu PC", clique em "Mais informações" → "Executar mesmo assim"

✅ Os ficheiros serão configurados automaticamente em C:\Users\[username]\.opengoat\skills\balia-design\

Passo 3 — Abra o claude.ai e cole o prompt do assistente abaixo para concluir a configuração

✅ Precisa de uma chave de API da OpenAI（OPENAI_API_KEY）. Gere a sua chave em platform.openai.com.

---

Descrição geral

balia-design é uma competência do BALIA OS que utiliza a geração de imagens de alta qualidade do GPT-image-2 para criar folhetos, banners, miniaturas, logótipos, ícones e imagens para redes sociais a partir de simples pedidos de design.

Funcionalidades principais

• 📝 Descreva o conteúdo do design → o agente constrói o prompt ideal
• 🎨 Geração de imagens de alta qualidade com GPT-image-2（$0.07/imagem）
• 💾 Guardado automaticamente em C:\Users\[username]\.opengoat\workspaces\designs\
• 🤖 O agente de design executa de forma autónoma（consulta→geração→relatório no Discord）
• 📱 Formatos suportados: folhetos / banners / miniaturas / logótipos / ícones / YouTube / Instagram / X / Facebook / TikTok / LINE / Threads

Tipos de design suportados

Material impresso

Tipo	Tamanho
Folheto（A4 vertical）	2480×3508px
Folheto（A4 horizontal）	3508×2480px
Banner（horizontal）	1200×628px

Publicações em redes sociais

Plataforma	Utilização	Tamanho
YouTube	Miniatura	1280×720px
Instagram	Publicação（quadrada）	1080×1080px
Instagram	Histórias/Reels	1080×1920px
X（Twitter）	Imagem de publicação	1200×675px
X（Twitter）	Cabeçalho	1500×500px
Facebook	Imagem de publicação	1200×630px
TikTok	Miniatura de vídeo	1080×1920px
LINE	Imagem de publicação	1040×1040px
Threads	Imagem de publicação	1080×1080px

Outros

Tipo	Tamanho
Logótipo	500×500px
Ícone	400×400px
Cabeçalho Substack	1600×900px
Cabeçalho Dev Log	1920×1080px

Requisitos

• BALIA OS instalado（T1 ou superior）
• VS Code + Claude Code（Pro $20/mês）
• OpenClaw Gateway em execução
• OPENAI_API_KEY configurado no ficheiro .env

Custo

• $0.07/imagem（openai/gpt-image-2）
• ~$1.4 por 20 imagens

---

Configuração

Preparação — Obter OPENAI_API_KEY

1. Aceda a platform.openai.com e gere a sua chave de API
2. Abra .opengoat\.env com o VS Code e adicione a seguinte linha:

OPENAI_API_KEY=sk-cole-a-sua-chave-aqui

3. Guarde o ficheiro（Ctrl+S）

4. Inicie o OpenClaw Gateway no terminal do VS Code:

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

Passo 1 — Transfira o ZIP e execute o install.bat

Transfira o ZIP pelo botão acima, extraia e faça duplo clique em install.bat.

✅ Os ficheiros serão configurados automaticamente em C:\Users\[username]\.opengoat\skills\balia-design\

Passo 2 — Concluir a configuração com o assistente de IA

Abra o claude.ai, cole o prompt abaixo e envie. De seguida, basta seguir as instruções do Claude para concluir.

▶ Cole isto na IA para começar

É o assistente de configuração do BALIA OS.
Ajude-me passo a passo a configurar a competência balia-design.

【O meu ambiente】
- BALIA OS T1 instalado
- VS Code + Claude Code + OpenClaw Gateway em execução
- install.bat executado（ficheiros configurados）

【Pedido】
- Mostre os comandos a executar um de cada vez
- Quando colar o resultado do terminal aqui, diga-me o próximo passo
- Se houver um erro, diga-me a causa e a solução
- Se o Security Guardian fizer perguntas, diga-me como responder

Por favor, diga-me o primeiro comando a executar.

✅ O Claude dirá passo a passo "cole isto no terminal do VS Code" ✅ Se o Security Guardian fizer perguntas, cole o conteúdo do terminal exatamente como está no Claude e ele dir-lhe-á o próximo comando ✅ Se houver erros, o Claude explicará a causa e a solução

As 5 perguntas do Security Guardian（referência）:

Pergunta do Security Guardian	Exemplo de resposta
Quem é o agente responsável?	Maya
Qual é o setor do negócio?	Marketing em redes sociais para cafetaria
Qual é o tamanho?	1080×1080px（Instagram）, 1200×628px（banner）
Qual é o tema de cores?	Pastel・natural・base branca
Qual é o estilo de fonte?	Sans-serif moderno・simples e legível

Após responder as 5 perguntas, o ficheiro de configuração do agente será gerado automaticamente e a configuração estará concluída.

Passo 3 — Verificação

Após a configuração, o seguinte deve estar concluído:

• OPENAI_API_KEY: configurado e válido
• _SKILL_STATUS.md: STATUS: ON
• Banner de teste gerado com sucesso（guardado em workspaces\designs\）

---

Prompt de pedido de design

Após concluir a configuração, cole o seguinte no claude.ai para solicitar designs:

▶ Cole isto na IA para começar

É o assistente de design do BALIA OS.
Ajude-me a criar designs usando a competência balia-design.

【Pedido】
- Tipo:（ex: folheto / banner / publicação no Instagram / logótipo）
- Setor / Nome do negócio:（ex: restaurante "さくら"）
- Mensagem a transmitir:（ex: nova ementa / campanha sazonal）
- Preferência de cor:（ex: estilo japonês / moderno e pop / premium）
- Conteúdo de texto:（nome do negócio, slogan, morada, telefone, horário, etc.）
- Cor da marca:（se tiver código HEX, inclua）

Diga-me o comando que devo colar no terminal do VS Code.

---

Resolução de problemas

Problema	Solução
Aviso ao executar install.bat	Clique em "Mais informações" → "Executar mesmo assim"
Erro 401 ao gerar imagens	Abra .opengoat\.env no VS Code e verifique OPENAI_API_KEY
Imagens geradas pelo Google como alternativa	Cole o erro no claude.ai e ele dará a solução
Erro 403 no Discord	Cole o erro no claude.ai e ele dará a solução
Erro ao iniciar Gateway	Execute $env:DEBUG="-ciao*"; openclaw gateway --force no terminal do VS Code
Não sei qual comando usar	Explique a situação no claude.ai e ele fornecerá o comando adequado

Sobre o design de agentes autónomos

o balia-design adota a forma fundamental de agentes autónomos.

Apenas 1 configuração de agente é necessária na instalação

Não é necessário preparar configurações para todos os agentes na instalação. Basta configurar 1 agente (o SPEC e SOUL do agente designado) e funcionará.

Agentes não registados geram a sua própria configuração de forma autónoma

Quando um agente sem ficheiro SPEC/SOUL dedicado tenta usar o balia-design:

1. Gera automaticamente a sua própria configuração com base no SPEC/SOUL de um agente existente
2. Auto-reporta a conclusão ao Discord
3. Começa a trabalhar imediatamente

Não é necessário que humanos adicionem configurações manualmente.

Auto-reporte de erros

Mesmo quando a geração de imagens falha, os agentes respondem de forma autónoma:

• Repetição automática até 3 vezes
• Após 3 falhas, auto-reporta o conteúdo do erro ao Discord e termina

Esta é a forma fundamental de agentes autónomos que o BALIA OS procura.

---

Suporte

Para suporte, contacte support@balia-os.com.