Skip to content

Commit b364bc3

Browse files
authored
fix: rename openclawd to openclaw (#252)
* fix: rename openclawd to openclaw * fix: rename openclawd to openclaw * Revise OpenClaw documentation and remove dev section Updated the description of local memory for OpenClaw agents and removed the development section along with requirements and links.
1 parent 35f0984 commit b364bc3

File tree

23 files changed

+113
-145
lines changed

23 files changed

+113
-145
lines changed

.github/workflows/release.yml

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@ jobs:
139139
path: hindsight-clients/typescript/*.tgz
140140
retention-days: 1
141141

142-
release-openclawd-integration:
142+
release-openclaw-integration:
143143
runs-on: ubuntu-latest
144144
environment: npm
145145

@@ -153,15 +153,15 @@ jobs:
153153
registry-url: 'https://registry.npmjs.org'
154154

155155
- name: Install dependencies
156-
working-directory: ./hindsight-integrations/openclawd
156+
working-directory: ./hindsight-integrations/openclaw
157157
run: npm ci
158158

159159
- name: Build
160-
working-directory: ./hindsight-integrations/openclawd
160+
working-directory: ./hindsight-integrations/openclaw
161161
run: npm run build
162162

163163
- name: Publish to npm
164-
working-directory: ./hindsight-integrations/openclawd
164+
working-directory: ./hindsight-integrations/openclaw
165165
run: |
166166
set +e
167167
OUTPUT=$(npm publish --access public 2>&1)
@@ -178,14 +178,14 @@ jobs:
178178
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
179179

180180
- name: Pack for GitHub release
181-
working-directory: ./hindsight-integrations/openclawd
181+
working-directory: ./hindsight-integrations/openclaw
182182
run: npm pack
183183

184184
- name: Upload artifacts
185185
uses: actions/upload-artifact@v4
186186
with:
187-
name: openclawd-integration
188-
path: hindsight-integrations/openclawd/*.tgz
187+
name: openclaw-integration
188+
path: hindsight-integrations/openclaw/*.tgz
189189
retention-days: 1
190190

191191
release-control-plane:
@@ -415,7 +415,7 @@ jobs:
415415

416416
create-github-release:
417417
runs-on: ubuntu-latest
418-
needs: [release-python-packages, release-typescript-client, release-openclawd-integration, release-control-plane, release-rust-cli, release-docker-images, release-helm-chart]
418+
needs: [release-python-packages, release-typescript-client, release-openclaw-integration, release-control-plane, release-rust-cli, release-docker-images, release-helm-chart]
419419
permissions:
420420
contents: write
421421

@@ -438,11 +438,11 @@ jobs:
438438
name: typescript-client
439439
path: ./artifacts/typescript-client
440440

441-
- name: Download OpenClawd Integration
441+
- name: Download OpenClaw Integration
442442
uses: actions/download-artifact@v4
443443
with:
444-
name: openclawd-integration
445-
path: ./artifacts/openclawd-integration
444+
name: openclaw-integration
445+
path: ./artifacts/openclaw-integration
446446

447447
- name: Download Control Plane
448448
uses: actions/download-artifact@v4
@@ -485,8 +485,8 @@ jobs:
485485
cp artifacts/python-packages/hindsight-embed/dist/* release-assets/ || true
486486
# TypeScript client
487487
cp artifacts/typescript-client/*.tgz release-assets/ || true
488-
# OpenClawd Integration
489-
cp artifacts/openclawd-integration/*.tgz release-assets/ || true
488+
# OpenClaw Integration
489+
cp artifacts/openclaw-integration/*.tgz release-assets/ || true
490490
# Control Plane
491491
cp artifacts/control-plane/*.tgz release-assets/ || true
492492
# Rust CLI binaries

.github/workflows/test.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ jobs:
8282
- name: Build TypeScript client
8383
run: npm run build --workspace=hindsight-clients/typescript
8484

85-
build-openclawd-integration:
85+
build-openclaw-integration:
8686
runs-on: ubuntu-latest
8787

8888
steps:
@@ -94,15 +94,15 @@ jobs:
9494
node-version: '22'
9595

9696
- name: Install dependencies
97-
working-directory: ./hindsight-integrations/openclawd
97+
working-directory: ./hindsight-integrations/openclaw
9898
run: npm ci
9999

100100
- name: Run tests
101-
working-directory: ./hindsight-integrations/openclawd
101+
working-directory: ./hindsight-integrations/openclaw
102102
run: npm test
103103

104104
- name: Build
105-
working-directory: ./hindsight-integrations/openclawd
105+
working-directory: ./hindsight-integrations/openclaw
106106
run: npm run build
107107

108108
build-control-plane:

hindsight-docs/versioned_docs/version-0.4/sdks/integrations/openclawd.md renamed to hindsight-docs/docs/sdks/integrations/openclaw.md

Lines changed: 35 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
sidebar_position: 4
33
---
44

5-
# OpenClawd
5+
# OpenClaw
66

7-
Local-first, persistent memory for [OpenClawd](https://openclawd.ai) agents using [Hindsight](https://vectorize.io/hindsight).
7+
Local, long term memory for [OpenClaw](https://openclaw.ai) agents using [Hindsight](https://vectorize.io/hindsight).
88

99
This plugin integrates [hindsight-embed](https://vectorize.io/hindsight/cli), a standalone daemon that bundles Hindsight's memory engine (API + PostgreSQL) into a single command. Everything runs locally on your machine, reuses the LLM you're already paying for, and costs nothing extra. The plugin automatically manages the daemon lifecycle and provides hooks for seamless memory capture and recall.
1010

@@ -16,9 +16,9 @@ export OPENAI_API_KEY="sk-your-key"
1616
clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
1717

1818
# 2. Install and enable the plugin
19-
clawdbot plugins install @vectorize-io/hindsight-openclawd
19+
clawdbot plugins install @vectorize-io/hindsight-openclaw
2020

21-
# 3. Start OpenClawd
21+
# 3. Start OpenClaw
2222
clawdbot gateway
2323
```
2424

@@ -47,24 +47,29 @@ Auto-recall solves this by injecting relevant memories automatically before ever
4747
```json
4848
<hindsight_memories>
4949
[
50-
{
51-
"content": "User prefers JSON responses for technical data",
52-
"score": 0.95,
53-
"metadata": {
54-
"document_id": "session-abc123",
55-
"chunk_id": "chunk-1"
50+
{
51+
{
52+
"chunk_id": "openclawd_default-session_12",
53+
"context": "",
54+
"document_id": "default-session",
55+
"id": "5f55f684-e6f5-46e3-9f5c-043bdf005511",
56+
"mentioned_at": "2026-01-30T11:07:33.211396+00:00",
57+
"occurred_end": "2025-01-29T23:14:30+00:00",
58+
"occurred_start": "2025-01-29T23:14:30+00:00",
59+
"tags": [],
60+
"text": "Nicolò Boschi attended an OpenAI devday last year and found it cool. | When: 2025-01-30 | Involving: Nicolò Boschi",
61+
"type": "world"
5662
}
57-
}
5863
]
5964
</hindsight_memories>
6065
```
6166

6267
The agent sees past context automatically without needing to remember to remember. This approach trades token cost for reliability - but for conversational agents, spending 500 tokens on auto-injected context is better than ignoring 10,000 stored facts because the model didn't call a tool.
6368

64-
## Understanding OpenClawd Concepts
69+
## Understanding OpenClaw Concepts
6570

6671
### Plugins
67-
Extensions that add functionality to OpenClawd. This Hindsight plugin:
72+
Extensions that add functionality to OpenClaw. This Hindsight plugin:
6873
- Runs a background service (manages `hindsight-embed` daemon)
6974
- Registers hooks (automatic event handlers)
7075

@@ -79,7 +84,7 @@ Think of hooks as "forced automation" - they always run.
7984

8085
```
8186
┌─────────────────────────────────────────┐
82-
OpenClawd Gateway │
87+
OpenClaw Gateway
8388
│ │
8489
│ ┌───────────────────────────────────┐ │
8590
│ │ Hindsight Plugin │ │
@@ -95,11 +100,11 @@ Think of hooks as "forced automation" - they always run.
95100
uvx hindsight-embed
96101
• Daemon on port 8889
97102
• PostgreSQL (pg0://hindsight-embed)
98-
• Bank: 'openclawd' (isolated within shared database)
103+
• Bank: 'openclaw' (isolated within shared database)
99104
• Fact extraction
100105
```
101106

102-
**Database Architecture:** All banks share a single pg0 database instance (`pg0://hindsight-embed`). Bank isolation happens within the database via separate tables/schemas per bank ID. The 'openclawd' bank is automatically created when the plugin stores its first memory.
107+
**Database Architecture:** All banks share a single pg0 database instance (`pg0://hindsight-embed`). Bank isolation happens within the database via separate tables/schemas per bank ID. The 'openclaw' bank is automatically created when the plugin stores its first memory.
103108

104109
**Local-First Design:**
105110
- **Your data stays local**: All conversations, facts, and relationships stored in PostgreSQL on your machine
@@ -113,7 +118,7 @@ Think of hooks as "forced automation" - they always run.
113118
### Prerequisites
114119

115120
- **Node.js** 22+
116-
- **OpenClawd** (Clawdbot) with plugin support
121+
- **OpenClaw** (Clawdbot) with plugin support
117122
- **uv/uvx** for running `hindsight-embed`
118123
- **LLM API key** (OpenAI, Anthropic, etc.)
119124

@@ -125,9 +130,9 @@ export OPENAI_API_KEY="sk-your-key"
125130
clawdbot config set 'agents.defaults.models."openai/gpt-4o-mini"' '{}'
126131

127132
# 2. Install and enable the plugin
128-
clawdbot plugins install @vectorize-io/hindsight-openclawd
133+
clawdbot plugins install @vectorize-io/hindsight-openclaw
129134

130-
# 3. Start OpenClawd
135+
# 3. Start OpenClaw
131136
clawdbot gateway
132137
```
133138

@@ -142,7 +147,7 @@ Optional settings in `~/.clawdbot/clawdbot.json`:
142147
{
143148
"plugins": {
144149
"entries": {
145-
"hindsight-openclawd": {
150+
"hindsight-openclaw": {
146151
"enabled": true,
147152
"config": {
148153
"daemonIdleTimeout": 0
@@ -185,7 +190,7 @@ clawdbot plugins list | grep hindsight
185190
```
186191

187192
**Test auto-recall:**
188-
Send a message on any OpenClawd channel (Telegram, Slack, etc.):
193+
Send a message on any OpenClaw channel (Telegram, Slack, etc.):
189194
```
190195
User: My name is John and I love pizza
191196
Bot: Got it! I'll remember that.
@@ -201,7 +206,7 @@ tail -f ~/.hindsight/daemon.log
201206

202207
**Check memories in database:**
203208
```bash
204-
uvx hindsight-embed@latest memory recall openclawd "pizza" --output json
209+
uvx hindsight-embed@latest memory recall openclaw "pizza" --output json
205210
```
206211

207212
## Inspecting Memories
@@ -225,31 +230,31 @@ uvx hindsight-embed@latest ui
225230
**List memory banks:**
226231
```bash
227232
uvx hindsight-embed@latest bank list
228-
# Shows all banks including 'openclawd'
233+
# Shows all banks including 'openclaw'
229234
```
230235

231236
**Query memories:**
232237
```bash
233238
# Search memories
234-
uvx hindsight-embed@latest memory recall openclawd "user preferences" --output json
239+
uvx hindsight-embed@latest memory recall openclaw "user preferences" --output json
235240

236241
# View recent memories
237-
uvx hindsight-embed@latest memory list openclawd --limit 10
242+
uvx hindsight-embed@latest memory list openclaw --limit 10
238243

239244
# Export all memories
240-
uvx hindsight-embed@latest memory export openclawd --output memories.json
245+
uvx hindsight-embed@latest memory export openclaw --output memories.json
241246
```
242247

243248
**Inspect facts and entities:**
244249
```bash
245250
# List extracted facts
246-
uvx hindsight-embed@latest fact list openclawd
251+
uvx hindsight-embed@latest fact list openclaw
247252

248253
# List entities
249-
uvx hindsight-embed@latest entity list openclawd
254+
uvx hindsight-embed@latest entity list openclaw
250255

251256
# Show entity relationships
252-
uvx hindsight-embed@latest entity graph openclawd
257+
uvx hindsight-embed@latest entity graph openclaw
253258
```
254259

255260
## Troubleshooting
@@ -260,7 +265,7 @@ uvx hindsight-embed@latest entity graph openclawd
260265
clawdbot plugins list | grep -i hindsight
261266

262267
# Reinstall if needed
263-
clawdbot plugins install @vectorize-io/hindsight-openclawd
268+
clawdbot plugins install @vectorize-io/hindsight-openclaw
264269
```
265270

266271
**Daemon not starting?**
@@ -294,40 +299,3 @@ tail -f /tmp/clawdbot/clawdbot-*.log | grep Hindsight
294299
# [Hindsight Hook] agent_end triggered
295300
# [Hindsight] Retained X messages for session ...
296301
```
297-
298-
## Development
299-
300-
```bash
301-
# Clone repo
302-
git clone https://github.com/vectorize-io/hindsight.git
303-
cd hindsight/hindsight-integrations/openclawd
304-
305-
# Install dependencies
306-
npm install
307-
308-
# Build
309-
npm run build
310-
311-
# Run tests
312-
npm test
313-
314-
# Install locally
315-
npm run build && ./install.sh
316-
```
317-
318-
## Requirements
319-
320-
- **Node.js** 22+
321-
- **OpenClawd** (Clawdbot) with plugin support
322-
- **uv/uvx** for running `hindsight-embed`
323-
- **LLM API key** (OpenAI, Anthropic, etc.)
324-
325-
## License
326-
327-
MIT
328-
329-
## Links
330-
331-
- [Hindsight Documentation](https://vectorize.io/hindsight)
332-
- [OpenClawd Documentation](https://openclawd.ai)
333-
- [GitHub Repository](https://github.com/vectorize-io/hindsight)

hindsight-docs/sidebars.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -189,8 +189,8 @@ const sidebars: SidebarsConfig = {
189189
},
190190
{
191191
type: 'doc',
192-
id: 'sdks/integrations/openclawd',
193-
label: 'OpenClawd',
192+
id: 'sdks/integrations/openclaw',
193+
label: 'OpenClaw',
194194
},
195195
{
196196
type: 'doc',

hindsight-docs/src/pages/changelog.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,13 @@ For full release details, see [GitHub Releases](https://github.com/vectorize-io/
2929

3030
**Other**
3131

32-
- Rename the default bot/user identity from "moltbot" to "openclawd". ([`728ce13`](https://github.com/vectorize-io/hindsight/commit/728ce13))
32+
- Rename the default bot/user identity from "moltbot" to "openclaw". ([`728ce13`](https://github.com/vectorize-io/hindsight/commit/728ce13))
3333

3434
## [0.4.2](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.2)
3535

3636
**Features**
3737

38-
- Added Clawdbot/Moltbot/OpenClawd integration. ([`12e9a3d`](https://github.com/vectorize-io/hindsight/commit/12e9a3d))
38+
- Added Clawdbot/Moltbot/OpenClaw integration. ([`12e9a3d`](https://github.com/vectorize-io/hindsight/commit/12e9a3d))
3939

4040
**Improvements**
4141

0 commit comments

Comments
 (0)