qwang6-1936520/Human-like-memory-skill

Habilidade de Memória com Estilo Humano

Ferramentas de memória de longo prazo utilizáveis pelo agente para Memória com Estilo Humano.

Esta skill oferece suporte a:

• Recuperação e salvamento acionados pelo agente quando o modelo julga que a memória é útil
• Invocação explícita pelo usuário quando ele pede diretamente para lembrar ou armazenar uma memória

Esta skill não está sempre ativa intencionalmente:

• Por padrão, não deve recuperar memórias a cada turno
• Por padrão, não deve salvar silenciosamente cada turno da conversa
• Ela lê apenas variáveis de ambiente expostas ao runtime
• Não lê arquivos de segredo locais ou arquivos de configuração privados por skill

Se você deseja recuperação/armazenamento automático sempre ativo, use o plugin Human-Like Memory em vez desta skill.

Divulgação de Dados e Rede

Quando o agente ou usuário invoca esta skill:

• recall / search envia sua consulta, user_id e agent_id para https://plugin.human-like.me ou sua URL base configurada
• save / save-batch envia o conteúdo da conversa que você explicitamente passar para o mesmo serviço
• Nenhum arquivo local, histórico do shell ou variável de ambiente não relacionada é lido ou enviado

Quando Usar

• Você deseja pesquisar explicitamente memórias passadas
• Você deseja salvar explicitamente um fato, decisão, preferência ou resumo do usuário
• O agente precisa de contexto passado para responder bem
• O agente deve salvar uma preferência, decisão, correção ou resumo durável

Quando Não Usar

• Você deseja recuperação automática a cada turno ou salvamento em segundo plano no nível de hook
• Você precisa de atividade de rede oculta ou silenciosa
• Você quer zero transferência remota de dados

Configuração

1. Obter Chave de API

Visite plugin.human-like.me e copie sua chave mp_xxx.

2. Configurar Através do Hermes

export HUMAN_LIKE_MEM_API_KEY="mp_your_key_here"
export HUMAN_LIKE_MEM_BASE_URL="https://plugin.human-like.me"
export HUMAN_LIKE_MEM_USER_ID="hermes-user"
export HUMAN_LIKE_MEM_AGENT_ID="main"

Você também pode usar a configuração segura de ambiente do Hermes quando solicitado no momento do carregamento da skill.

3. Verificar

node {baseDir}/scripts/memory.mjs config

A saída esperada inclui:

{
  "apiKeyConfigured": true
}

Comandos

Recuperar ou Pesquisar Memória

node {baseDir}/scripts/memory.mjs recall "<consulta>"
node {baseDir}/scripts/memory.mjs search "<consulta>"

Salvar um Turno

node {baseDir}/scripts/memory.mjs save "<mensagem_do_usuário>" "<resposta_do_assistente>"

Salvar um Lote

echo '[{"role":"user","content":"..."},{"role":"assistant","content":"..."}]' | node {baseDir}/scripts/memory.mjs save-batch

Inspecionar Configuração em Tempo de Execução

node {baseDir}/scripts/memory.mjs config

Estilo de Invocação do Agente

Esta skill pode ser chamada pelo agente quando a memória é claramente útil.

Comportamento recomendado:

• Use recall / search quando o usuário fizer referência a trabalho anterior, preferências anteriores, decisões anteriores ou pedir para continuar algo de antes
• Use save quando o usuário pedir explicitamente para lembrar algo, corrigir detalhes de identidade, declarar uma preferência estável ou confirmar uma decisão importante
• Use save-batch após uma discussão significativa de vários turnos se HUMAN_LIKE_MEM_AUTO_SAVE_ENABLED=true e a conversa atual tiver acumulado aproximadamente HUMAN_LIKE_MEM_SAVE_TRIGGER_TURNS turnos
• Não chame as APIs de memória para saudações simples ou perguntas genéricas de um único turno sem valor de continuidade

Isso dá autonomia ao agente, mas mantém a skill em um modo de acionamento inteligente em vez de um modo sempre ativo.

Consultas Sugeridas

• Recuperar: "decisões de roadmap da semana passada"
• Pesquisar: "qual preferência de nome eu mencionei"
• Salvar: "Prefiro timestamps UTC+8"

Gatilhos de Salvamento

O agente deve considerar fortemente o uso de save quando o usuário:

• declarar uma preferência estável
• tomar ou confirmar uma decisão
• fornecer um fato de perfil pessoal que importe mais tarde
• corrigir um equívoco anterior
• disser explicitamente "lembre disso"

O agente pode usar save-batch após uma troca mais longa quando um resumo compacto dos últimos turnos provavelmente ajudar na continuidade futura.

Tratamento de Erros

• Se a chave de API estiver faltando, o script imprime as etapas exatas de configuração da variável de ambiente
• Se o serviço expirar ou retornar erro, nada é salvo implicitamente
• Se nenhuma memória for encontrada, trate isso como um resultado vazio normal

Privacidade

• Evite enviar senhas, tokens ou segredos
• Passe apenas conteúdo com o qual você se sinta confortável em armazenar no serviço de memória configurado
• Consulte SECURITY.md para campos transmitidos e notas operacionais

Notas de Compatibilidade com OpenClaw

• Artefatos de metadados OpenClaw são preservados em compat/openclaw/.
• Os comandos em tempo de execução permanecem compatíveis (a superfície de comando scripts/memory.mjs não foi alterada).