@fabioforest/openclaw 3.4.0 → 3.5.0

package/README.md

@@ -1,73 +1,623 @@
-# OpenClaw OS
+# 🦀 OpenClaw AI OS
 
-CLI e starter kit para configuração segura do OpenClaw em VPS, Mac, Windows e Docker.
+**Sistema universal de agentes para IDEs** — instale, configure e use via chat ou terminal.
 
-## Instalação
+O OpenClaw transforma qualquer projeto em um workspace inteligente com skills, regras de segurança e roteamento econômico de modelos de IA. Funciona em **Cursor, VSCode, Gemini Code Assist, Antigravity** e qualquer IDE com suporte a agentes.
+
+---
+
+## 📦 Instalação
+
+### Opção 1: Via npx (recomendado — sem instalar nada)
 
 ```bash
-# Via npx (recomendado)
+# Simula o que será feito (modo seguro, não altera nada)
 npx @fabioforest/openclaw init
 
-# Ou instale globalmente
+# Instala de fato no projeto
+npx @fabioforest/openclaw init --apply
+```
+
+### Opção 2: Instalação global
+
+```bash
 npm install -g @fabioforest/openclaw
-openclaw init
+openclaw init --apply
+```
+
+### Opção 3: Instalação completa para IDEs
+
+```bash
+# Instala o "AI OS" com skills, rules, state e hooks
+npx @fabioforest/openclaw ide install --apply
+```
+
+> **💡 Dica**: Todos os comandos operam em **modo PLAN por padrão** (read-only). Nada é alterado sem `--apply`.
+
+---
+
+## 🎯 Quando usar cada comando
+
+### Resumo rápido
+
+| Situação | Comando | O que faz |
+|----------|---------|-----------|
+| Primeira vez no projeto | `init --apply` | Cria `.agent/` com templates |
+| Atualizar skills/rules | `update --apply` | Atualiza preservando customizações |
+| Desinstalar do projeto | `uninstall --apply` | Remove `.agent/` com backup |
+| Ver o que está instalado | `status` | Lista componentes e config |
+| Algo não funciona | `doctor` | Diagnóstico completo |
+| Quero entender meu ambiente | `inspect` | Análise 100% read-only |
+| Preciso de ajuda geral | `assist` | Assistente com roteamento de skills |
+| Instalar AI OS na IDE | `ide install --apply` | Skills + rules + state + hooks |
+| Verificar IDE configurada | `ide doctor` | Checa se tudo está "armado" |
+| Configurar do zero | `setup` | Wizard interativo passo a passo |
+| Problemas de rede/VPN | `debug` | Diagnóstico de conectividade |
+| Instalar ou reparar (automático) | `check` | Orquestrador inteligente |
+
+---
+
+## 📖 Manual de Uso Detalhado
+
+### `openclaw init` — Instalar no projeto
+
+**Quando usar:** Primeira vez que você quer adicionar o OpenClaw a um projeto.
+
+```bash
+# 1. Primeiro, simule para ver o que vai acontecer
+npx @fabioforest/openclaw init
+#    → Mostra plano: "CREATE .agent/", "COPY templates", "CREATE openclaw.json"
+#    → Nenhum arquivo é criado
+
+# 2. Se estiver tudo certo, aplique
+npx @fabioforest/openclaw init --apply
+#    → Cria .agent/ com skills, rules, hooks e workflows
+#    → Cria openclaw.json com configurações default
+
+# 3. Se já existe e quer sobrescrever (exige confirmação forte)
+npx @fabioforest/openclaw init --apply --force
+#    → Pede para digitar "DESTROY .agent" para confirmar
+```
+
+**Flags disponíveis:**
+
+| Flag | O que faz |
+|------|-----------|
+| `--apply` | Executa de fato (sem isso, só simula) |
+| `--force` | Permite sobrescrever `.agent/` existente |
+| `--path ./dir` | Instala em outro diretório |
+| `--yes` | Pula confirmações interativas |
+| `--no-audit` | Não gera log de auditoria |
+
+---
+
+### `openclaw update` — Atualizar templates
+
+**Quando usar:** Quando sair uma versão nova do OpenClaw e você quiser atualizar skills/rules sem perder customizações.
+
+```bash
+# Simula a atualização (mostra o que mudou)
+npx @fabioforest/openclaw update
+
+# Aplica a atualização
+npx @fabioforest/openclaw update --apply
+
+# Merge seguro (preserva customizações)
+npx @fabioforest/openclaw update --apply --merge
 ```
 
