@fabioforest/openclaw 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +88 -0
  2. package/bin/openclaw.js +152 -0
  3. package/lib/channels.js +84 -0
  4. package/lib/cli/debug.js +12 -0
  5. package/lib/cli/doctor.js +266 -0
  6. package/lib/cli/init.js +145 -0
  7. package/lib/cli/orchestrate.js +43 -0
  8. package/lib/cli/status.js +128 -0
  9. package/lib/cli/update.js +122 -0
  10. package/lib/config.js +68 -0
  11. package/lib/detect.js +49 -0
  12. package/lib/ops/audit.js +156 -0
  13. package/lib/ops/enroll.js +133 -0
  14. package/lib/ops/exec.js +140 -0
  15. package/lib/ops/healthcheck.js +167 -0
  16. package/lib/ops/policy.js +153 -0
  17. package/lib/ops/transfer.js +152 -0
  18. package/lib/ops/update-safe.js +173 -0
  19. package/lib/ops/vpn.js +131 -0
  20. package/lib/security.js +48 -0
  21. package/lib/setup/config_wizard.js +186 -0
  22. package/package.json +47 -0
  23. package/templates/.agent/agents/setup-specialist.md +24 -0
  24. package/templates/.agent/agents/sysadmin-proativo.md +31 -0
  25. package/templates/.agent/hooks/pre-tool-use.js +109 -0
  26. package/templates/.agent/rules/SECURITY.md +7 -0
  27. package/templates/.agent/skills/openclaw-installation-debugger/SKILL.md +37 -0
  28. package/templates/.agent/skills/openclaw-installation-debugger/scripts/debug.js +165 -0
  29. package/templates/.agent/skills/openclaw-ops/01-openclaw-vpn-wireguard/SKILL.md +20 -0
  30. package/templates/.agent/skills/openclaw-ops/02-openclaw-enroll-host/SKILL.md +14 -0
  31. package/templates/.agent/skills/openclaw-ops/03-openclaw-policy-baseline/SKILL.md +17 -0
  32. package/templates/.agent/skills/openclaw-ops/04-openclaw-remote-exec-runbooks/SKILL.md +13 -0
  33. package/templates/.agent/skills/openclaw-ops/05-openclaw-file-transfer-safe/SKILL.md +10 -0
  34. package/templates/.agent/skills/openclaw-ops/06-openclaw-audit-logging/SKILL.md +13 -0
  35. package/templates/.agent/skills/openclaw-ops/07-openclaw-safe-update/SKILL.md +9 -0
  36. package/templates/.agent/skills/openclaw-ops/08-openclaw-healthchecks/SKILL.md +10 -0
  37. package/templates/.agent/skills/universal-setup/SKILL.md +26 -0
  38. package/templates/.agent/workflows/doctor.md +20 -0
  39. package/templates/.agent/workflows/healthcheck.md +22 -0
  40. package/templates/.agent/workflows/healthcheck.runbook.md +9 -0
  41. package/templates/.agent/workflows/restart.md +20 -0
  42. package/templates/.agent/workflows/restart.runbook.md +8 -0
  43. package/templates/.agent/workflows/setup.md +18 -0
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: openclaw-file-transfer-safe
3
+ description: Transferência de arquivos via VPN com allowlist de diretórios, hashing, limites e auditoria.
4
+ version: 1.0
5
+ ---
6
+ # Checklist
7
+ - allowlist de diretórios
8
+ - SHA-256 antes/depois
9
+ - tamanho máximo
10
+ - auditoria (who/when/host/path/hash)
@@ -0,0 +1,13 @@
1
+ ---
2
+ name: openclaw-audit-logging
3
+ description: Auditoria estruturada (JSON) para VPN/enroll/policy/exec/transfer/update/health. Inclui retenção e redaction de segredos.
4
+ version: 1.0
5
+ ---
6
+ # Objetivo
7
+ Logar tudo com request_id e sem vazar segredos.
8
+
9
+ # Eventos
10
+ - vpn.peer_added/removed
11
+ - host.approved/revoked
12
+ - policy.changed
13
+ - exec.started/finished/denied
@@ -0,0 +1,9 @@
1
+ ---
2
+ name: openclaw-safe-update
3
+ description: Atualização segura com verificação (hash/assinatura), canary e rollback automático.
4
+ version: 1.0
5
+ ---
6
+ # Checklist
7
+ - canary 1 host
8
+ - healthcheck pós-update
9
+ - rollback se falhar
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: openclaw-healthchecks
3
+ description: Heartbeat via VPN, alertas e autocura com limites; circuit breaker para bloquear exec quando instável.
4
+ version: 1.0
5
+ ---
6
+ # Checklist
7
+ - heartbeat 15s
8
+ - detectar queda WG
9
+ - bloquear exec em degraded
10
+ - auto-restart com limites
@@ -0,0 +1,26 @@
1
+ ---
2
+ name: universal-setup
3
+ description: Setup universal e seguro do OpenClaw em VPS, Windows (incl. WSL2), Mac ou Docker. Configura gateway, auth token, canais, persistência e hardening básico.
4
+ version: 1.1
5
+ author: OpenClaw DevOps
6
+ ---
7
+
8
+ # Universal Setup (Wizard)
9
+ Esta skill roda um assistente interativo que:
10
+ - Detecta ambiente (Docker / Linux VPS / Linux local / macOS / Windows)
11
+ - Garante `gateway.bind = 127.0.0.1` e `auth.mode = token`
12
+ - Cria templates de memória (MEMORY.md, SOUL.md) se faltarem
13
+ - Configura canais (Telegram/Discord) com validação básica
14
+ - Sugere hardening em VPS (usuário não-root, firewall, fail2ban)
15
+ - Oferece opção de acesso a arquivos locais com **princípio do menor privilégio**
16
+ (o usuário escolhe quais pastas o agente pode acessar)
17
+
18
+ ## Como usar
19
+ - `npx openclaw setup`
20
+ ou peça no chat:
21
+ - "rodar setup universal"
22
+ - "configure meu ambiente"
23
+
24
+ ## Segurança
25
+ - Nunca exponha o OpenClaw publicamente.
26
+ - Para acesso remoto, use VPN (WireGuard) e políticas (deny-by-default).
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: Diagnóstico completo do ambiente OpenClaw com verificações de segurança.
3
+ ---
4
+
5
+ ## Passos
6
+
7
+ 1. Executar diagnóstico completo
8
+ ```bash
9
+ openclaw doctor
10
+ ```
11
+
12
+ 2. Verificações realizadas:
13
+ - ✅ `openclaw.json` — bind, token, canais configurados
14
+ - ✅ Porta 18789 — serviço respondendo
15
+ - ✅ WireGuard — handshake recente (se VPN ativa)
16
+ - ✅ `.agent/` — integridade dos templates
17
+ - ✅ Hook `pre-tool-use` — bloqueio de comandos ativo
18
+ - ✅ Permissões — arquivos sensíveis com 0600
19
+
20
+ 3. Relatório final com ✅ (ok) ou ❌ (problema) + sugestões de correção
@@ -0,0 +1,22 @@
1
+ ---
2
+ description: Verifica saúde do OpenClaw (config, porta local, VPN) e gera relatório.
3
+ ---
4
+
5
+ ## Passos
6
+
7
+ 1. Verificar existência e validade de `openclaw.json`
8
+ - `bind` deve ser `127.0.0.1`
9
+ - `auth.mode` deve ser `token`
10
+ - Token deve existir e ter pelo menos 24 caracteres
11
+
12
+ 2. Checar porta 18789 em `127.0.0.1`
13
+ - Se não estiver em uso, alertar que o serviço pode estar parado
14
+
15
+ 3. Checar WireGuard handshake (se VPN configurada)
16
+ - `wg show wg0 latest-handshakes`
17
+ - Alertar se handshake > 5 minutos atrás
18
+
19
+ 4. Verificar integridade dos arquivos `.agent/`
20
+ - Confirmar que skills, agents e rules existem
21
+
22
+ 5. Emitir relatório ✅/❌ com sugestões de correção
@@ -0,0 +1,9 @@
1
+ ---
2
+ name: healthcheck
3
+ description: Verifica saúde do OpenClaw (config, porta local, VPN) e gera relatório.
4
+ ---
5
+ Passos:
6
+ 1) Verificar openclaw.json (bind/token)
7
+ 2) Checar porta 18789 em 127.0.0.1
8
+ 3) Checar WireGuard handshake (se aplicável)
9
+ 4) Emitir resumo
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: Reinicia serviço do OpenClaw de forma segura, registrando auditoria.
3
+ ---
4
+
5
+ ## Passos
6
+
7
+ 1. Detectar ambiente de execução (systemd, Docker, Windows)
8
+
9
+ 2. Registrar evento de restart na auditoria
10
+ - Incluir `request_id`, timestamp e operador
11
+
12
+ 3. Executar restart conforme ambiente:
13
+ - **systemd (Linux)**: `systemctl restart openclaw`
14
+ - **Docker**: `docker compose restart openclaw`
15
+ - **Windows**: Reiniciar serviço/daemon conforme instalação
16
+
17
+ 4. Aguardar 10s e verificar saúde pós-restart
18
+ - Rodar `/healthcheck` automaticamente
19
+
20
+ 5. Se healthcheck falhar, alertar operador e NÃO tentar restart adicional
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: restart-openclaw
3
+ description: Reinicia serviço do OpenClaw de forma segura, registrando auditoria.
4
+ ---
5
+ Passos:
6
+ - systemd (Linux): systemctl restart openclaw (se existir)
7
+ - Docker: docker compose restart openclaw
8
+ - Windows: reiniciar serviço/daemon conforme instalação
@@ -0,0 +1,18 @@
1
+ ---
2
+ description: Roda o wizard interativo de configuração do OpenClaw.
3
+ ---
4
+
5
+ ## Passos
6
+
7
+ 1. Executar wizard de setup universal
8
+ ```bash
9
+ openclaw setup
10
+ ```
11
+
12
+ 2. O wizard irá:
13
+ - Detectar ambiente (Docker / Linux VPS / macOS / Windows / WSL2)
14
+ - Configurar `openclaw.json` (bind, auth token)
15
+ - Configurar canais de comunicação (Telegram, Discord, WhatsApp)
16
+ - Sugerir hardening para VPS
17
+
18
+ 3. Após conclusão, rodar `/healthcheck` para validar a configuração