Skip to content

Commit e487358

Browse files
authored
docs: improve OpenClaw integration page (plastic-labs#462)
- 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
1 parent 1e0f539 commit e487358

1 file changed

Lines changed: 17 additions & 18 deletions

File tree

docs/v3/guides/integrations/openclaw.mdx

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ sidebarTitle: 'OpenClaw'
1111
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.
1212
</Note>
1313

14+
For OpenClaw's own documentation on Honcho, see the [Honcho Memory guide](https://docs.openclaw.ai/concepts/memory-honcho).
1415

1516
## Install the Plugin
1617

@@ -67,7 +68,7 @@ Files are uploaded via `session.uploadFile()`. User/owner files go to the owner
6768
Once installed, the plugin runs automatically:
6869

6970
* **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.
7172
* **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.
7273
* **Clean Persistence** — Platform metadata (conversation info, sender headers, thread context, forwarded messages) is stripped before saving to Honcho, ensuring only meaningful content is persisted.
7374

@@ -84,17 +85,16 @@ OpenClaw uses a multi-agent architecture where a primary agent can spawn **subag
8485

8586
| Tool | Description |
8687
| ---- | ----------- |
87-
| `honcho_session` | Conversation history and summaries from the current session. |
88-
| `honcho_profile` | User's peer card — key facts (name, preferences, role). |
89-
| `honcho_search` | Semantic search over stored observations. |
90-
| `honcho_context` | Full user representation across all sessions. |
88+
| `honcho_context` | User knowledge across all sessions. `detail='card'` for key facts, `'full'` for broad representation. |
89+
| `honcho_search_conclusions` | Semantic vector search over stored conclusions ranked by relevance. |
90+
| `honcho_search_messages` | Find specific messages across all sessions. Filter by sender, date, or metadata. |
91+
| `honcho_session` | Current session history and summary. Supports semantic search within the session. |
9192

9293
### Q&A (LLM-powered)
9394

9495
| Tool | Description |
9596
| ---- | ----------- |
96-
| `honcho_recall` | Simple factual question — minimal reasoning. |
97-
| `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. |
9898

9999
## CLI Commands
100100

@@ -126,32 +126,27 @@ openclaw honcho setup
126126

127127
## Local File Search (QMD Integration)
128128

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.
130130

131131
### Setup
132132

133133
1. Install [QMD](https://github.com/tobi/qmd) on your server
134134

135-
2. Configure OpenClaw in `~/.openclaw/openclaw.json`:
135+
2. Configure OpenClaw to use QMD as the memory backend in `~/.openclaw/openclaw.json`:
136136

137137
```json
138138
{
139139
"memory": {
140-
"backend": "qmd",
141-
"qmd": {
142-
"limits": {
143-
"timeoutMs": 120000
144-
}
145-
}
140+
"backend": "qmd"
146141
}
147142
}
148143
```
149144

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:
151148

152149
```bash
153-
qmd collection add ~/Documents/notes --name notes
154-
qmd update
155150
openclaw gateway restart
156151
```
157152

@@ -172,6 +167,10 @@ When QMD is configured, you get both Honcho and local file tools:
172167
Source code, issues, and README.
173168
</Card>
174169

170+
<Card title="OpenClaw Memory Docs" icon="book" href="https://docs.openclaw.ai/concepts/memory">
171+
Memory backends, search, and configuration in the OpenClaw docs.
172+
</Card>
173+
175174
<Card title="Honcho Architecture" icon="sitemap" href="/v3/documentation/core-concepts/architecture">
176175
Learn about peers, sessions, and dialectic reasoning.
177176
</Card>

0 commit comments

Comments
 (0)