Cerebro Externo — Guia Completo

OpenClaw + Obsidian
Cerebro Externo

Agente AI com memoria real. OpenClaw como runtime, Obsidian como cerebro,
Syncthing como ponte, Skill Graph como arquitetura de conhecimento.

soier@telegram > mano, documenta essa integracao no cofre

▸ Lendo index.md → seguindo [[mocs/integrations]]

▸ Criando methods/nova-integracao.md com wikilinks para [[claims]] relevantes

▸ Atualizando backlog + inbox → sync via Syncthing → Obsidian atualizado

mano > feito. 3 nodes criados, 7 wikilinks adicionados, cofre sincronizado.

O que e esse setup (e por que funciona)

O Problema

Agentes AI sao poderosos, mas esquecemn tudo quando a sessao acaba. Cada conversa comeca do zero. Voce explica o mesmo contexto, repete as mesmas decisoes, refaz o mesmo trabalho.

Prompts do sistema ajudam, mas sao estaticos. Memoria in-session funciona, mas morre com a sessao. O que falta e uma camada de conhecimento que persista, cresca e seja navegavel.

A Solucao: Cerebro Externo

Conectar o agente a um cofre de conhecimento vivo que ele le e escreve. Nao um dump de texto — um grafo de notas interconectadas que o agente navega sob demanda.

O agente nao carrega tudo de uma vez. Ele entra pelo index, segue wikilinks, le so o que precisa. Progressive disclosure aplicado a memoria.

Agente Sem Cerebro

Esquece tudo entre sessoes
Contexto reexplicado toda vez
Decisoes repetidas
Sem historico operacional
Executa, mas nao aprende

Agente Com Cerebro Externo

Memoria persistente real
Contexto recuperado do cofre
Decisoes documentadas e reutilizaveis
Historico vivo de operacoes
Executa, documenta e aprende

A diferenca: O agente nao so executa tarefas — ele constroi memoria e contexto ao longo do tempo. Cada integracao, cada decisao, cada processo vira um node no grafo que ele pode consultar depois.

Arquitetura do Setup

Os 4 Componentes

OpenClaw (VPS) — o agente operacional. Roda na VPS, recebe comandos, executa tarefas, le e escreve no cofre.

Obsidian (Mac) — o editor de conhecimento. Voce visualiza, navega e edita o cofre com graph view, backlinks e wikilinks nativos.

Syncthing — a ponte de sincronizacao. Mantem o cofre identico no Mac e na VPS em tempo real, peer-to-peer, sem nuvem.

Skill Graph — a arquitetura do conhecimento. Nao e uma pasta de notas — e um grafo de claims, methods, MOCs e projetos conectados por wikilinks.

Mac

Obsidian
Cofre local
Syncthing

↔

Syncthing

Peer-to-peer
Sync bidirecional
Tempo real

↔

VPS

OpenClaw
Cofre sync
Gateway + Canais

Fluxo de Dados

Voce fala com o agente pelo Telegram (ou qualquer canal)

O OpenClaw na VPS recebe, processa, e le/escreve no cofre local da VPS

O Syncthing sincroniza automaticamente as mudancas com o Mac

Voce ve as mudancas aparecerem no Obsidian em tempo real

Se voce editar no Obsidian, a mudanca volta pra VPS e o agente ja ve

Subir o OpenClaw na VPS

Requisitos

VPS — qualquer provider (DigitalOcean, Hetzner, Vultr, etc). Ubuntu 22+ recomendado.

Node.js 22+ — o gateway do OpenClaw roda em Node.

Conta OpenAI — o OpenClaw usa modelos da OpenAI (Codex/GPT) como runtime.

Instalacao

Acesse sua VPS via SSH:
ssh root@SEU_IP

Instale o OpenClaw seguindo a documentacao oficial. O gateway fica escutando em 127.0.0.1:18789.

Verifique se esta rodando:
openclaw status
openclaw gateway status

# Verificar status do OpenClaw
$ openclaw status
OpenClaw v2026.3.13 (stable)
Gateway: running on 127.0.0.1:18789
Sessions: 2 active

# Acessar o dashboard do Mac (tunel SSH)
$ ssh -fN -L 18789:127.0.0.1:18789 root@SEU_IP
# Abrir: http://127.0.0.1:18789/
      

Seguranca: O gateway escuta apenas em localhost (127.0.0.1). Nunca exponha a porta 18789 publicamente. Use tunel SSH para acessar remotamente.

Configurar o Canal (Telegram)

Por que Telegram

O Telegram funciona como interface natural para falar com o agente. Voce manda uma mensagem e o OpenClaw responde — como se fosse um colega de trabalho.

Alternativas: Discord, Slack, qualquer canal que o OpenClaw suporte. Mas o Telegram e o mais direto.

