@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.
- package/README.md +88 -0
- package/bin/openclaw.js +152 -0
- package/lib/channels.js +84 -0
- package/lib/cli/debug.js +12 -0
- package/lib/cli/doctor.js +266 -0
- package/lib/cli/init.js +145 -0
- package/lib/cli/orchestrate.js +43 -0
- package/lib/cli/status.js +128 -0
- package/lib/cli/update.js +122 -0
- package/lib/config.js +68 -0
- package/lib/detect.js +49 -0
- package/lib/ops/audit.js +156 -0
- package/lib/ops/enroll.js +133 -0
- package/lib/ops/exec.js +140 -0
- package/lib/ops/healthcheck.js +167 -0
- package/lib/ops/policy.js +153 -0
- package/lib/ops/transfer.js +152 -0
- package/lib/ops/update-safe.js +173 -0
- package/lib/ops/vpn.js +131 -0
- package/lib/security.js +48 -0
- package/lib/setup/config_wizard.js +186 -0
- package/package.json +47 -0
- package/templates/.agent/agents/setup-specialist.md +24 -0
- package/templates/.agent/agents/sysadmin-proativo.md +31 -0
- package/templates/.agent/hooks/pre-tool-use.js +109 -0
- package/templates/.agent/rules/SECURITY.md +7 -0
- package/templates/.agent/skills/openclaw-installation-debugger/SKILL.md +37 -0
- package/templates/.agent/skills/openclaw-installation-debugger/scripts/debug.js +165 -0
- package/templates/.agent/skills/openclaw-ops/01-openclaw-vpn-wireguard/SKILL.md +20 -0
- package/templates/.agent/skills/openclaw-ops/02-openclaw-enroll-host/SKILL.md +14 -0
- package/templates/.agent/skills/openclaw-ops/03-openclaw-policy-baseline/SKILL.md +17 -0
- package/templates/.agent/skills/openclaw-ops/04-openclaw-remote-exec-runbooks/SKILL.md +13 -0
- package/templates/.agent/skills/openclaw-ops/05-openclaw-file-transfer-safe/SKILL.md +10 -0
- package/templates/.agent/skills/openclaw-ops/06-openclaw-audit-logging/SKILL.md +13 -0
- package/templates/.agent/skills/openclaw-ops/07-openclaw-safe-update/SKILL.md +9 -0
- package/templates/.agent/skills/openclaw-ops/08-openclaw-healthchecks/SKILL.md +10 -0
- package/templates/.agent/skills/universal-setup/SKILL.md +26 -0
- package/templates/.agent/workflows/doctor.md +20 -0
- package/templates/.agent/workflows/healthcheck.md +22 -0
- package/templates/.agent/workflows/healthcheck.runbook.md +9 -0
- package/templates/.agent/workflows/restart.md +20 -0
- package/templates/.agent/workflows/restart.runbook.md +8 -0
- 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,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
|