Spaces:
Runtime error
Runtime error
rezero-household commited on
Commit ·
81fda2e
1
Parent(s): e24dd1e
docs: clarify OPENCLAW_MEMORY_DIR for memory browser
Browse filesOpenClaw does not create a memory/ subdirectory under OPENCLAW_HOME.
Agent memory markdown files (daily logs, MEMORY.md, etc.) live in each
agent's workspace directory, not in ~/.openclaw/memory/.
Without OPENCLAW_MEMORY_DIR set, the memory browser falls back to
OPENCLAW_HOME, which only contains .sqlite session indices — not the
human-readable markdown files users expect to see.
Document the correct value and add an inline note to .env.example.
- .env.example +6 -0
- README.md +10 -0
.env.example
CHANGED
|
@@ -67,6 +67,12 @@ NEXT_PUBLIC_GATEWAY_URL=
|
|
| 67 |
# === OpenClaw Paths (derived from OPENCLAW_HOME if not set) ===
|
| 68 |
# OPENCLAW_LOG_DIR=/path/to/.openclaw/logs
|
| 69 |
# OPENCLAW_MEMORY_DIR=/path/to/.openclaw/memory
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 70 |
# OPENCLAW_SOUL_TEMPLATES_DIR=/path/to/.openclaw/templates/souls
|
| 71 |
# OPENCLAW_BIN=openclaw
|
| 72 |
|
|
|
|
| 67 |
# === OpenClaw Paths (derived from OPENCLAW_HOME if not set) ===
|
| 68 |
# OPENCLAW_LOG_DIR=/path/to/.openclaw/logs
|
| 69 |
# OPENCLAW_MEMORY_DIR=/path/to/.openclaw/memory
|
| 70 |
+
#
|
| 71 |
+
# NOTE: OpenClaw does NOT store agent memory markdown files under OPENCLAW_HOME/memory/.
|
| 72 |
+
# That directory does not exist by default. Agent memory lives in each agent's workspace
|
| 73 |
+
# (e.g. ~/clawd-agents/{agent}/memory/). Point this at your agents root to make the
|
| 74 |
+
# Memory Browser useful:
|
| 75 |
+
# OPENCLAW_MEMORY_DIR=/home/you/clawd-agents
|
| 76 |
# OPENCLAW_SOUL_TEMPLATES_DIR=/path/to/.openclaw/templates/souls
|
| 77 |
# OPENCLAW_BIN=openclaw
|
| 78 |
|
README.md
CHANGED
|
@@ -282,10 +282,20 @@ See [`.env.example`](.env.example) for the complete list. Key variables:
|
|
| 282 |
| `OPENCLAW_HOME` | Yes* | Path to `.openclaw` directory |
|
| 283 |
| `OPENCLAW_GATEWAY_HOST` | No | Gateway host (default: `127.0.0.1`) |
|
| 284 |
| `OPENCLAW_GATEWAY_PORT` | No | Gateway WebSocket port (default: `18789`) |
|
|
|
|
| 285 |
| `MC_ALLOWED_HOSTS` | No | Host allowlist for production |
|
| 286 |
|
| 287 |
*Memory browser, log viewer, and gateway config require `OPENCLAW_HOME`.
|
| 288 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 289 |
## Deployment
|
| 290 |
|
| 291 |
```bash
|
|
|
|
| 282 |
| `OPENCLAW_HOME` | Yes* | Path to `.openclaw` directory |
|
| 283 |
| `OPENCLAW_GATEWAY_HOST` | No | Gateway host (default: `127.0.0.1`) |
|
| 284 |
| `OPENCLAW_GATEWAY_PORT` | No | Gateway WebSocket port (default: `18789`) |
|
| 285 |
+
| `OPENCLAW_MEMORY_DIR` | No | Memory browser root (see note below) |
|
| 286 |
| `MC_ALLOWED_HOSTS` | No | Host allowlist for production |
|
| 287 |
|
| 288 |
*Memory browser, log viewer, and gateway config require `OPENCLAW_HOME`.
|
| 289 |
|
| 290 |
+
> **Memory Browser note:** OpenClaw does not store agent memory markdown files under
|
| 291 |
+
> `$OPENCLAW_HOME/memory/` — that directory does not exist by default. Agent memory lives
|
| 292 |
+
> in each agent's workspace (e.g. `~/clawd-agents/{agent}/memory/`). Set
|
| 293 |
+
> `OPENCLAW_MEMORY_DIR` to your agents root directory to make the Memory Browser show
|
| 294 |
+
> daily logs, `MEMORY.md`, and other markdown files:
|
| 295 |
+
> ```
|
| 296 |
+
> OPENCLAW_MEMORY_DIR=/home/you/clawd-agents
|
| 297 |
+
> ```
|
| 298 |
+
|
| 299 |
## Deployment
|
| 300 |
|
| 301 |
```bash
|