-## Comandos
+**Como funciona:**
+- Compara cada arquivo por hash SHA-256
+- Se você customizou um arquivo, faz backup (`.bak`) antes de atualizar
+- Novos templates são copiados normalmente
+- Tudo é registrado em `.agent/audit/`
+
+---
 
-| Comando | Descrição |
-|---------|-----------|
-| `openclaw init` | Instala templates `.agent/` no projeto |
-| `openclaw update` | Atualiza templates preservando customizações |
-| `openclaw status` | Mostra status da instalação |
-| `openclaw doctor` | Healthcheck automatizado do ambiente |
-| `openclaw setup` | Roda wizard interativo de configuração |
+---
 
-### Opções
+### `openclaw uninstall` — Desinstalar do projeto
+
+**Quando usar:** Quando quiser remover completamente o OpenClaw de um projeto.
 
 ```bash
-openclaw init --force          # Sobrescreve .agent/ existente
-openclaw init --path ./dir     # Instala em diretório específico
-openclaw doctor --quiet        # Saída mínima
+# 1. Simula a remoção (mostra o que seria deletado)
+npx @fabioforest/openclaw uninstall
+#    → Mostra tree de .agent/ e openclaw.json
+#    → Alerta sobre audit logs e state que seriam perdidos
+#    → Nenhum arquivo é removido
+
+# 2. Aplica a remoção (com backup automático)
+npx @fabioforest/openclaw uninstall --apply
+#    → Pede para digitar "UNINSTALL" como confirmação
+#    → Oferece fazer backup (.agent.backup-<timestamp>/)
+#    → Remove .agent/ e openclaw.json
+#    → Salva log de auditoria no diretório
+
+# 3. Remoção forçada (sem backup, com --yes pula confirmação)
+npx @fabioforest/openclaw uninstall --apply --force --yes
+```
+
+**Saída de exemplo (modo PLAN):**
+
 ```
+🗑️  OpenClaw Uninstall
+
+   📂 Diretório: /home/user/meu-projeto
+
+   🔴 REMOVER  .agent/ (25 arquivos)
+      📁 agents (3 arquivos)
+      📁 audit (1 arquivos)
+      📁 hooks (1 arquivos)
+      📁 rules (5 arquivos)
+      📁 skills (11 arquivos)
+      📁 workflows (7 arquivos)
+   🔴 REMOVER  openclaw.json
+
+   ⚠️  1 log(s) de auditoria serão perdidos!
+
+🔒 Modo PLAN (Read-Only). Nenhuma alteração feita.
+   Para desinstalar, rode: npx @fabioforest/openclaw uninstall --apply
+```
+
+---
 
-## O que é instalado
+### `openclaw inspect` — Analisar ambiente (read-only)
 
