rezero-household commited on
Commit
81fda2e
·
1 Parent(s): e24dd1e

docs: clarify OPENCLAW_MEMORY_DIR for memory browser

Browse files

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

Files changed (2) hide show
  1. .env.example +6 -0
  2. 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