diff --git a/docs/v3/guides/integrations/openclaw.mdx b/docs/v3/guides/integrations/openclaw.mdx index 7f7b9af5..17c569ac 100644 --- a/docs/v3/guides/integrations/openclaw.mdx +++ b/docs/v3/guides/integrations/openclaw.mdx @@ -11,6 +11,7 @@ sidebarTitle: 'OpenClaw' Honcho can run entirely locally with OpenClaw — no external API required. Keep your data on your machine while getting full memory capabilities across all channels. See the [self-hosting guide](/v3/contributing/self-hosting) to get started. +For OpenClaw's own documentation on Honcho, see the [Honcho Memory guide](https://docs.openclaw.ai/concepts/memory-honcho). ## Install the Plugin @@ -67,7 +68,7 @@ Files are uploaded via `session.uploadFile()`. User/owner files go to the owner Once installed, the plugin runs automatically: * **Message Observation** — After every AI turn, the conversation is persisted to Honcho. Both user and agent messages are observed, allowing Honcho to build and refine its models. -* **Tool-Based Context Access** — The AI can query Honcho mid-conversation using tools like `honcho_recall`, `honcho_search`, and `honcho_analyze` to retrieve relevant context. Context is injected during OpenClaw's `before_prompt_build` phase, ensuring accurate turn boundaries. +* **Tool-Based Context Access** — The AI can query Honcho mid-conversation using tools like `honcho_context`, `honcho_search_conclusions`, `honcho_search_messages`, and `honcho_ask` to retrieve relevant context. Context is injected during OpenClaw's `before_prompt_build` phase, ensuring accurate turn boundaries. * **Dual Peer Model** — Honcho maintains separate representations: one for the user (preferences, facts, communication style) and one for the agent (personality, learned behaviors). Each OpenClaw agent gets its own Honcho peer (`agent-{id}`), so multi-agent workspaces maintain isolated memory. * **Clean Persistence** — Platform metadata (conversation info, sender headers, thread context, forwarded messages) is stripped before saving to Honcho, ensuring only meaningful content is persisted. @@ -84,17 +85,16 @@ OpenClaw uses a multi-agent architecture where a primary agent can spawn **subag | Tool | Description | | ---- | ----------- | -| `honcho_session` | Conversation history and summaries from the current session. | -| `honcho_profile` | User's peer card — key facts (name, preferences, role). | -| `honcho_search` | Semantic search over stored observations. | -| `honcho_context` | Full user representation across all sessions. | +| `honcho_context` | User knowledge across all sessions. `detail='card'` for key facts, `'full'` for broad representation. | +| `honcho_search_conclusions` | Semantic vector search over stored conclusions ranked by relevance. | +| `honcho_search_messages` | Find specific messages across all sessions. Filter by sender, date, or metadata. | +| `honcho_session` | Current session history and summary. Supports semantic search within the session. | ### Q&A (LLM-powered) | Tool | Description | | ---- | ----------- | -| `honcho_recall` | Simple factual question — minimal reasoning. | -| `honcho_analyze` | Complex question requiring synthesis — medium reasoning. | +| `honcho_ask` | Ask Honcho a question about the user. `depth='quick'` for facts, `'thorough'` for synthesis. | ## CLI Commands @@ -126,32 +126,27 @@ openclaw honcho setup ## Local File Search (QMD Integration) -The plugin automatically exposes OpenClaw's `memory_search` and `memory_get` tools when a memory backend is configured, allowing both Honcho cloud memory and local file search together. +The plugin automatically exposes OpenClaw's `memory_search` and `memory_get` tools when a [memory backend](https://docs.openclaw.ai/concepts/memory) is configured, allowing both Honcho memory and local file search together. ### Setup 1. Install [QMD](https://github.com/tobi/qmd) on your server -2. Configure OpenClaw in `~/.openclaw/openclaw.json`: +2. Configure OpenClaw to use QMD as the memory backend in `~/.openclaw/openclaw.json`: ```json { "memory": { - "backend": "qmd", - "qmd": { - "limits": { - "timeoutMs": 120000 - } - } + "backend": "qmd" } } ``` -3. Set up QMD collections and restart: +OpenClaw manages QMD collections automatically from your workspace memory files and any extra paths in `memory.qmd.paths`. See the [QMD Memory Engine docs](https://docs.openclaw.ai/concepts/memory-qmd) for full setup. + +3. Restart the gateway: ```bash -qmd collection add ~/Documents/notes --name notes -qmd update openclaw gateway restart ``` @@ -172,6 +167,10 @@ When QMD is configured, you get both Honcho and local file tools: Source code, issues, and README. + + Memory backends, search, and configuration in the OpenClaw docs. + + Learn about peers, sessions, and dialectic reasoning.