-O comando `init` cria a seguinte estrutura no seu projeto:
+**Quando usar:** Antes de qualquer ação, para entender o contexto. 100% read-only — nunca altera nada.
+
+```bash
+npx @fabioforest/openclaw inspect
+```
+
+**Saída de exemplo:**
+
+```
+🔎 OpenClaw Inspect (Read-Only)
+
+   🖥️  Plataforma: darwin
+   🐳 Docker: false
+   🪟 WSL: false
+   💻 IDE: cursor
+   📂 Path: /home/user/meu-projeto
+   📦 OpenClaw instalado: Sim
+   📋 Config: Sim
+   🐙 Git repo: Sim
+
+   🧠 Skills instaladas (15):
+      • content-sourcer    • context-flush
+      • drive-organizer    • linkedin-optimizer
+      • mission-control    • openclaw-router
+      • smart-router       • web-scraper
+      ...
+
+✅ Inspect concluído (nenhuma alteração feita).
+```
+
+**Modo JSON (para automações):**
+
+```bash
+npx @fabioforest/openclaw inspect --quiet
+# → Retorna JSON puro, ideal para pipes e scripts
+```
+
+---
+
+### `openclaw assist` — Assistente geral com roteamento
+
+**Quando usar:** Quando não sabe qual skill usar. O assist analisa sua solicitação e sugere a skill mais adequada.
+
+```bash
+npx @fabioforest/openclaw assist
+```
+
+**Como funciona:**
+1. Detecta contexto (IDE, plataforma, skills disponíveis)
+2. Pede sua solicitação em linguagem natural
+3. Roteia para a skill mais relevante via triggers
+4. Mostra alternativas e protocolo recomendado
+
+**Exemplo de interação:**
+
+```
+🧠 OpenClaw Assist — Modo PLAN por padrão (seguro)
+   IDE: cursor | OpenClaw: instalado
+
+Descreva o que deseja fazer:
+> otimizar meu perfil do linkedin
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Skill selecionada: linkedin-optimizer
+   Descrição: Ajuda a otimizar perfil e posts para LinkedIn
+
+   Alternativas:
+      • content-sourcer: Busca fontes públicas
+      • smart-router: Roteia para perfis de modelo
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### `openclaw ide install` — Instalar AI OS na IDE
+
+**Quando usar:** Para preparar sua IDE para usar o OpenClaw como agente via chat. Instala skills, rules, hooks e state templates.
+
+```bash
+# Simula a instalação (mostra o plano)
+npx @fabioforest/openclaw ide install
+
+# Aplica a instalação
+npx @fabioforest/openclaw ide install --apply
+
+# Força reinstalação completa
+npx @fabioforest/openclaw ide install --apply --force
+```
+
+**O que é instalado:**
 
 ```
 .agent/
-├── agents/            # Personas de agente (ex: sysadmin-proativo)
-├── hooks/             # Hooks de segurança (PreToolUse)
-├── rules/             # Guardrails de segurança
-├── skills/
-│   ├── universal-setup/   # Wizard de configuração interativo
-│   └── openclaw-ops/      # 8 skills operacionais
-└── workflows/         # Runbooks e slash commands
+├── agents/            # Personas (sysadmin, automator, setup)
+├── hooks/             # pre-tool-use.js (bloqueia comandos destrutivos)
+├── rules/             # 5 regras de segurança
+│   ├── CONSENT_FIRST.md
+│   ├── SECURITY.md
+│   ├── ROUTER_PROTOCOL.md
+│   ├── DEV_MODE.md
+│   └── WEB_AUTOMATION.md
+├── skills/            # 15 skills disponíveis
+│   ├── openclaw-router/       # Roteador central chat-first
+│   ├── openclaw-inspect/      # Inspeção read-only
+│   ├── smart-router/          # Roteador econômico de modelos
+│   ├── mission-control/       # Empresa de Agentes
+│   ├── linkedin-optimizer/    # Otimização de LinkedIn
+│   ├── drive-organizer/       # Google Drive via API
+│   ├── site-tester/           # Lighthouse + Playwright
+│   ├── web-scraper/           # Scraping responsável
+│   ├── content-sourcer/       # Pesquisa de fontes
+│   └── ... (+ 6 skills operacionais)
+├── state/             # Estado persistente
+│   ├── mission_control.json   # Empresa de Agentes
+│   └── MEMORY.md              # Memória do workspace
+└── workflows/         # Slash commands e runbooks
+```
+
+---
+
+### `openclaw ide doctor` — Verificar IDE
+
+**Quando usar:** Para confirmar que sua IDE está "armada" com todas as regras e skills necessárias.
+
+```bash
+npx @fabioforest/openclaw ide doctor
 ```
 
-### Skills Operacionais
+**Saída de exemplo:**
+
+```
+🏥 IDE Doctor — Verificando instalação para IDE:
 
-| # | Skill | Descrição |
-|---|-------|-----------|
-| 01 | VPN WireGuard | Provisiona VPN entre VPS e hosts |
-| 02 | Enroll Host | Onboarding com aprovação humana |
-| 03 | Policy Baseline | RBAC + allowlists deny-by-default |
-| 04 | Remote Exec | Runbooks com timeout e auditoria |
-| 05 | File Transfer | Transferência com hash e allowlist |
-| 06 | Audit Logging | Log JSON com redaction de segredos |
-| 07 | Safe Update | Canary + rollback automático |
-| 08 | Healthchecks | Circuit breaker + auto-restart |
+   ✅ .agent/
+   ✅ rules/CONSENT_FIRST.md
+   ✅ rules/ROUTER_PROTOCOL.md
+   ✅ skills/openclaw-router/SKILL.md
+   ✅ skills/openclaw-inspect/SKILL.md
+   ✅ skills/openclaw-dev/SKILL.md
+   ✅ hooks/pre-tool-use.js
 
