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:
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceO 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:
{ plugins: { entries: { "openclaw-honcho": { config: { apiKey: "your-api-key", // omita para auto-hospedagem workspaceId: "openclaw", // isolamento da memória baseUrl: "https://api.honcho.dev", }, }, }, },}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.
Comandos da CLI
openclaw honcho setup # Configurar a chave da API e migrar arquivosopenclaw honcho status # Verificar o status da conexãoopenclaw honcho ask <question> # Consultar o Honcho sobre o usuárioopenclaw honcho search <query> [-k N] [-d D] # Pesquisa semântica na memória