Setup do Bot

Crie um bot no Telegram via @BotFather: /newbot

Copie o token do bot que o BotFather gerar

Configure o canal no OpenClaw apontando para o token do bot

Defina o sender ID do seu Telegram pessoal como allowlist (so voce fala com o agente)

# Configuracao do canal Telegram no OpenClaw
"channels": {
  "telegram": {
    "token": "SEU_BOT_TOKEN",
    "senderPolicy": "allowlist",
    "allowFrom": [SEU_SENDER_ID]
  }
}
      

Funcionalidades do Canal

DM direto — manda mensagem, agente responde. Simples.

Modo elevado — /elevated ask para comandos que precisam de mais permissao no host.

Allowlist — controla quem pode falar com o agente. Grupo ou DM.

Dica: Para descobrir seu sender ID, mande qualquer mensagem pro bot e olhe os logs do OpenClaw. O ID aparece la. Ou use bots como @userinfobot no Telegram.

Criar o Cofre no Obsidian

O que e o Cofre

O cofre e simplesmente uma pasta com arquivos markdown. O Obsidian abre essa pasta como um vault e adiciona wikilinks, graph view e backlinks em cima.

Esse cofre vai ser o cerebro compartilhado entre voce (via Obsidian) e o agente (via filesystem na VPS).

Criando o Cofre

Instale o Obsidian (gratuito, Mac/Win/Linux)

Crie uma pasta local fora do iCloud:
~/Documents/cofre-openclaw

No Obsidian: File → Open Vault → Open folder as vault

Aponte para a pasta que voce criou

Por que fora do iCloud? O iCloud cria placeholder files e conflitos de sync. Usar uma pasta local pura evita colisoes com o Syncthing e garante estabilidade.

Configuracoes do Obsidian

Settings → Files & Links: ative Use [[Wikilinks]]

Settings → Files & Links: defina New link format como "Shortest path when possible"

Settings → Files & Links: ative Automatically update internal links

Core plugins: ative Graph View, Backlinks, Outgoing Links, Templates

Syncthing: Sincronizar Mac e VPS

Por que Syncthing

Syncthing e peer-to-peer, open-source, sem nuvem. Seus arquivos vao direto do Mac pra VPS e vice-versa. Sem intermediarios, sem limites de storage, sem vendor lock-in.

O sync e bidirecional e em tempo real. Qualquer mudanca no Mac aparece na VPS em segundos, e qualquer coisa que o agente escrever na VPS aparece no Obsidian.

Instalar no Mac

# Instalar via Homebrew
$ brew install --cask syncthing

# A interface web abre automaticamente em:
# http://127.0.0.1:8384/
      

Instalar na VPS

# Instalar
$ apt-get update && apt-get install -y syncthing

# Criar pasta de destino do cofre
$ mkdir -p /root/obsidian-sync/openclaw

# Iniciar e habilitar como servico
$ systemctl --user enable --now syncthing

# Acessar interface da VPS via tunel SSH
$ ssh -fN -L 8385:127.0.0.1:8384 root@SEU_IP
# Abrir: http://127.0.0.1:8385/
      

Parear os Devices

No Syncthing do Mac: copie o Device ID (Settings → Show ID)

No Syncthing da VPS: Add Device → cole o Device ID do Mac

Volte ao Mac e aceite o pedido de pareamento da VPS

No Mac: Add Folder → aponte para ~/Documents/cofre-openclaw

Compartilhe a pasta com o device da VPS

Na VPS: aceite a pasta compartilhada e defina o destino como /root/obsidian-sync/openclaw/cofre-openclaw

Validar a Sync

Depois de parear, crie um arquivo de teste no Obsidian e veja se aparece na VPS:

# No Mac: crie um arquivo no cofre
$ echo "# teste de sync" > ~/Documents/cofre-openclaw/teste-sync.md

# Na VPS: verifique se chegou (aguarde alguns segundos)
$ cat /root/obsidian-sync/openclaw/cofre-openclaw/teste-sync.md
# teste de sync

# Funcionou? Delete o arquivo de teste
$ rm ~/Documents/cofre-openclaw/teste-sync.md
      

Status idle: Quando o Syncthing mostra status "idle" e 0 erros, a sincronizacao esta funcionando perfeitamente. Qualquer mudanca futura sera propagada automaticamente.

Estrutura do Skill Graph no Cofre

O Papel de Cada Pasta

O cofre nao e uma pasta de notas soltas. E um grafo de conhecimento estruturado onde cada pasta tem um papel claro:

index.md — ponto de entrada. O agente sempre comeca aqui.

mocs/ — Maps of Content. Organizam clusters de nodes por area tematica.

