openclaw-template

Template para criar agentes OpenClaw com acesso a dataroom via Dropbox.

Novo cliente em 5 minutos

# 1. Clonar o template
gh repo clone rmolines/openclaw-template nome-do-cliente-agent
cd nome-do-cliente-agent

# 2. Inicializar o projeto
chmod +x scripts/init-client.sh
./scripts/init-client.sh <client-id> <vps-ip> "/Nome do Dataroom no Dropbox"

# 3. Seguir o checklist impresso pelo script

O que está incluído

Arquivo	Descrição
Makefile	Comandos do dia-a-dia (make test, make logs, make status, make clear-session)
Dockerfile	Imagem Docker com OpenClaw + dependências do plugin
docker-compose.yml	Container com workspace bind-mount readonly e hardening de segurança
.github/workflows/deploy.yml	CI/CD: push em main → deploy automático via SSH
plugins/dropbox-dataroom/	Plugin genérico para leitura de dataroom no Dropbox
workspace/AGENTS.md	Template de instruções e roteamento do agente
workspace/SOUL.md	Persona e princípios do agente
workspace/IDENTITY.md	Nome e descrição do agente

Melhorias em relação ao projeto original

• DATAROOM_ROOT lido do .env (não hardcoded)
• Sheet targeting em dataroom_read (parâmetro sheet)
• Logging estruturado JSON em todas as tool calls
• Workspace bind-mount com flag :ro (readonly)
• Deploy via usuário deploy (não root)
• IP do VPS em GitHub Secret (não hardcoded no workflow)
• Smoke test automático após cada deploy

GitHub Secrets necessários

Secret	Valor
DROPLET_HOST	IP do VPS
DROPLET_SSH_KEY	Chave privada SSH do usuário deploy

Comandos do dia-a-dia

make test MSG="qual o EBITDA de 2023?"  # rodar um turn do agente
make logs                                 # logs em tempo real
make jlogs                               # só logs estruturados (JSON)
make status                              # visão consolidada de saúde
make clear-session                       # limpar sessão stale
make deploy-fast                         # deploy sem esperar CI