-## Segurança
+🎉 IDE está totalmente configurada!
+```
 
-- **VPN-first** — sem VPN, sem acesso remoto
-- **bind localhost** + **auth token** por padrão
-- **Hook `pre-tool-use`** — bloqueia comandos destrutivos (`rm -rf`, `mkfs`, `dd`, `shutdown`)
-- **Break-glass** — acesso emergencial com expiração automática
-- **Auditoria** — todos os eventos logados com `request_id`
+---
 
-## Desenvolvimento
+### `openclaw status` — Ver status da instalação
+
+**Quando usar:** Para ver rapidamente o que está instalado e configurado.
+
+```bash
+npx @fabioforest/openclaw status
+```
+
+Mostra: componentes instalados, versão, config ativa (com tokens mascarados).
+
+---
+
+### `openclaw doctor` — Healthcheck completo
+
+**Quando usar:** Quando algo não funciona. Faz diagnóstico completo do ambiente.
+
+```bash
+npx @fabioforest/openclaw doctor
+npx @fabioforest/openclaw doctor --quiet  # Saída mínima
+```
+
+Verifica: config, portas, VPN, integridade de arquivos, dependências.
+
+---
+
+### `openclaw setup` — Wizard interativo
+
+**Quando usar:** Primeira configuração completa com perguntas guiadas.
+
+```bash
+npx @fabioforest/openclaw setup
+```
+
+Guia passo a passo para configurar ambiente, modelo de IA, canais e segurança.
+
+---
+
+### `openclaw check` — Orquestrador inteligente
+
+**Quando usar:** Quando não sabe se precisa instalar ou reparar. Ele decide por você.
+
+```bash
+npx @fabioforest/openclaw check
+```
+
+Detecta se o OpenClaw já existe e oferece opções: instalar, atualizar, reparar ou forçar.
+
+---
+
+### `openclaw debug` — Diagnóstico avançado
+
+**Quando usar:** Problemas de rede, VPN, npm ou GitHub.
+
+```bash
+npx @fabioforest/openclaw debug
+```
+
+Verifica conectividade, proxy, versões e integridade do ambiente.
+
+---
+
+## 🧠 Skills Disponíveis (15)
+
+### Core — Infraestrutura do AI OS
+
+| Skill | O que faz | Quando usar |
+|-------|-----------|-------------|
+| `openclaw-router` | Roteador central chat-first | Sempre ativo — decide qual skill usar |
+| `openclaw-inspect` | Inspeção read-only | Para analisar sem alterar |
+| `openclaw-dev` | Modo Devin-like | Para criar features, backend, frontend |
+| `openclaw-security` | Hardening | Para melhorar segurança do workspace |
+| `openclaw-assist` | Assistente geral | Para menu de ações e ajuda |
+| `mission-control` | Empresa de Agentes | Para orquestrar múltiplos agentes |
+| `smart-router` | Roteador econômico | Para escolher modelo de IA por custo |
+| `context-flush` | Flush de memória | Para economizar tokens em sessões longas |
+
+### Produtividade — Automação e Web
+
+| Skill | O que faz | Quando usar |
+|-------|-----------|-------------|
+| `linkedin-optimizer` | Textos para LinkedIn | Para otimizar perfil/posts (human-in-the-loop) |
+| `drive-organizer` | Google Drive via API | Para organizar arquivos na nuvem |
+| `site-tester` | Lighthouse + Playwright | Para testar performance/SEO/acessibilidade |
+| `web-scraper` | Scraping responsável | Para extrair dados de sites |
+| `content-sourcer` | Pesquisa de fontes | Para criar dossiês citáveis |
+
+### Operacionais — DevOps e Infra
+
+| Skill | O que faz | Quando usar |
+|-------|-----------|-------------|
+| `universal-setup` | Setup em qualquer ambiente | Para instalação em VPS/Docker/Mac/Windows |
+| `openclaw-installation-debugger` | Debug de instalação | Para resolver problemas de setup |
+
+---
+
+## 🔒 Segurança
+
+O OpenClaw segue 3 princípios fundamentais:
+
+### 1. Read-only por padrão
+Todo comando opera em **modo PLAN** (simulação). Nada é alterado sem `--apply`.
+
+### 2. Consent-first
+Antes de qualquer alteração, o sistema mostra exatamente o que vai fazer e pede confirmação. Ações destrutivas exigem **confirmação forte** (digitar frase específica).
+
+### 3. Audit-first
+Toda ação gera log detalhado em `.agent/audit/` com timestamp, comando, modo, contexto e resultado.
+
+### Proteções ativas
+
+| Proteção | Como funciona |
+|----------|---------------|
+| **Hook pre-tool-use** | Bloqueia 12+ padrões destrutivos (`rm -rf`, `mkfs`, `dd`, `shutdown`) |
+| **VPN-first** | Sem VPN, sem acesso remoto |
+| **Bind localhost** | Serviços só acessíveis localmente por padrão |
+| **Auth token** | Token obrigatório para acesso |
+| **Break-glass** | Acesso emergencial com expiração automática |
+| **WEB_AUTOMATION rule** | Checklist de compliance para automação web |
+
+---
+
+## 💰 Roteador Econômico de Modelos
+
+O `smart-router` escolhe automaticamente o modelo de IA mais econômico para cada tarefa:
+
+| Perfil | Quando | Provedor default (free) |
+|--------|--------|------------------------|
+| **cheap** | Tarefas simples, formatação, resumos | Gemini Flash-Lite → Groq |
+| **smart** | Planejamento, análise, raciocínio | Gemini Pro → Claude |
+| **coding** | Código, debug, refactor, testes | Gemini Pro → GPT-5.2 |
+
+Prioridade: **free-first** — só usa provedores pagos com autorização explícita.
+
+---
+
+## 🚀 Guia Rápido: Do Zero ao Funcionando
+
+```bash
+# 1. Instale no seu projeto
+npx @fabioforest/openclaw ide install --apply
+
+# 2. Verifique se está tudo OK
+npx @fabioforest/openclaw ide doctor
+
+# 3. Analise seu ambiente
+npx @fabioforest/openclaw inspect
+
+# 4. Use o assistente
+npx @fabioforest/openclaw assist
+```
+
+**Ou via chat na IDE (Cursor, VSCode, Antigravity, Gemini):**
+- Basta perguntar no chat! As skills e rules em `.agent/` guiam o agente automaticamente.
+- O `openclaw-router` decide qual skill usar com base nos triggers de cada uma.
+- Tudo segue o fluxo: **INSPECT → PLAN → CONSENT → APPLY → AUDIT**.
+
+---
+
+## 💬 Exemplo Real: Usando o OpenClaw na IDE (Chat)
+
+O OpenClaw funciona como agente via chat na IDE. Aqui está uma simulação de como seria o fluxo real:
+
+### Exemplo 1: Otimizar perfil do LinkedIn
+
+```
+👤 Você (chat na IDE):
+   "Quero otimizar meu perfil do LinkedIn para vagas de AI Engineer"
+
+🤖 Agente (openclaw-router detecta: linkedin-optimizer):
+   📋 INSPECT ─ Coletando contexto:
+      • Objetivo: otimizar perfil LinkedIn para AI Engineer
+      • Idioma: pt-BR
+      • Skills instaladas: linkedin-optimizer ✅
+
+   📝 PLAN ─ Proposta de ações:
+      1. Analisar headline atual e propor 2 versões A/B
+      2. Reescrever seção "Sobre" com keywords de AI/MLOps
+      3. Sugerir ajustes nas experiências com métricas
+      4. Gerar checklist de publicação
+
+   ⚠️  RESTRIÇÃO: LinkedIn proíbe automação. Todo conteúdo
+       será gerado como rascunho para aplicação manual.
+
+   Deseja prosseguir? (S/n)
+
+👤 Você: "S"
+
+🤖 Agente:
+   ✅ APPLY ─ Rascunhos salvos em .agent/state/linkedin/drafts.md
+
+   ## Headline (opção A)
+   "AI Engineer | MLOps | Python | RAG & LLMs | Open Source"
+
+   ## Headline (opção B)
+   "Engenheiro de IA | Construindo pipelines de ML em produção"
+
+   📝 AUDIT ─ log salvo em .agent/audit/
+```
+
+### Exemplo 2: Testar performance de um site
+
+```
+👤 Você:
+   "Testa a performance do meu site https://meu-portfolio.dev"
+
+🤖 Agente (openclaw-router detecta: site-tester):
+   📋 INSPECT:
+      • URL: https://meu-portfolio.dev
+      • robots.txt: verificado ✅
+      • Ferramentas disponíveis: PageSpeed Insights API
+
+   📝 PLAN:
+      1. Rodar Lighthouse via PageSpeed Insights (sem infra local)
+      2. Coletar métricas: Performance, SEO, Acessibilidade, PWA
+      3. Listar as 5 principais oportunidades de melhoria
+      4. Salvar relatório em .agent/state/site-tests/
+
+   Confirmar execução?
+
+👤 Você: "sim"
+
+🤖 Agente:
+   ✅ Resultados:
+      • Performance: 87 → otimizar imagens (ganho estimado: +8pts)
+      • SEO: 95 ✅
+      • Acessibilidade: 72 → falta alt em 3 imagens + contraste baixo
+      • PWA: 60 → falta manifest.json e service worker
+
+   📊 Relatório salvo em .agent/state/site-tests/2026-02-19.json
+   📝 Audit salvo
+```
+
+### Exemplo 3: Atualizar skills após nova versão
+
+```
+👤 Você:
+   "Saiu versão nova do OpenClaw, como atualizo?"
+
+🤖 Agente (openclaw-router detecta: assist):
+   Recomendo o seguinte fluxo:
+
+   1. Primeiro, veja o que mudaria (modo PLAN, seguro):
+      $ npx @fabioforest/openclaw update
+
+   2. Se estiver tudo OK, aplique:
+      $ npx @fabioforest/openclaw update --apply
+
+   3. Para preservar customizações:
+      $ npx @fabioforest/openclaw update --apply --merge
+
+   O update faz backup automático de arquivos customizados
+   antes de sobrescrever, e copia novos templates.
+
+   Quer que eu execute o passo 1 agora?
+```
+
+### Exemplo 4: Desinstalar o OpenClaw de um projeto
+
+```
+👤 Você:
+   "Quero remover o OpenClaw deste projeto"
+
+🤖 Agente:
+   Vou simular a remoção primeiro (modo PLAN, seguro):
+
+   $ npx @fabioforest/openclaw uninstall
+
+   🗑️  PLAN — Seria removido:
+      .agent/ (25 arquivos, 15 skills, 5 rules)
+      openclaw.json
+      ⚠️  3 logs de auditoria seriam perdidos
+
+   Para aplicar de fato:
+   $ npx @fabioforest/openclaw uninstall --apply
+
+   O sistema vai pedir que você digite "UNINSTALL"
+   e oferecerá fazer backup antes de remover.
+
+   Quer que eu execute?
+```
+
+---
+
+## 🔄 Ciclo de Vida Completo
+
+```
+📦 INSTALAR        →  npx @fabioforest/openclaw init --apply
+                       ou: npx @fabioforest/openclaw ide install --apply
+
+🔍 INSPECIONAR     →  npx @fabioforest/openclaw inspect
+                       npx @fabioforest/openclaw status
+
+🛠️ USAR            →  Chat na IDE (skills + router fazem o resto)
+                       ou: npx @fabioforest/openclaw assist
+
+🔄 ATUALIZAR       →  npx @fabioforest/openclaw update --apply
+                       (preserva customizações com --merge)
+
+🏥 DIAGNOSTICAR    →  npx @fabioforest/openclaw doctor
+                       npx @fabioforest/openclaw debug
+
+🗑️ DESINSTALAR     →  npx @fabioforest/openclaw uninstall --apply
+                       (backup automático + confirmação forte)
+```
+
+---
+
+## 🛠️ Desenvolvimento
 
 ```bash
 # Instalar dependências
