Honcho memory

기준일: 2026-07-26
공식 기준: Honcho memory

Honcho memory 문서는 OpenClaw 공식 문서(concepts/memory-honcho)를 한국어로 정리한 가이드입니다. AI-native cross-session memory via the Honcho plugin 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

AI-native cross-session memory via the Honcho plugin

한국어 가이드 범위: concepts/memory-honcho 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• What it provides
• Available tools
• Getting started
• 구성
• Migrating existing memory
• 동작 방식
• Honcho vs builtin memory
• CLI commands
• Further reading
• 관련 문서

상세 내용

본문

Honcho adds AI-native memory to OpenClaw through an external plugin. It persists conversations to a dedicated service and builds user and agent models over time, giving your agent cross-session context that goes beyond workspace Markdown files.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

What it provides

context carries across session resets, compaction, and channel switches.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Cross-session memory - conversations persist after every turn, so
• User modeling - Honcho maintains a profile for each user (preferences,
• Semantic search - search over observations from past conversations, not
• Multi-agent awareness - parent agents automatically track spawned

Available tools

Honcho registers tools the agent can use during conversation:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Tool	What it does
honcho_context	Full user representation across sessions
honcho_search_conclusions	Semantic search over stored conclusions
honcho_search_messages	Find messages across sessions (filter by sender, date)
honcho_session	Current session history and summary

Tool	What it does
honcho_ask	Ask about the user. depth='quick' for facts, 'thorough' for synthesis

Getting started

The setup command prompts for your API credentials, writes the config, and optionally migrates existing workspace memory files.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force

구성

Settings live under plugins.entries["openclaw-honcho"].config:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  plugins: {
    entries: {
      "openclaw-honcho": {
        config: {
          apiKey: "your-api-key", // omit for self-hosted
          workspaceId: "openclaw", // memory isolation
          baseUrl: "https://api.honcho.dev",
        },
      },
    },
  },
}

Migrating existing memory

If you have existing workspace memory files (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/), openclaw honcho setup detects and offers to migrate them.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

동작 방식

After every AI turn, the conversation is persisted to Honcho. Both user and agent messages are observed, letting Honcho build and refine its models over time.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Honcho vs builtin memory

Honcho and the builtin memory system can work together. When QMD is configured, additional tools become available for searching local Markdown files alongside Honcho's cross-session memory.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

	Builtin / QMD	Honcho
Storage	Workspace Markdown files	Dedicated service (local or hosted)
Cross-session	Via memory files	Automatic, built-in
User modeling	Manual (write to MEMORY.md)	Automatic profiles
Search	Vector + keyword (hybrid)	Semantic over observations
Multi-agent	Not tracked	Parent/child awareness
Dependencies	None (builtin) or QMD binary	Plugin install

CLI commands

openclaw honcho setup                        # Configure API key and migrate files
openclaw honcho status                       # Check connection status
openclaw honcho ask <question>               # Query Honcho about the user
openclaw honcho search <query> [-k N] [-d D] # Semantic search over memory

Further reading

주요 항목:

• Plugin source code
• Honcho documentation
• Honcho OpenClaw integration guide

관련 문서

주요 항목:

• Memory overview
• Builtin memory engine
• QMD memory engine
• Context Engines

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/concepts/memory-honcho
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force

{
  plugins: {
    entries: {
      "openclaw-honcho": {
        config: {
          apiKey: "your-api-key", // omit for self-hosted
          workspaceId: "openclaw", // memory isolation
          baseUrl: "https://api.honcho.dev",
        },
      },
    },
  },
}

openclaw honcho setup                        # Configure API key and migrate files
openclaw honcho status                       # Check connection status
openclaw honcho ask <question>               # Query Honcho about the user
openclaw honcho search <query> [-k N] [-d D] # Semantic search over memory

관련 링크

• 공식 원문: concepts/memory-honcho
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.