Nesta página
Nesta página
Sessions and memory
Memória do Honcho
Honcho adiciona memória nativa para IA ao OpenClaw por meio de um Plugin externo. Ele persiste conversas em um serviço dedicado e cria modelos do usuário e do agente ao longo do tempo, fornecendo ao seu agente um contexto entre sessões que vai além dos arquivos Markdown do espaço de trabalho.
O que ele oferece
- Memória entre sessões - as conversas persistem após cada turno, portanto o contexto é mantido entre redefinições de sessão, Compaction e trocas de canal.
- Modelagem de usuário - o Honcho mantém um perfil para cada usuário (preferências, fatos, estilo de comunicação) e para o agente (personalidade, comportamentos aprendidos).
- Pesquisa semântica - pesquisa observações de conversas anteriores, não apenas da sessão atual.
- Reconhecimento de múltiplos agentes - agentes superiores acompanham automaticamente os subagentes iniciados, com os agentes superiores adicionados como observadores nas sessões dos agentes subordinados.
Ferramentas disponíveis
O Honcho registra ferramentas que o agente pode usar durante a conversa:
Recuperação de dados (rápida, sem chamada ao LLM):
| Ferramenta | O que ela faz |
|---|---|
honcho_context |
Representação completa do usuário entre sessões |
honcho_search_conclusions |
Pesquisa semântica em conclusões armazenadas |
honcho_search_messages |
Localiza mensagens entre sessões (filtra por remetente e data) |
honcho_session |
Histórico e resumo da sessão atual |
Perguntas e respostas (com tecnologia de LLM):
| Ferramenta | O que ela faz |
|---|---|
honcho_ask |
Faz perguntas sobre o usuário. depth='quick' para fatos, 'thorough' para síntese |
Primeiros passos
Instale o Plugin e execute a configuração:
O comando de configuração solicita suas credenciais de API, grava a configuração e, opcionalmente, migra os arquivos de memória existentes do espaço de trabalho.
Configuração
As configurações ficam em plugins.entries["openclaw-honcho"].config:
Para instâncias auto-hospedadas, aponte baseUrl para seu servidor local (por exemplo,
http://localhost:8000) e omita a chave de API.
Migração da memória existente
Se você tiver arquivos de memória existentes no espaço de trabalho (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), o openclaw honcho setup os detectará e
oferecerá a opção de migrá-los.
Como funciona
Após cada turno da IA, a conversa é persistida no Honcho. As mensagens do usuário e do agente são observadas, permitindo que o Honcho crie e refine seus modelos ao longo do tempo.
Durante a conversa, as ferramentas do Honcho consultam o serviço por meio do
gancho de Plugin before_prompt_build do OpenClaw, injetando o contexto relevante antes que o modelo
receba o prompt.
Honcho em comparação com a memória integrada
| Integrada / QMD | Honcho | |
|---|---|---|
| Armazenamento | Arquivos Markdown do espaço de trabalho | Serviço dedicado (local ou hospedado) |
| Entre sessões | Por meio de arquivos de memória | Automático e integrado |
| Modelagem de usuário | Manual (gravação em MEMORY.md) | Perfis automáticos |
| Pesquisa | Vetorial + palavra-chave (híbrida) | Semântica em observações |
| Múltiplos agentes | Não rastreados | Reconhecimento de relação superior/subordinado |
| Dependências | Nenhuma (integrada) ou binário QMD | Instalação do Plugin |
O Honcho e o sistema de memória integrado podem funcionar juntos. Quando o QMD está configurado, ferramentas adicionais ficam disponíveis para pesquisar arquivos Markdown locais em conjunto com a memória entre sessões do Honcho.