@@ -83,6 +633,25 @@ npm run test:watch
 npm run test:coverage
 ```
 
-## Licença
+---
+
+## 📋 Flags Globais
+
+Todas as flags funcionam com qualquer comando:
+
+| Flag | Descrição | Padrão |
+|------|-----------|--------|
+| `--plan` | Modo simulação (read-only) | **Sim** |
+| `--apply` | Modo execução (aplica alterações) | Não |
+| `--yes, -y` | Pula confirmações interativas | Não |
+| `--force, -f` | Permite operações destrutivas (sem backup no uninstall) | Não |
+| `--path, -p <dir>` | Diretório alvo | `./` |
+| `--quiet, -q` | Saída mínima | Não |
+| `--no-audit` | Desabilita logs de auditoria | Não |
+| `--merge` | Atualização segura (preserva customizações) | Não |
+
+---
+
+## 📄 Licença
 
 MIT

package/bin/openclaw.js

@@ -24,6 +24,7 @@ const pkg = require("../package.json");
 const COMMANDS = {
     init: "../lib/cli/init",
     update: "../lib/cli/update",
+    uninstall: "../lib/cli/uninstall",
     status: "../lib/cli/status",
     doctor: "../lib/cli/doctor",
     debug: "../lib/cli/debug",
@@ -92,6 +93,7 @@ function showHelp() {
   Comandos:
     init      Instala templates .agent/ no projeto atual
     update    Atualiza templates preservando customizações
+    uninstall Remove .agent/ e openclaw.json (com backup)
     status    Mostra status da instalação
     doctor    Healthcheck automatizado do ambiente
     setup     Roda wizard interativo de configuração

package/lib/cli/uninstall.js

@@ -0,0 +1,194 @@
+"use strict";
+
+/**
+ * Comando CLI: uninstall
+ *
+ * Remove a instalação do OpenClaw (.agent/) de um projeto.
+ * Segue o protocolo consent-first:
+ *   - Modo PLAN por padrão (mostra o que seria removido)
+ *   - Exige --apply para executar
+ *   - Exige confirmação forte (digitar frase)
+ *   - Backup opcional antes de remover
+ */
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const { detectContext, getAuditHeader } = require("../context");
+
+function ask(q) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((res) => rl.question(q, (ans) => { rl.close(); res(ans.trim()); }));
+}
+
+/**
+ * Conta arquivos recursivamente em um diretório.
+ */
+function countFiles(dir) {
+    let count = 0;
+    if (!fs.existsSync(dir)) return 0;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            count += countFiles(path.join(dir, entry.name));
+        } else {
+            count++;
+        }
+    }
+    return count;
+}
+
+/**
+ * Lista o conteúdo de um diretório de forma visual (tree).
+ */
+function listTree(dir, prefix = "") {
+    const lines = [];
+    if (!fs.existsSync(dir)) return lines;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    entries.forEach((entry, i) => {
+        const isLast = i === entries.length - 1;
+        const connector = isLast ? "└── " : "├── ";
+        const icon = entry.isDirectory() ? "📁" : "📄";
+        lines.push(`${prefix}${connector}${icon} ${entry.name}`);
+        if (entry.isDirectory()) {
+            const childPrefix = prefix + (isLast ? "    " : "│   ");
+            lines.push(...listTree(path.join(dir, entry.name), childPrefix));
+        }
+    });
+    return lines;
+}
+
+/**
+ * Executa o comando uninstall.
+ * @param {object} options
+ * @param {string} options.targetPath — diretório alvo
+ * @param {object} options.flags — flags do CLI
+ */
+async function run({ targetPath, flags }) {
+    const agentDir = path.join(targetPath, ".agent");
+    const configFile = path.join(targetPath, "openclaw.json");
+    const planMode = !flags.apply;
+    const ctx = detectContext(targetPath);
+
+    console.log("\n🗑️  OpenClaw Uninstall\n");
+
+    // Verificar se existe instalação
+    if (!fs.existsSync(agentDir) && !fs.existsSync(configFile)) {
+        console.log("ℹ️  Nenhuma instalação do OpenClaw encontrada neste diretório.");
+        console.log(`   Path: ${targetPath}`);
+        return;
+    }
+
+    // Mostrar o que será removido
+    console.log(`   📂 Diretório: ${targetPath}`);
+    console.log("");
+
+    const toRemove = [];
+
+    if (fs.existsSync(agentDir)) {
+        const fileCount = countFiles(agentDir);
+        toRemove.push({ path: agentDir, label: ".agent/", files: fileCount, isDir: true });
+        console.log(`   🔴 REMOVER  .agent/ (${fileCount} arquivos)`);
+
+        // Mostrar tree resumido (primeiro nível)
+        const entries = fs.readdirSync(agentDir, { withFileTypes: true });
+        entries.forEach(e => {
+            const icon = e.isDirectory() ? "📁" : "📄";
+            const subCount = e.isDirectory() ? ` (${countFiles(path.join(agentDir, e.name))} arquivos)` : "";
+            console.log(`      ${icon} ${e.name}${subCount}`);
+        });
+    }
+
+    if (fs.existsSync(configFile)) {
+        toRemove.push({ path: configFile, label: "openclaw.json", isDir: false });
+        console.log(`   🔴 REMOVER  openclaw.json`);
+    }
+
+    // Verificar audit logs que seriam perdidos
+    const auditDir = path.join(agentDir, "audit");
+    if (fs.existsSync(auditDir)) {
+        const auditCount = countFiles(auditDir);
+        if (auditCount > 0) {
+            console.log(`\n   ⚠️  ${auditCount} log(s) de auditoria serão perdidos!`);
+        }
+    }
+
+    // Verificar state que seria perdido
+    const stateDir = path.join(agentDir, "state");
+    if (fs.existsSync(stateDir)) {
+        const stateCount = countFiles(stateDir);
+        if (stateCount > 0) {
+            console.log(`   ⚠️  ${stateCount} arquivo(s) de estado serão perdidos (mission_control, MEMORY)!`);
+        }
+    }
+
+    // Modo PLAN: não faz nada
+    if (planMode) {
+        console.log("\n🔒 Modo PLAN (Read-Only). Nenhuma alteração feita.");
+        console.log("   Para desinstalar, rode: npx @fabioforest/openclaw uninstall --apply");
+        return;
+    }
+
+    // Modo APPLY: pedir confirmação forte
+    console.log("");
+    if (!flags.yes) {
+        const confirm = await ask("⚠️  Digite 'UNINSTALL' para confirmar a remoção: ");
+        if (confirm !== "UNINSTALL") {
+            console.log("⏹️  Cancelado. Nada foi removido.");
+            return;
+        }
+    }
+
+    // Backup opcional
+    if (!flags.force) {
+        const doBackup = flags.yes ? "s" : await ask("💾 Fazer backup antes de remover? (S/n): ");
+        if (doBackup.toLowerCase() !== "n") {
+            const backupName = `.agent.backup-${Date.now()}`;
+            const backupPath = path.join(targetPath, backupName);
+            try {
+                fs.cpSync(agentDir, backupPath, { recursive: true });
+                console.log(`   ✅ Backup criado: ${backupName}/`);
+            } catch (err) {
+                console.error(`   ⚠️  Falha no backup: ${err.message}`);
+                const cont = await ask("   Continuar sem backup? (y/N): ");
+                if (cont.toLowerCase() !== "y") {
+                    console.log("⏹️  Cancelado.");
+                    return;
+                }
+            }
+        }
+    }
+
+    // Executar remoção
+    const audit = [getAuditHeader(ctx, "uninstall", flags)];
+
+    try {
+        for (const item of toRemove) {
+            if (item.isDir) {
+                fs.rmSync(item.path, { recursive: true, force: true });
+            } else {
+                fs.unlinkSync(item.path);
+            }
+            console.log(`   ✅ Removido: ${item.label}`);
+            audit.push(`- ACT: REMOVED ${item.label}`);
+        }
+
+        console.log("\n✨ OpenClaw desinstalado com sucesso!");
+        console.log("   Para reinstalar: npx @fabioforest/openclaw init --apply\n");
+
+        // Gravar audit no diretório pai (já que .agent/ foi removido)
+        if (flags.audit !== false) {
+            const filename = `openclaw-uninstall-${new Date().toISOString().replace(/[:.]/g, "-")}.md`;
+            const auditPath = path.join(targetPath, filename);
+            try {
+                fs.writeFileSync(auditPath, audit.join("\n") + "\n", "utf8");
+                console.log(`   📝 Log de auditoria: ${filename}`);
+            } catch (e) { /* silencioso */ }
+        }
+
+    } catch (err) {
+        console.error(`\n❌ Falha: ${err.message}`);
+        process.exit(1);
+    }
+}
+
+module.exports = { run };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabioforest/openclaw",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "Agentes autônomos para engenharia de software",
   "publishConfig": {
     "access": "public"