🤖 O que é OpenClaw

OpenClaw é construído sobre o runtime Pi — um motor de agentes leve que orquestra skills, mantém contexto de conversa e se comunica com plataformas externas via WebSocket. O resultado é um agente completo que roda na sua máquina.

O SOUL.md é a alma do agente. Um arquivo Markdown simples que define quem ele é, o que ele sabe, o que pode fazer e como deve se comportar. É o único arquivo que você precisa dominar para customizar o OpenClaw.

# SOUL.md — Meu Segundo Cérebro

## Identidade
- **Nome:** Cleo
- **Personalidade:** direto, conciso, cita fontes sempre
- **Idioma:** Português Brasileiro

## Capacidades
- Consultar o vault Obsidian em /home/user/vault/
- Responder perguntas baseado apenas no conteúdo do wiki/
- Aceitar novos documentos via mensagem e salvar em raw/inbox/
- Disparar ingestão quando solicitado

## Fontes de Conhecimento
knowledge_base:
  path: /home/user/vault/wiki/
  index: /home/user/vault/index.md
  read_only: false
  allowed_write_paths:
    - /home/user/vault/raw/inbox/

## Skills Ativas
skills:
  - filesystem
  - cron
  - http

## Regras de Comportamento
- Sempre citar a página wiki/ de onde veio a informação
- Se não encontrar no wiki, dizer claramente "não tenho isso registrado"
- Confirmar antes de escrever qualquer arquivo
- Nunca inventar informações

## Cron Jobs
cron:
  - schedule: "0 8 * * *"
    action: daily_briefing
    channel: telegram
  - schedule: "0 * * * *"
    action: check_inbox

OpenClaw suporta mais de 20 plataformas de mensagens via adapters padronizados. Um único vault, todos os canais que você já usa — sem reconfigurar nada.

OpenClaw instala em menos de 10 minutos. Você precisa de Node.js 20+ (ou Bun) e as credenciais dos canais que vai usar. Nenhum dado sai da sua máquina.

git clone https://github.com/openclaw/openclaw
cd openclaw
bun install   # ou: npm install

# .env
TELEGRAM_BOT_TOKEN=seu_token_aqui
OPENAI_API_KEY=sk-...         # ou OLLAMA_BASE_URL para local
VAULT_PATH=/home/user/vault
SOUL_PATH=/home/user/vault/SOUL.md
PORT=3000

bun start
# Saída esperada:
# ✓ SOUL.md carregado
# ✓ Vault conectado: /home/user/vault (342 páginas wiki)
# ✓ Telegram: @meu_bot conectado
# ✓ OpenClaw pronto na porta 3000

# Com PM2
pm2 start bun --name openclaw -- start
pm2 save && pm2 startup

# Com systemd (Linux)
sudo cp openclaw.service /etc/systemd/system/
sudo systemctl enable --now openclaw

Skills são os superpoderes do agente. Cada skill é um módulo ativado via SOUL.md que concede ao OpenClaw uma nova capacidade — do simples acesso a arquivos até automações complexas com cron e browser.

## Skills Ativas
skills:
  - name: filesystem
    permissions:
      read: ["/vault/wiki/", "/vault/index.md"]
      write: ["/vault/raw/inbox/"]

  - name: cron
    jobs:
      - "0 8 * * *"  # 8h todo dia

  - name: http
    allowed_hosts: ["api.github.com"]

  - name: exec
    allowed_commands: ["claude"]
    timeout: 120s

A escolha entre self-hosted e cloud não é técnica — é uma questão de valores e requisitos. Para um segundo cérebro com dados pessoais e profissionais sensíveis, self-hosted é a única opção que faz sentido.