@pixeleducacao/curso-openclaw 2026.5.8

package/assets/cheatsheets/crons-do-seu-agente.md

@@ -0,0 +1,170 @@
+---
+name: crons-do-seu-agente
+status: ATIVO
+category: cheatsheet
+referenced_by: [A9]
+version: 1.0
+last_updated: 2026-05-04
+description: Cheatsheet pra crons + heartbeat do agente OpenClaw (A9). Cobre cron vs heartbeat · 4 categorias com 10+ exemplos · Revisão do Dia · meta-cron de auditoria · 7 ideias de heartbeat · 5 prompts prontos.
+---
+
+# Crons do seu agente — referência rápida (A9)
+
+## A9 em 1 minuto (resumo executivo)
+
+OpenClaw tem **2 mecanismos de proatividade complementares**:
+
+- **Cron** — timing exato (segunda 9h sharp), tarefa isolada, output entregue direto no canal. *"O que TEM que acontecer."*
+- **Heartbeat** — drift de timing OK (~30min de janela), múltiplas checks pequenas em batch, agente decide se age ou fica quieto. *"O que PODE valer a pena."*
+
+**Frase-mãe da A9:** *"cron = onde você dá super poderes ao agente. Sem cron, ele é assistente. Com cron, ele é operação."*
+
+Você sai da A9 com **3 crons suficientes pra começar:** Revisão do Dia (18h) + meta-cron de auditoria (7h) + 1 cron próprio do seu workflow.
+
+## Cron vs heartbeat — quando usar cada um
+
+| Dimensão | **Heartbeat** | **Cron** |
+|----------|--------------|----------|
+| **Timing** | Drift OK (~30min de janela) | Exato ("segunda 9h sharp") |
+| **Tarefa** | Múltiplas checks pequenas em batch | 1 task isolada |
+| **Contexto** | Usa histórico recente + lê `memory/hot.md` | Sessão isolada (default) |
+| **Custo API** | Reduz chamadas (1 turno = N checks) | 1 chamada por trigger |
+| **Output** | Conversa contigo (ou silêncio) | Entrega direto no canal |
+
+## 4 categorias de cron — 10+ exemplos
+
+### 1. Monitoramento (saúde do sistema)
+- **Health check semanal** · valida que API key, OAuth, canais e crons tão OK
+- **Auditar workspace mensal** · checa MAPAs, MEMORY, skills
+- **Auditar os próprios crons** (meta-cron) · cron que checa se os outros rodaram OK
+
+### 2. Pesquisa & estudo
+- **Pesquisas de conteúdo** · tendências do dia no seu nicho
+- **Ler documentação nova** de ferramenta que você usa
+- **Analisar próprias memórias** pra aprender padrões sobre você (recap A7)
+
+### 3. Sumarização & relatórios
+- **Relatório semanal** (vendas · KPIs · métricas)
+- **Tickets de suporte** · agente lê, classifica por categoria + urgência
+- **Newsletter da comunidade**
+
+### 4. Planejamento & reflexão
+- **Revisão do Dia** (cron-âncora 18h) · agente fecha o dia e prepara o seguinte
+- **Auditar notas das pessoas** pra ver o que aprenderam
+
+> **Princípio:** se cron novo não couber em nenhuma das 4 categorias, provavelmente não é cron — é skill que você roda manualmente.
+
+## 4 comandos naturais cobrem 100% do uso
+
+| Intenção | Prompt natural |
+|----------|----------------|
+| Criar cron | `cria um cron toda manhã 8h que olha minhas pendências e me manda priorizadas` |
+| Listar crons | `me lista os crons que eu tenho` |
+| Apagar cron | `apaga o cron das pendências` |
+| Rodar agora (teste) | `roda o cron de revisão do dia agora` |
+
+## Revisão do Dia (cron-âncora 18h)
+
+**Você chega de manhã e o agente já preparou amanhã pra você.**
+
+### Prompt pra criar Revisão do Dia
+
+```
+cria um cron toda dia 18h chamado revisao-do-dia que:
+
+1. Lê minha daily note do dia (memory/YYYY-MM-DD.md) e cruza
+   com memória semântica
+2. Lista o que ficou pendente (cruza decisões do dia com
+   pendencias.md)
+3. Alerta sobre amanhã: lê calls, deadlines, prazos do dia
+   seguinte
+4. Manda resumo no Telegram tópico Operação no formato:
+   - Hoje fiz: ...
+   - Aberto: ...
+   - Amanhã: ...
+5. Roda em sessão isolada (não polui contexto da sessão atual)
+```
+
+## Meta-cron de auditoria (cron que audita os próprios crons)
+
+Funcionário precisa de supervisor — mesmo se o supervisor for ele mesmo.
+
+```
+cria um cron toda manhã 7h que checa todos os crons que
+rodaram nas últimas 24h, lista os que deram OK e os que
+falharam, e me manda resumo no Telegram tópico Operação.
+
+Se algum falhou, inclui o erro pra eu poder corrigir.
+Roda em sessão isolada e usa --light-context.
+```
+
+> **Frase-mãe:** *você não confia 100% em cron. Mas você confia em cron que audita cron.*
+
+## Heartbeat — o agente que respira
+
+A cada N minutos o agente recebe uma "batida" — uma mensagem do tipo "tô vivo, alguma coisa nova?".
+
+### Os 2 arquivos que fazem heartbeat funcionar
+
+| Arquivo | Função | Quem mantém |
+|---------|--------|-------------|
+| `HEARTBEAT.md` | **COMO ele vigia** — frequência do poll, checks, regras de silêncio | Aluno (raro) |
+| `memory/hot.md` | **O QUE ele vigia** — prioridades, prazos, decisões | Agente (auto) |
+
+### 7 ideias de heartbeat pra experimentar
+
+- **Inbox triage** — emails não-lidos das últimas 4h, classifica em urgente/pode esperar/lixo
+- **Calendário próximo** — checa próximas 24-48h, lembra do que tem amanhã
+- **Mention sweep** — checa LinkedIn/Twitter, manda só relevantes
+- **Pendências paradas** — itens com nome de terceiro parado há 3+ dias
+- **Memory maintenance** — extrai aprendizados duráveis pra MEMORY.md
+- **Weather guard** — se tiver evento externo hoje, checa previsão
+- **News watch** — checa 2-3 fontes que importam pro seu negócio
+
+### Regras de silêncio (anti-spam)
+
+- **Quiet hours 23h–8h** — só interrompe se for urgência real
+- **Já checou nos últimos 30min?** — não checa de novo
+- **Nada novo?** — silêncio (não manda "tudo certo!" gratuito)
+- **Reach out só quando:** email importante chegou · evento <2h · achou algo interessante
+
+## Comandos `openclaw cron`
+
+| Comando | Pra que serve |
+|---------|---------------|
+| `openclaw cron add` | Adiciona cron novo |
+| `openclaw cron list` | Lista todos os crons configurados |
+| `openclaw cron run --id <id>` | Executa cron agora (sem esperar horário) |
+| `openclaw cron runs --id <id>` | Histórico de execuções |
+| `openclaw cron edit --id <id>` | Edita prompt, horário ou flags |
+| `openclaw cron rm --id <id>` | Remove cron |
+| `openclaw cron enable / disable` | Pausa ou retoma cron sem deletar |
+
+### Flags úteis
+
+| Flag | Pra que serve |
+|------|---------------|
+| `--session isolated` | Cron roda em sessão limpa (default) |
+| `--light-context` | Carrega só o essencial (mais rápido, custo menor) |
+| `--no-deliver` | Executa mas não envia output (útil pra teste) |
+| `--at <datetime>` | Cron de execução única |
+
+## Princípios A10 aplicados a crons + heartbeat
+
+1. **Cap mensal por cron** — 3 crons úteis > 15 crons enroscados
+2. **Audit log de cada execução** — `openclaw cron runs --id <id>`
+3. **Heartbeat com regras de silêncio** — anti-spam
+4. **Sessão isolada por padrão** — `--session isolated`
+5. **Meta-cron audita os crons**
+6. **Skill em cron precisa carregar tudo explicitamente**
+
+## Referências
+
+- A9 do roteiro principal · A2 (cockpit) · A7 (memória) · A8 (skills) · A10 (segurança) · A12 (integrações)
+- Doc OpenClaw cron: [docs.openclaw.ai/cli/cron](https://docs.openclaw.ai/cli/cron)
+
+---
+
+> **Anti-hype:** não cria 15 crons no day 1. Maioria fica órfã. **3 crons úteis > 15 crons enroscados.** Vai adicionando conforme aparecer repetição real.
+
+📌 Atualizado em 04/05/2026 · Pixel Educação

package/assets/cheatsheets/identidade-do-seu-agente.md

@@ -0,0 +1,133 @@
+---
+name: identidade-do-seu-agente
+status: ATIVO
+category: cheatsheet
+referenced_by: [A5]
+version: 1.0
+last_updated: 2026-05-04
+description: Cheatsheet pra identidade do agente OpenClaw (A5). Cobre os 4 arquivos canônicos (SOUL · IDENTITY · AGENTS · USER) + USERS.md (corporativo) · diferença SOUL vs IDENTITY · anatomia detalhada de cada arquivo · 5 prompts prontos · comandos `openclaw context`.
+---
+
+# Identidade do seu agente — referência rápida (A5)
+
+## A5 em 1 minuto (resumo executivo)
+
+Identidade do agente = **5 arquivos** que respondem 5 perguntas distintas.
+
+| Arquivo | Pergunta que responde | Quem atualiza | Frequência |
+|---------|-----------------------|---------------|------------|
+| **`SOUL.md`** | Quem ele É (personalidade · tom · valores) | Agente, em diálogo com aluno | Toda vez que tom não bate com o desejado |
+| **`IDENTITY.md`** | O que ele FAZ (papel funcional · cargo) | Agente, em diálogo com aluno | Quando papel muda |
+| **`AGENTS.md`** | Como ele se RELACIONA (organograma) | Agente · aluno revisa | Quando entra agente novo (A13) |
+| **`USER.md`** | Quem é VOCÊ (perfil · família · negócios) | Agente captura · aluno valida | Toda mudança material no seu contexto |
+| **`USERS.md`** (corporativo) | Quem são os USERS (plural — equipe) | Agente captura · admin valida | Quando entra/sai pessoa do time |
+
+> **Frase-mãe da A5:** *"Identidade é a base. Contexto é o que dá vida. Quanto mais ele te conhece, mais ele orquestra."*
+
+## SOUL.md vs IDENTITY.md — a confusão clássica
+
+| Quesito | SOUL.md | IDENTITY.md |
+|---------|---------|-------------|
+| Pergunta | Quem ele É | O que ele FAZ |
+| Conteúdo | Tom · personalidade · valores · jeito de responder | Cargo · responsabilidades · escopo |
+| Exemplo Amora | "anti-hustle culture · direta sem hedge · vulnerável quando agrega" | "Chief of Staff do Bruno · opera Pixel + agentes + conteúdo" |
+| Muda quando | Você não gosta do tom da resposta | Papel funcional muda |
+
+**Teste rápido:** se você tá descrevendo *jeito de responder* → SOUL. Se você tá descrevendo *tarefa que ele faz* → IDENTITY.
+
+## Anatomia do SOUL.md (5 seções típicas)
+
+| Seção | Conteúdo | Exemplo |
+|-------|----------|---------|
+| **Tom** | Como ele fala | "Direto e conversacional · português BR sem formalismo" |
+| **Comportamento default** | Padrões de resposta | "Opina forte · zero filler · sem emoji a menos que peça" |
+| **Regras invariantes** | Always X / Never Y · linhas vermelhas | "Always solução simples primeiro" |
+| **Pré-requisitos** | O que ele precisa antes de agir | "Sempre lê arquivo antes de editar" |
+| **Anti-padrões** | O que NUNCA faz | "Nunca clichê de coaching · nunca formalidade corporativa" |
+
+## Anatomia do USER.md (8 blocos)
+
+| Bloco | Conteúdo | Por que importa |
+|-------|----------|-----------------|
+| **1. Perfil** | Nome + 2 linhas profissionais | Agente decide tom de resposta |
+| **2. Negócios** | Quais são · qual é principal · qual gera caixa | Agente prioriza ação alinhada |
+| **3. Família** | Esposa · filhos · contexto relevante | Agente respeita time-off |
+| **4. Equipe** | Quem coordena com você · papéis · cadência | Agente sabe quem cobrar |
+| **5. Tom preferido** | Direto · sem clichê · sem emoji · etc | Reforço do SOUL |
+| **6. Restrições** | Coisas que NÃO faz por princípio | Agente para de propor isso |
+| **7. Valores** | 3-5 frases-chave | Agente alinha decisões |
+| **8. Contexto operacional** | Cidade · time zone · ferramentas | Agente respeita horário |
+
+> **CRÍTICO (recap A10):** USER.md NÃO é cofre. Senha · token · API key vão pro `.env`. USER.md é perfil.
+
+## 5 prompts prontos pra colar
+
+### 1. Gerar SOUL.md inicial baseado em diálogo
+
+```
+Lê seu SOUL.md atual (deve estar raso, gerado pelo kit em A3).
+
+Quero aprofundar sua personalidade. Vou descrever em linguagem natural
+como quero que você responda — você captura em SOUL.md, mostra diff,
+pede confirmação antes de salvar.
+
+Tom: [direto / formal / técnico / casual / vulnerável / etc.]
+Hedge: [opina forte / hedge frequente / só no que tem certeza]
+Filler: [zero / aceita / específico]
+Emoji: [zero / específico / livre]
+Como discordar de mim: [pode discordar quando aumenta clareza /
+                       sempre concorda / negocia]
+
+Captura no SOUL e me mostra o resultado antes de salvar.
+```
+
+### 2. Estruturar USER.md em 8 blocos via diálogo
+
+```
+Lê seu USER.md atual.
+
+Quero te ensinar quem eu sou de verdade. Vou te contar 8 blocos —
+você captura em USER.md, organizado por seção, mostra diff, confirma.
+
+1. Nome + 2 linhas de perfil profissional
+2. Meus negócios (qual é principal · qual gera caixa · qual é estratégico)
+3. Família (com contexto que afeta meu day a day)
+4. Equipe (quem coordena comigo · papéis · cadência)
+5. Tom que prefiro receber de você
+6. Restrições (coisas que NÃO faço por princípio)
+7. Valores (3-5 frases-chave)
+8. Contexto operacional (cidade · time zone · ferramentas · cadência)
+
+Princípio A10: NÃO coloca credencial em USER.md — só perfil.
+```
+
+### 3. Detectar inconsistência entre SOUL e USER (auditoria)
+
+```
+Faz auditoria de consistência entre SOUL.md e USER.md.
+
+1. SOUL afirma X que NÃO está suportado por nada em USER?
+2. USER afirma valor/restrição que NÃO se reflete em SOUL?
+3. Tom do SOUL bate com tom desejado do USER?
+4. Há regra que apareceu em SOUL mas devia estar em IDENTITY?
+
+Me mostra inconsistências em formato de tabela.
+NÃO altera nada sem confirmação.
+```
+
+## Comandos `openclaw context`
+
+| Comando | Pra que serve |
+|---------|---------------|
+| `openclaw context show` | Mostra arquivos de contexto carregados no boot |
+| `openclaw context reload` | Força reload do contexto após edição manual |
+| `openclaw agent identity` | Lista agentes do workspace + identidade resumida |
+
+## Referências
+
+- A5 (este cheatsheet complementa) · A3 (Starter Kit) · A6 (workspace) · A7 (memória) · A10 (segurança)
+- Doc OpenClaw `concepts/identity`: [docs.openclaw.ai/concepts/identity](https://docs.openclaw.ai/concepts/identity)
+
+---
+
+📌 Atualizado em 04/05/2026 · Pixel Educação

package/assets/cheatsheets/integracoes-de-produtividade.md

@@ -0,0 +1,171 @@
+---
+name: integracoes-de-produtividade
+status: ATIVO
+category: cheatsheet
+referenced_by: [A12]
+version: 1.0
+last_updated: 2026-05-04
+description: Cheatsheet de referência pra integrar qualquer ferramenta de produtividade no agente — Notion, GitHub, Calendar, Gmail, Drive, Stripe, Linear. Cobre 4 padrões de auth + 6 prompts prontos pra colar.
+---
+
+# Integrações de produtividade — referência rápida (A12)
+
+## Os 4 padrões de auth
+
+| # | Padrão | Como funciona | Exemplos |
+|---|--------|---------------|----------|
+| 1 | **Token simples** (API key) | Gera no painel · cola no `.env` · agente usa via Bearer | Notion · GitHub · Linear · Stripe · Buffer · Anthropic · Brave |
+| 2 | **OAuth flow** | Fluxo de browser · agente recebe access_token | Slack · Twitter/X · Spotify · Hubspot · Salesforce |
+| 3 | **CLI dedicada** | Instala CLI · autentica via browser · agente roda comandos | **Google: `gog`** · AWS: `aws` · Heroku: `heroku` |
+| 4 | **IMAP/SMTP + skill** | Protocolo padrão · skill custom abstrai | Gmail · Outlook · Yahoo · email custom |
+
+Princípio: *"Você decora 4 padrões. Não decora 50 APIs."*
+
+## Tabela canônica — integrações comuns
+
+### Padrão 1 — Token simples
+
+| Ferramenta | Onde criar token | Scope mínimo | Doc oficial |
+|------------|------------------|--------------|-------------|
+| **Notion** | [notion.so/my-integrations](https://www.notion.so/my-integrations) | Read-only se só lê · Read+Write se cria/atualiza | [developers.notion.com](https://developers.notion.com/) |
+| **GitHub** (PAT) | [github.com/settings/tokens](https://github.com/settings/tokens) | `repo:read` se só lê · `repo` se commit | [docs.github.com/rest](https://docs.github.com/en/rest) |
+| **Linear** | [linear.app/settings/api](https://linear.app/settings/api) | Read-only se só consulta | [developers.linear.app](https://developers.linear.app/) |
+| **Stripe** | [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys) | Restricted Key (read MRR ≠ write charges) | [stripe.com/docs/api](https://stripe.com/docs/api) |
+| **Buffer** | [publish.buffer.com/account/apps](https://publish.buffer.com/account/apps) | Token com escopo de canais específicos | [buffer.com/developers/api](https://buffer.com/developers/api) |
+| **Brave Search** | [api.search.brave.com](https://api.search.brave.com/) | Free tier suficiente | [api.search.brave.com](https://api.search.brave.com/) |
+
+### Padrão 3 — Google Workspace via gog CLI
+
+```bash
+# gog já vem instalado no OpenClaw 2026.4+. Setup:
+gog auth credentials /path/to/client_secret.json
+gog auth add seu@email.com --services gmail,calendar,drive,contacts,docs,sheets
+
+# Uso típico:
+gog calendar events <calendar-id> --from 2026-01-01 --to 2026-01-07
+gog gmail search 'newer_than:7d'
+gog gmail send --to "x@y.com" --subject "X" --body-file -
+gog drive search "minha pasta"
+gog sheets get <sheet-id>!A1:Z100
+```
+
+| Serviço Google | Comando gog |
+|----------------|-------------|
+| Gmail | `gog gmail search/send/reply/draft` |
+| Calendar | `gog calendar events/create/update` |
+| Drive | `gog drive search/get/upload` |
+| Docs | `gog docs cat/export` |
+| Sheets | `gog sheets get/update/append/clear` |
+
+**Por que gog em vez de gcloud:** cobre Google Workspace inteiro num CLI unificado · sem precisar criar projeto manualmente no Google Cloud Console · skills oficiais OpenClaw já usam gog.
+
+## 6 prompts prontos pra colar
+
+### 1. Conectar Notion via API token
+
+```
+Quero conectar meu Notion. Vai na doc oficial em
+https://docs.openclaw.ai/cli/secrets e em
+https://developers.notion.com/, lê como conectar via API com
+Bearer token, me explica:
+
+1. Onde criar o token (notion.so/my-integrations)
+2. Qual scope mínimo eu preciso
+3. Como adicionar token no .env (qual nome canônico)
+4. Como compartilhar pages/databases com a integração
+5. Como testar que tá funcionando
+
+Me pede a credencial quando estiver pronto, valida lendo uma
+page de teste, me avisa quando estiver tudo certo.
+
+Princípios A10: scope mínimo · token no cofre · rotação periódica.
+```
+
+### 2. Conectar GitHub via PAT
+
+```
+Quero conectar meu GitHub. Vai na doc oficial em
+https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens,
+me explica:
+
+1. Onde criar o PAT (fine-grained ou classic? me explica diferença)
+2. Qual scope mínimo eu preciso pro meu caso de uso
+3. Como adicionar token no .env como GITHUB_TOKEN
+4. Quanto tempo o token dura e como rotacionar
+
+Me pede a credencial, valida listando meus repos, me avisa quando
+estiver pronto.
+```
+
+### 3. Conectar Google Workspace via gog CLI
+
+```
+Quero conectar Gmail + Calendar + Drive do meu Google Workspace
+no agente. O caminho oficial é gog CLI.
+
+Vai na doc oficial em https://github.com/steipete/gogcli, lê o setup,
+me explica:
+
+1. Se gog já tá instalado nesse OpenClaw
+2. Como criar projeto no Google Cloud Console e baixar
+   client_secret.json
+3. Como autenticar via gog auth
+4. Como testar (lista próximos 3 eventos)
+
+Me pede o que precisar, conduz o fluxo OAuth, valida que tudo
+funciona, me avisa quando estiver pronto.
+```
+
+### 4. Conectar Stripe via API key (modo seguro)
+
+```
+Quero conectar minha conta Stripe — só pra LER MRR, listar
+customers, ler invoices. Sem write nessa primeira fase.
+
+Vai na doc oficial, lê como conectar via Restricted Key, me explica:
+
+1. Por que Restricted Key e não Secret Key
+2. Como criar Restricted Key com permissões mínimas:
+   - balance: read · customers: read · invoices: read
+   - charges: read · subscriptions: read
+3. Como adicionar token no .env
+4. Como testar lendo meu balance atual
+
+Aviso: NÃO me peça pra criar Secret Key full. Quero scope mínimo
+desde o dia 1.
+```
+
+## 3 informações que o agente sempre vai pedir
+
+| Informação | Exemplo prático |
+|------------|-----------------|
+| **Tipo de credencial** | Notion → Bearer token · Calendar → gog auth |
+| **Scope** | Stripe → Restricted Key com `balance:read + customers:read` |
+| **Onde guardar** | `.env` no Managed · futuro: 1Password |
+
+## Princípios de segurança aplicados (recap A10)
+
+1. **Scope de estagiário** — read-only quando der
+2. **Token no cofre** — hábito do dia 1
+3. **Rotação periódica** — cron mensal
+4. **Banco produção: nunca direto** — agente sempre via API
+5. **Defesa anti-prompt-injection** em toda leitura externa
+6. **Monitoramento inicial** — primeiros 30 dias
+
+## Troubleshooting comum
+
+| Sintoma | Causa | Ação |
+|---------|-------|------|
+| `401 Unauthorized` | Token expirou | Gera novo + atualiza `.env` + `openclaw secrets reload` |
+| `403 Forbidden` (Notion) | Page não compartilhado com integração | Compartilha page com integração explicitamente |
+| `rate limit exceeded` | Cron muito frequente | Aumenta intervalo + retry com backoff |
+| `gog: command not found` | gog não instalado | Roda via agente: `npm install -g gogcli` |
+
+## Referências
+
+- A12 · A10 (segurança) · A9 (cron de rotação)
+- [docs.openclaw.ai/cli/secrets](https://docs.openclaw.ai/cli/secrets)
+
+---
+
+📌 Atualizado em 04/05/2026 · Pixel Educação

package/assets/cheatsheets/memoria-do-seu-agente.md

@@ -0,0 +1,166 @@
+---
+name: memoria-do-seu-agente
+status: ATIVO
+category: cheatsheet
+referenced_by: [A7]
+version: 1.0
+last_updated: 2026-05-04
+description: Cheatsheet pra memória do agente OpenClaw (A7). Cobre os 3 tipos de memória (boot · sessão · semântica) · MEMORY.md · memory/hot.md · memory/YYYY-MM-DD.md · /new vs /compact · Memory Flush 70% · 5 prompts prontos.
+---
+
+# Memória do seu agente — referência rápida (A7)
+
+## A7 em 1 minuto (resumo executivo)
+
+Memória do agente = **3 tipos** trabalhando juntos + **3 arquivos canônicos** + **higiene de contexto**.
+
+| Tipo | O que cobre | Quando ativa |
+|------|-------------|--------------|
+| **1. Padrão (boot)** | MEMORY.md + dailies 48h + MAPAs | Toda nova sessão · automático |
+| **2. Sessão** | Chat atual no Telegram/Gateway | Enquanto você conversa · janela 200k tokens |
+| **3. Semântica** | Busca por significado no workspace inteiro | Quando você pergunta · usa embeddings |
+
+| Arquivo | Função | Quem mantém |
+|---------|--------|-------------|
+| **`MEMORY.md`** (raiz) | Auto-conhecimento estável (raramente muda) | Agente · auto-gerenciado |
+| **`memory/hot.md`** | Contexto quente · estado do agora | Agente · auto-mantido (skill `/salve` empurra) |
+| **`memory/YYYY-MM-DD.md`** | Dailies (sessões diárias · padrão OpenClaw) | Agente · purga após 14 dias |
+
+> **Frase-mãe da A7:** *"Memória sem higiene = agente lerdo. Higiene sem memória = começar do zero todo dia. Os dois juntos = ele escala com você."*
+
+## Os 3 tipos de memória — anatomia
+
+### 1. Memória padrão (boot) — como ele acorda
+
+| O que faz | Detalhe |
+|-----------|---------|
+| Lê `MEMORY.md` | Long-term self-knowledge |
+| Lê `memory/hot.md` | Contexto quente · top prioridades · prazos críticos |
+| Lê dailies de hoje + ontem | 48h de contexto (padrão OpenClaw) |
+| Lê SOUL/IDENTITY/USER/AGENTS | Identidade (recap A5) |
+| Carrega MAPAs do workspace | Sabe onde tá cada tipo de coisa (recap A6) |
+
+### 2. Memória de sessão — chat atual
+
+Janela de contexto da conversa em curso. Tem limite — **200k tokens com GPT-5.5**.
+
+**Sintomas de saturação:**
+- Agente lento (demora pra responder)
+- Não responde (trava no meio)
+- Alucina (inventa contexto · mistura conversas)
+- Perde contexto antigo
+
+### 3. Memória semântica — busca por significado
+
+Sistema mais poderoso. Auto-ativada com OpenAI API key da A1.
+
+**Como funciona (alto nível):**
+1. Agente roda embeddings de cada arquivo do workspace · guarda vetores
+2. Você pergunta com significado · agente vetoriza pergunta
+3. Retorna arquivos com vetores próximos · sintetiza resposta
+
+## /new vs /compact — quando usar cada
+
+| Comando | Quando usar | O que faz |
+|---------|-------------|-----------|
+| **`/new`** | Mudou de assunto · sessão saturada | Limpa contexto inteiro · começa zero |
+| **`/compact`** | Sessão grande mas conversa ainda relevante | Comprime histórico mantendo essência |
+| **`/compact Focus on [tema]`** | Compacta com foco em tema específico | Mantém foco · descarta resto |
+| **`/status`** | Diagnóstico · sentir lentidão | Mostra uso de contexto · sessão atual · modelo |
+
+> **Princípio absoluto (recap A0):** *"Salve antes de limpar."* Memory Flush automático ajuda mas não é 100% (~70% de confiabilidade real).
+
+## Memory Flush — feature nativa
+
+Antes da compactação automática disparar, agente faz um **"silent memory flush"** — tenta salvar nas pastas certas antes de comprimir.
+
+**Confiabilidade real (estimativa Bruno):** ~**70%** das vezes funciona limpo.
+
+**Implicação:** você ajuda salvando manual quando o assunto importa. Não confia 100% no flush automático.
+
+## 5 prompts prontos pra colar
+
+### 1. Atualizar MEMORY.md com auto-conhecimento
+
+```
+Lê seu MEMORY.md atual.
+
+Nas últimas [X dias / Y sessões] eu te corrigi sobre [tema/padrão]:
+- [Correção 1: ex "use prosa, não bullets desnecessários"]
+- [Correção 2: ex "número específico, não arredondado"]
+- [Correção 3: ex "sem emoji a menos que eu peça"]
+
+Promove os aprendizados DURÁVEIS pra MEMORY.md (não conjunturais).
+Mantém hot.md com o que ainda é contexto quente da semana.
+
+Mostra diff antes de salvar. NÃO mexe em SOUL.md.
+```
+
+### 2. Investigar "por que ele esqueceu de X?" (debug de memória)
+
+```
+Investiga por que você esqueceu de [DECISÃO / CONTEXTO específico].
+
+Diagnóstico em ordem:
+
+1. Roda busca semântica: openclaw memory search "[query do tema]"
+2. Lê hot.md atual: tema aparece? Se não, por que saiu?
+3. Lê MEMORY.md: tema deveria estar aqui (durável) e não tá?
+4. Olha dailies dos últimos 14 dias
+5. Olha archive/
+
+Me devolve diagnóstico em tabela.
+Propõe ação corretiva (reindex · refazer hot · salvar manual).
+```
+
+### 3. Reindexar memória semântica após mudança grande
+
+```
+Acabei de [MUDANÇA: ex "mover 50 arquivos", "reorganizar pasta X"].
+
+Memória semântica precisa reindexar pra refletir nova estrutura.
+Roda em ordem:
+
+1. openclaw memory status
+2. openclaw memory index --force
+3. Valida: openclaw memory search "[query teste]"
+4. Atualiza MAPAs afetados pela mudança
+
+Me reporta antes/depois do índice.
+```
+
+## Comandos `openclaw memory` e `openclaw sessions`
+
+### Memória semântica
+
+| Comando | Pra que serve |
+|---------|---------------|
+| `openclaw memory status` | Estado do índice · # de arquivos · última atualização |
+| `openclaw memory search "<query>"` | Busca semântica · retorna arquivos ranqueados |
+| `openclaw memory index --force` | Reindexar workspace inteiro |
+
+### Higiene de sessão (no chat)
+
+| Comando | Pra que serve |
+|---------|---------------|
+| `/new` | Nova sessão limpa |
+| `/new <model>` | Nova sessão trocando modelo |
+| `/compact` | Compacta contexto mantendo essência |
+| `/status` | Mostra uso de contexto · sessão atual · modelo ativo |
+
+## Princípios de segurança aplicados (recap A10)
+
+1. **Memória NÃO é log de chat** — credencial NÃO vai pra memória
+2. **Sessões antigas auto-purgam** — após 14 dias dailies vão pra archive/
+3. **Workspace isolado em Docker**
+4. **`.env` nunca em memória**
+5. **Memória semântica é local** (vetores ficam no workspace)
+
+## Referências
+
+- A7 (este cheatsheet complementa) · A1 (setup) · A3 (Starter Kit) · A5 (identidade) · A6 (workspace) · A9 (crons) · A10 (segurança)
+- Doc OpenClaw `concepts/memory`: [docs.openclaw.ai/concepts/memory](https://docs.openclaw.ai/concepts/memory)
+
+---
+
+📌 Atualizado em 04/05/2026 · Pixel Educação