Human-Like Memory Skill은(는) 무엇을 하나요?
에이전트가 사용할 수 있는 Human-Like Memory용 장기 기억 도구입니다.
이 스킬은 다음을 지원합니다:
- 모델이 기억이 유용하다고 판단할 때 에이전트가 트리거하는 기억 회상 및 저장
- 사용자가 직접 기억을 회상하거나 저장하도록 요청할 때 명시적 호출
이 스킬은 의도적으로 항상 켜져 있지 않습니다:
- 기본적으로 매 턴마다 기억을 회상하지 않습니다
- 기본적으로 모든 대화 턴을 자동으로 저장하지 않습니다
- 런타임에 노출된 환경 변수만 읽습니다
- 로컬 비밀 파일이나 스킬별 개인 설정 파일은 읽지 않습니다
항상 켜져 있는 자동 회상/저장 기능을 원하신다면, 이 스킬 대신 Human-Like Memory 플러그인을 사용하세요.
데이터 및 네트워크 공개
에이전트 또는 사용자가 이 스킬을 호출할 때:
recall/search는 쿼리,user_id및agent_id를https://plugin.human-like.me또는 설정된 기본 URL로 전송합니다.save/save-batch는 명시적으로 전달한 대화 내용을 동일한 서비스로 전송합니다.- 로컬 파일, 셸 기록 또는 관련 없는 환경 변수는 읽거나 업로드되지 않습니다.
사용 시점
- 과거 기억을 명시적으로 검색하려는 경우
- 사용자 사실, 결정, 선호도 또는 요약을 명시적으로 저장하려는 경우
- 에이전트가 정확한 답변을 위해 과거 맥락이 필요한 경우
- 에이전트가 지속적인 선호도, 결정, 수정 사항 또는 요약을 저장해야 하는 경우
사용하지 말아야 할 경우
- 매 턴 자동 회상이나 후크 수준의 백그라운드 저장이 필요한 경우
- 숨겨진 또는 비공개 네트워크 활동이 필요한 경우
- 원격 데이터 전송이 전혀 없어야 하는 경우
설정
1. API 키 받기
plugin.human-like.me를 방문하여 mp_xxx 키를 복사하세요.
2. 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"
스킬 로드 시 Hermes의 보안 환경 변수 설정 프롬프트를 사용할 수도 있습니다.
3. 확인
node {baseDir}/scripts/memory.mjs config
예상 출력:
{
"apiKeyConfigured": true
}
명령어
기억 회상 또는 검색
node {baseDir}/scripts/memory.mjs recall "<query>"
node {baseDir}/scripts/memory.mjs search "<query>"
한 턴 저장
node {baseDir}/scripts/memory.mjs save "<user_message>" "<assistant_response>"
배치 저장
echo '[{"role":"user","content":"..."},{"role":"assistant","content":"..."}]' | node {baseDir}/scripts/memory.mjs save-batch
런타임 설정 확인
node {baseDir}/scripts/memory.mjs config
에이전트 호출 스타일
이 스킬은 기억이 명확히 유용할 때 에이전트가 호출할 수 있습니다.
권장 동작:
- 사용자가 이전 작업, 이전 선호도, 이전 결정을 언급하거나 이전 내용을 계속 요청할 때
recall/search를 사용하세요. - 사용자가 명시적으로 기억하도록 요청하거나, 신원 정보를 수정하거나, 안정적인 선호도를 밝히거나, 중요한 결정을 확인할 때
save를 사용하세요. HUMAN_LIKE_MEM_AUTO_SAVE_ENABLED=true이고 현재 대화가 약HUMAN_LIKE_MEM_SAVE_TRIGGER_TURNS턴을 축적한 경우, 의미 있는 다중 턴 논의 후save-batch를 사용하세요.- 단순한 인사말이나 연속성이 없는 일반적인 단일 턴 질문에는 메모리 API를 호출하지 마세요.
이 방식은 에이전트에게 자율성을 부여하면서 스킬을 항상 켜짐 모드 대신 스마트 트리거 모드로 유지합니다.
제안된 쿼리
- 회상:
"지난주 로드맵 결정" - 검색:
"내가 언급한 이름 선호도는 무엇인가요" - 저장:
"저는 UTC+8 타임스탬프를 선호합니다"
저장 트리거
다음과 같은 경우 에이전트는 save를 적극 고려해야 합니다:
- 사용자가 안정적인 선호도를 밝힌 경우
- 사용자가 결정을 내리거나 확인한 경우
- 사용자가 나중에 중요한 개인 프로필 정보를 제공한 경우
- 사용자가 이전 오해를 수정한 경우
- 사용자가 명시적으로 "이것을 기억해 주세요"라고 말한 경우
에이전트는 긴 교환 후에 마지막 몇 턴의 간결한 요약이 향후 연속성에 도움이 될 가능성이 있을 때 save-batch를 사용할 수 있습니다.
오류 처리
- API 키가 없으면 스크립트가 정확한 환경 변수 설정 단계를 출력합니다.
- 서비스 시간 초과 또는 오류가 발생하면 아무것도 암시적으로 저장되지 않습니다.
- 기억을 찾을 수 없으면 정상적인 빈 결과로 처리하세요.
개인정보 보호
- 비밀번호, 토큰 또는 비밀은 전송하지 마세요.
- 설정된 기억 서비스에 저장해도 괜찮은 내용만 전달하세요.
- 전송되는 필드 및 운영 참고 사항은 SECURITY.md를 검토하세요.
OpenClaw 호환성 참고 사항
- OpenClaw 메타데이터 아티팩트는
compat/openclaw/에 보존됩니다. - 런타임 명령어는 호환성을 유지합니다 (
scripts/memory.mjs명령 인터페이스는 변경되지 않음).