claims/ — teses e principios fundamentais do sistema.

methods/ — como fazer. Playbooks, integracoes, processos documentados.

Estrutura de Pastas

cofre-openclaw/
  index.md              ← entry point (o agente comeca aqui)
  MEMORY.md             ← memoria operacional do agente
  USER.md               ← perfil do usuario (nome, timezone, preferencias)
  inbox.md              ← notas rapidas, ainda nao categorizadas
  backlog.md            ← tarefas pendentes do agente

  mocs/
    identity-and-user.md      ← MOC: quem e o agente, quem e o usuario
    openclaw-infrastructure.md ← MOC: VPS, gateway, canais
    integrations.md           ← MOC: todas as integracoes
    reporting-and-ads.md      ← MOC: Google Ads, relatorios, clientes
    knowledge-system.md       ← MOC: skill graphs, cognicao externa
    operating-playbooks.md    ← MOC: runbooks operacionais
    maintenance-and-automation.md ← MOC: rotinas automaticas

  claims/               ← teses e principios
  methods/              ← como fazer (integracoes, processos, playbooks)
  projects/             ← iniciativas em andamento
  clients/              ← contexto por cliente
  integrations/         ← integracoes feitas (Telegram, Codex, Brave, etc)
  infrastructure/       ← topologia, configs, rede
  reports/              ← relatorios gerados
  daily/                ← checkpoints diarios
  templates/            ← templates pra nodes, MOCs, reports
  logs/                 ← backlog categorizado, orphan notes

O Index (Entry Point)

O index nao e uma lista — e um mapa que direciona atencao. O agente le, entende o terreno, e segue os wikilinks relevantes.

---
name: cofre-openclaw
description: Cerebro externo do agente mano. Memoria persistente, integracoes, operacoes.
---

# Cofre OpenClaw

Cerebro externo do agente operacional.

## Identidade
- [[mocs/identity-and-user]] — quem e o agente, quem e o usuario

## Infraestrutura
- [[mocs/openclaw-infrastructure]] — VPS, gateway, canais, topologia

## Integracoes
- [[mocs/integrations]] — Telegram, Codex, Brave, Google Ads, Obsidian

## Conhecimento
- [[mocs/knowledge-system]] — skill graphs, cognicao externa, indexacao

## Operacoes
- [[mocs/operating-playbooks]] — runbooks, tarefas recorrentes
- [[mocs/maintenance-and-automation]] — rotinas automaticas, nightly brain

## Claims
- [[claims/obsidian-is-the-external-brain]] — por que Obsidian e o cerebro
- [[claims/skill-graphs-outperform-single-skill-files]] — por que grafos vencem arquivos unicos
- [[claims/the-index-points-attention]] — index direciona, nao lista
      

Uma Claim (Tese Fundamental)

Claims sao principios que guiam decisoes. Nao sao instrucoes — sao argumentos que o agente internaliza.

---
name: obsidian-is-the-external-brain
description: O cofre Obsidian sincronizado via Syncthing e a camada de memoria persistente do agente.
---

# Obsidian e o Cerebro Externo

O cofre nao e "um lugar pra salvar notas". Ele e a [[mocs/knowledge-system|camada de cognicao externa]]
do agente, onde conhecimento acumulado persiste entre sessoes.

Comparado com prompt engineering puro, o cofre oferece:
- Memoria que cresce organicamente
- Navegabilidade via [[claims/the-index-points-attention|index e wikilinks]]
- Documentacao viva que o agente le E escreve
- Historico operacional em [[mocs/maintenance-and-automation|daily checkpoints]]

A sincronizacao via Syncthing garante que tanto o usuario (Obsidian)
quanto o agente (filesystem na VPS) trabalham no mesmo cofre.
      

Um Method (Playbook)

Methods documentam como fazer algo. Cada integracao, processo ou playbook vira um method.

---
name: telegram-channel-setup
description: Como configurar e operar o canal Telegram do OpenClaw.
---

# Telegram Channel Setup

O canal Telegram e a interface primaria de comunicacao.
Configurado via [[mocs/openclaw-infrastructure|gateway config]].

## Configuracao
- Token: obtido via @BotFather
- Policy: allowlist (so sender IDs autorizados)
- Modo elevado: disponivel via /elevated ask

## Troubleshooting
Se o bot parar de responder, verificar:
1. Status do gateway: openclaw gateway status
2. Webhook ativo: checar logs em /tmp/openclaw/
3. Sync do cofre: [[methods/obsidian-sync-via-syncthing]]
      

Wikilinks na prosa: Observe que os links estao dentro do texto, nao em listas soltas no final. Isso da ao agente contexto sobre quando e por que seguir cada link. Ele nao precisa ler o arquivo linkado pra saber se e relevante.

