You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Fix tool names to match actual plugin code (honcho_context,
honcho_search_conclusions, honcho_search_messages, honcho_ask)
- Add link to OpenClaw Honcho Memory docs (docs.openclaw.ai)
- Add OpenClaw Memory Docs card in Next Steps
- Fix QMD setup: remove manual collection commands, link to OpenClaw QMD docs
Copy file name to clipboardExpand all lines: docs/v3/guides/integrations/openclaw.mdx
+17-18Lines changed: 17 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,6 +11,7 @@ sidebarTitle: 'OpenClaw'
11
11
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.
12
12
</Note>
13
13
14
+
For OpenClaw's own documentation on Honcho, see the [Honcho Memory guide](https://docs.openclaw.ai/concepts/memory-honcho).
14
15
15
16
## Install the Plugin
16
17
@@ -67,7 +68,7 @@ Files are uploaded via `session.uploadFile()`. User/owner files go to the owner
67
68
Once installed, the plugin runs automatically:
68
69
69
70
***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.
70
-
***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.
71
+
***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.
71
72
***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.
72
73
***Clean Persistence** — Platform metadata (conversation info, sender headers, thread context, forwarded messages) is stripped before saving to Honcho, ensuring only meaningful content is persisted.
73
74
@@ -84,17 +85,16 @@ OpenClaw uses a multi-agent architecture where a primary agent can spawn **subag
84
85
85
86
| Tool | Description |
86
87
| ---- | ----------- |
87
-
|`honcho_session`|Conversation history and summaries from the current session. |
|`honcho_analyze`| Complex question requiring synthesis — medium reasoning. |
97
+
|`honcho_ask`| Ask Honcho a question about the user. `depth='quick'` for facts, `'thorough'` for synthesis. |
98
98
99
99
## CLI Commands
100
100
@@ -126,32 +126,27 @@ openclaw honcho setup
126
126
127
127
## Local File Search (QMD Integration)
128
128
129
-
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.
129
+
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.
130
130
131
131
### Setup
132
132
133
133
1. Install [QMD](https://github.com/tobi/qmd) on your server
134
134
135
-
2. Configure OpenClaw in `~/.openclaw/openclaw.json`:
135
+
2. Configure OpenClaw to use QMD as the memory backend in `~/.openclaw/openclaw.json`:
136
136
137
137
```json
138
138
{
139
139
"memory": {
140
-
"backend": "qmd",
141
-
"qmd": {
142
-
"limits": {
143
-
"timeoutMs": 120000
144
-
}
145
-
}
140
+
"backend": "qmd"
146
141
}
147
142
}
148
143
```
149
144
150
-
3. Set up QMD collections and restart:
145
+
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.
146
+
147
+
3. Restart the gateway:
151
148
152
149
```bash
153
-
qmd collection add ~/Documents/notes --name notes
154
-
qmd update
155
150
openclaw gateway restart
156
151
```
157
152
@@ -172,6 +167,10 @@ When QMD is configured, you get both Honcho and local file tools:
0 commit comments