Skip to main content
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): Perguntas e respostas (com tecnologia de LLM):

​
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.
O Honcho pode ser executado inteiramente de forma local (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 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.
A migração não é destrutiva: os arquivos são enviados ao Honcho. Os originais nunca são excluídos nem movidos.

​
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

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

​
Leitura adicional

​
Relacionados