Automacao: Nightly Brain Maintenance

O Conceito

O agente nao so usa o cofre — ele cuida dele. Uma rotina automatica roda toda noite para manter o cerebro saudavel, categorizado e documentado.

E como se o agente fizesse uma "meditacao" diaria: revisa o sistema, atualiza o backlog, detecta notas orfas e gera um checkpoint do dia.

O que a Rotina Faz

Revisa status do OpenClaw — gateway, canais, sessoes ativas

Revisa status do Syncthing — sync OK, erros, devices conectados

Gera checkpoint diario — arquivo em daily/YYYY-MM-DD-maintenance.md

Categoriza backlog — separa itens em infra, docs e automation

Detecta orphan notes — notas com poucos/nenhum inbound link

Mantem a consistencia do grafo — verifica subpastas, cria as que faltam

# Script de manutencao na VPS
# Localizado em: ~/.openclaw/workspace/maintenance/nightly_brain_maintenance.sh

# Cron para rodar toda noite as 23:00
$ crontab -e

# Adicionar:
0 23 * * * /root/.openclaw/workspace/maintenance/nightly_brain_maintenance.sh
      

Exemplo de Checkpoint Diario

Cada noite, o agente gera um arquivo como este no cofre:

# Checkpoint 2026-03-14

## OpenClaw Status
- Gateway: running
- Channels: telegram ON
- Sessions: 2 active

## Syncthing Status
- Estado: idle
- Erros: 0
- Devices: 2/2 conectados

## Cofre
- Total notes: 69
- Orphan notes: 2
- Notas com poucos links: 11

## Backlog
- Infra: 3 itens
- Docs: 5 itens
- Automation: 2 itens
      

Resultado: Voce abre o Obsidian de manha e tem um resumo completo do que aconteceu durante a noite. Status do sistema, saude do grafo, itens pendentes. Tudo la, sem voce perguntar.

Exemplos Reais de Uso

Documentar Integracoes

Cada vez que voce conecta uma ferramenta ao OpenClaw, o agente documenta o processo como um method. Voce acumula um acervo de "como integrar X" que o agente consulta no futuro.

Exemplos reais: Telegram, Codex, Brave Search, Google Ads MCC, Obsidian+Syncthing, audio transcription local.

Relatorios por Cliente

O agente puxa dados da API (ex: Google Ads), gera relatorios e salva no cofre em reports/. Cada cliente tem um node em clients/ com contexto persistente.

Na proxima vez que voce pedir um relatorio, o agente ja sabe o historico, os benchmarks e o tom diplomatico certo.

Backlog Inteligente

Em vez de uma lista linear de tarefas, o backlog e categorizado automaticamente pela rotina noturna. Itens de infra, docs e automacao ficam em logs separados.

O agente sabe o que e prioridade sem voce precisar organizar manualmente.

Acumulo de Decisoes Tecnicas

Decisoes como "usamos Syncthing e nao git pra sync" ou "o Telegram e o canal principal" ficam documentadas como claims. O agente nao vai questionar a decisao de novo — ele consulta a claim e segue.

Skill Graph como Base de Conhecimento

Se voce tem um dominio complexo (marketing, saude, juridico, dev), o cofre vira um segundo cerebro navegavel. O agente segue wikilinks pra responder com profundidade real em vez de conhecimento generico.

Num setup real: ~70 nodes, 7 MOCs, 4 claims fundamentais, manutencao automatica. E cresce organicamente.

Sem Cerebro Externo

"Como integrei o Telegram mesmo?"
"Qual era o ID daquela conta?"
"Ja fizemos isso antes?"
"O que foi decidido sobre X?"
Retrabalho constante

Com Cerebro Externo

Agente consulta methods/telegram-channel-setup
Agente le clients/allegra com IDs e contexto
Agente navega daily/ pra achar historico
Agente segue claims/ pra decisoes fundamentais
Conhecimento acumulado e reutilizado

Como comecar rapido:
1. Suba o OpenClaw na VPS
2. Configure o canal (Telegram)
3. Crie o cofre no Obsidian (fora do iCloud)
4. Instale Syncthing no Mac e na VPS, pareie os devices
5. Crie a estrutura base: index.md, 3-5 MOCs, primeiros nodes
6. Peca pro agente documentar a primeira integracao no cofre
7. Configure a rotina noturna de manutencao
8. Expanda o grafo conforme o uso real demanda

Agentes executam tarefas.
Cerebros externos constroem conhecimento.

A diferenca entre um agente que esquece tudo e um agente que acumula inteligencia operacional e a estrutura de memoria que voce da pra ele.

@eusoier →

@eusoier

OpenClaw + ObsidianCerebro Externo