Honcho adiciona memória nativa de IA ao OpenClaw. Ele persiste conversas em um serviço dedicado e constrói modelos de usuário e de agente ao longo do tempo, dando ao seu agente contexto entre sessões que vai além de arquivos Markdown do workspace.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
O que ele oferece
- Memória entre sessões — as conversas são persistidas após cada turno, então 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).
- Busca semântica — busca em observações de conversas passadas, não apenas na sessão atual.
- Consciência de vários agentes — agentes pais acompanham automaticamente subagentes gerados, com os pais adicionados como observadores em sessões filhas.
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 faz |
|---|---|
honcho_context | Representação completa do usuário entre sessões |
honcho_search_conclusions | Busca semântica em conclusões armazenadas |
honcho_search_messages | Localiza mensagens entre sessões (filtra por remetente, data) |
honcho_session | Histórico e resumo da sessão atual |
| Ferramenta | O que 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 Honcho pode ser executado totalmente localmente (auto-hospedado) ou por meio da API gerenciada em
api.honcho.dev. Nenhuma dependência externa é necessária para a opção
auto-hospedada.Configuração
As configurações ficam emplugins.entries["openclaw-honcho"].config:
baseUrl para seu servidor local (por exemplo
http://localhost:8000) e omita a chave de API.
Migrando memória existente
Se você já tiver arquivos de memória existentes no workspace (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), openclaw honcho setup detecta e
oferece a migração deles.
A migração não é destrutiva — os arquivos são enviados para o Honcho. Os originais
nunca são excluídos nem movidos.
Como funciona
Após cada turno da IA, a conversa é persistida no Honcho. Tanto mensagens do usuário quanto do agente são observadas, permitindo que o Honcho construa e refine seus modelos ao longo do tempo. Durante a conversa, as ferramentas do Honcho consultam o serviço na fasebefore_prompt_build,
injetando contexto relevante antes que o modelo veja o prompt. Isso garante
limites de turno precisos e recordação relevante.
Honcho vs memória integrada
| Integrada / QMD | Honcho | |
|---|---|---|
| Armazenamento | Arquivos Markdown do workspace | Serviço dedicado (local ou hospedado) |
| Entre sessões | Via arquivos de memória | Automático, integrado |
| Modelagem de usuário | Manual (gravar em MEMORY.md) | Perfis automáticos |
| Busca | Vetorial + palavra-chave (híbrida) | Semântica sobre observações |
| Vários agentes | Não rastreado | Consciência de pai/filho |
| Dependências | Nenhuma (integrada) ou binário QMD | Instalação de plugin |
Comandos da CLI
Leitura adicional
- Código-fonte do plugin
- Documentação do Honcho
- Guia de integração do Honcho com OpenClaw
- Memória — visão geral da memória do OpenClaw
- Motores de contexto — como funcionam os motores de contexto de plugin