From 031c3b22deef656e4834a0e32e4a3857cdc160d6 Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Thu, 23 Apr 2026 20:26:17 -0700 Subject: [PATCH] docs: clarify pruning behavior and setup TL;DR orientation --- docs/concepts/context.md | 2 +- docs/start/setup.md | 8 +++++--- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/concepts/context.md b/docs/concepts/context.md index 2b1ca0ec845..46412ef7de9 100644 --- a/docs/concepts/context.md +++ b/docs/concepts/context.md @@ -147,7 +147,7 @@ What persists across messages depends on the mechanism: - **Normal history** persists in the session transcript until compacted/pruned by policy. - **Compaction** persists a summary into the transcript and keeps recent messages intact. -- **Pruning** removes old tool results from the _in-memory_ prompt for a run, but does not rewrite the transcript. +- **Pruning** drops old tool results from the _in-memory_ prompt to free context-window space, but does not rewrite the session transcript — the full history is still inspectable on disk. Docs: [Session](/concepts/session), [Compaction](/concepts/compaction), [Session pruning](/concepts/session-pruning). diff --git a/docs/start/setup.md b/docs/start/setup.md index 513f4ff1e4c..227b5f16b56 100644 --- a/docs/start/setup.md +++ b/docs/start/setup.md @@ -13,9 +13,11 @@ For onboarding details, see [Onboarding (CLI)](/start/wizard). ## TL;DR -- **Tailoring lives outside the repo:** `~/.openclaw/workspace` (workspace) + `~/.openclaw/openclaw.json` (config). -- **Stable workflow:** install the macOS app; let it run the bundled Gateway. -- **Bleeding edge workflow:** run the Gateway yourself via `pnpm gateway:watch`, then let the macOS app attach in Local mode. +Pick a setup workflow based on how often you want updates and whether you want to run the Gateway yourself: + +- **Tailoring lives outside the repo:** keep your config and workspace in `~/.openclaw/openclaw.json` and `~/.openclaw/workspace/` so repo updates don't touch them. +- **Stable workflow (recommended for most):** install the macOS app and let it run the bundled Gateway. +- **Bleeding edge workflow (dev):** run the Gateway yourself via `pnpm gateway:watch`, then let the macOS app attach in Local mode. ## Prereqs (from source)