🎨 Design da Conversa
Conversas com o agente PKM seguem padrões específicos diferentes de um chatbot genérico. O design do diálogo determina se o agente é confiável e previsível — ou frustrante e inconsistente.
🎨 Padrões de diálogo para PKM
## Padrões de Diálogo
response_patterns:
# Sempre incluir fonte nas respostas sobre o wiki
cite_source: true
cite_format: "↗ Fonte: wiki/{filename}"
# Perguntar antes de escrever qualquer arquivo
confirm_writes: true
confirm_message: "Vou salvar em {path}. Confirmar? (s/n)"
# Quando não encontrar no wiki
not_found: |
Não tenho isso registrado no wiki ainda.
Deseja criar uma tarefa de pesquisa sobre "{query}"?
# Quando encontrar múltiplos resultados
multiple_results: |
Encontrei {count} páginas relacionadas:
{list}
Qual deseja explorar em mais detalhes?
# Tom e estilo
tone: "direto e conciso"
language: "pt-BR"
max_response_length: 500 # tokens🔎 Consultas em Linguagem Natural
O poder do agente é transformar linguagem natural imprecisa em consultas precisas ao wiki. Você não precisa lembrar nomes exatos de arquivos — basta perguntar como pensaria.
🔎 Tipos de consultas e como o agente processa
- • "O que sei sobre X?" → consulta conceitual
- • "O que decidimos sobre Y?" → consulta decisional
- • "Compare A com B no que registrei" → comparativa
- • "Resumo do que anotei em março" → temporal
- • "Pesquise sobre X" → agente não acessa internet
- • "Qual é a melhor prática de X?" → precisa estar no wiki
- • Consultas muito vagas sem contexto
- • Múltiplas perguntas numa única mensagem
📱 Captura Mobile
A captura é o gargalo crítico de qualquer sistema de segundo cérebro. Com OpenClaw, você elimina esse gargalo: encontrou algo interessante → manda pro Telegram → está no vault em segundos.
Tipos de captura suportados
Digite qualquer nota diretamente no Telegram. O agente cria o arquivo Markdown automaticamente com metadados de data e fonte.
PDF, TXT, MD — o Telegram entrega o arquivo, o agente salva em raw/inbox/ com nome baseado em data/hora.
Manda uma URL → agente usa skill de browser para fazer scraping do conteúdo → salva como raw/inbox/url-XXXX.md.
Fluxo de captura de URL
https://martinfowler.com/articles/strangler-fig.html
🔍 Lendo artigo...
Título: Strangler Fig Application (Martin Fowler)
Salvo em raw/inbox/2026-04-09_strangler-fig.md
Ingerir agora? (s/n)
s
✓ Ingestão concluída
wiki/strangler-fig-pattern.md criado (1.2k tokens)
Pergunte: "o que sei sobre strangler fig?"
# raw/inbox/2026-04-09_1423_strangler-fig.md
---
captured_at: 2026-04-09T14:23:00
source_type: url
source_url: https://martinfowler.com/articles/strangler-fig.html
captured_via: telegram
captured_by: user_main
status: pending_ingestion
title: "Strangler Fig Application — Martin Fowler"
---
[conteúdo extraído da URL via skill browser]🔔 Alertas e Notificações
O agente não é apenas reativo — ele pode ser proativo. Notificações push informam sobre ingestões concluídas, arquivos aguardando processamento e a saúde geral do wiki.
🔔 Tipos de notificação e configuração
## Notificações
notifications:
# Após ingestão bem-sucedida
on_ingestion_complete:
channel: telegram
message: "✓ Ingestão concluída: {pages_created} páginas em wiki/"
immediate: true
# Inbox acumulando
inbox_alert:
trigger: "count(raw/inbox/*.md) > 5"
channel: telegram
message: "⚠ {count} documentos aguardando ingestão em raw/inbox/"
cooldown: 4h # não repetir antes de 4 horas
# Silenciar no período noturno
quiet_hours:
start: "23:00"
end: "07:00"
mode: digest # acumula e envia de manhã📜 Histórico de Conversas como Raw
Conversas com o agente são ricas em conhecimento implícito: decisões tomadas, insights verbalizados, padrões identificados. Ingerir os logs transforma o diálogo em memória persistente.
# Comandos especiais no chat:
/export → exporta última sessão
/export week → exporta últimos 7 dias
/export topic=X → filtra por tema
# Arquivo gerado:
# raw/inbox/chat-export-2026-04.md
---
export_date: 2026-04-09
session_count: 23
topics: [python, arquitetura, projetos]
---
[Usuário] 14:23: O que sei sobre Python async?
[Cleo] 14:23: Python async usa event loop...
[Usuário] 15:10: Decidi usar FastAPI em vez de Django
[Cleo] 15:10: Registrado. Motivos para FastAPI..."Decidi usar FastAPI" → entrada em wiki/decisoes-tecnicas.md
Identifica temas consultados muitas vezes → sugere aprofundamento
Conexões entre tópicos feitas durante a conversa → atualiza páginas relacionadas
Temas consultados sem resultado → lista de pesquisa pendente
Quanto mais você usa o agente, melhor ele fica: conversas → logs → ingestão → wiki atualizado → consultas futuras mais precisas. O segundo cérebro cresce organicamente com o uso.
🌐 Multi-canal
Um único vault, todos os seus canais. Configure identidades e permissões diferentes por canal — seu WhatsApp pessoal, Telegram profissional e Slack de equipe acessam o mesmo wiki sem duplicação.
Configuração multi-canal no SOUL.md
## Canais
channels:
telegram:
token: "${TELEGRAM_BOT_TOKEN}"
name: "Cleo"
permissions:
can_read_wiki: true
can_write_inbox: true
can_trigger_ingestion: true
users:
- id: "${MY_TELEGRAM_ID}"
role: owner
whatsapp:
adapter: baileys
name: "Cleo"
permissions:
can_read_wiki: true
can_write_inbox: true
can_trigger_ingestion: false # apenas leitura no WhatsApp
rate_limit: 20/hour # evitar ban
slack:
token: "${SLACK_BOT_TOKEN}"
workspace: "minha-empresa"
name: "WikiBot"
permissions:
can_read_wiki: true
can_write_inbox: true
can_trigger_ingestion: true
channels:
- "#conhecimento" # canal dedicado