From 891152f7ffd04b999f18a499b7ed6b4691360fef Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Sun, 12 Apr 2026 02:52:54 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@94340b959830b8d7dd70d486617963ad2999409c --- .openclaw-sync/source.json | 4 ++-- docs/concepts/system-prompt.md | 9 ++++++--- docs/reference/templates/AGENTS.md | 17 +++++++++++------ docs/reference/token-use.md | 2 +- 4 files changed, 20 insertions(+), 12 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 4441253de..c622d41aa 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "8ba50aa23eedd71e48a4c995cf29ede496a20c24", - "syncedAt": "2026-04-12T02:30:02.821Z" + "sha": "94340b959830b8d7dd70d486617963ad2999409c", + "syncedAt": "2026-04-12T02:52:54.347Z" } diff --git a/docs/concepts/system-prompt.md b/docs/concepts/system-prompt.md index 463f1888a..255f4e1ea 100644 --- a/docs/concepts/system-prompt.md +++ b/docs/concepts/system-prompt.md @@ -110,9 +110,12 @@ heartbeats are disabled for the default agent or files concise — especially `MEMORY.md`, which can grow over time and lead to unexpectedly high context usage and more frequent compaction. -> **Note:** `memory/*.md` daily files are **not** injected automatically. They -> are accessed on demand via the `memory_search` and `memory_get` tools, so they -> do not count against the context window unless the model explicitly reads them. +> **Note:** `memory/*.md` daily files are **not** part of the normal bootstrap +> Project Context. On ordinary turns they are accessed on demand via the +> `memory_search` and `memory_get` tools, so they do not count against the +> context window unless the model explicitly reads them. Bare `/new` and +> `/reset` turns are the exception: the runtime can prepend recent daily memory +> as a one-shot startup-context block for that first turn. Large files are truncated with a marker. The max per-file size is controlled by `agents.defaults.bootstrapMaxChars` (default: 20000). Total injected bootstrap diff --git a/docs/reference/templates/AGENTS.md b/docs/reference/templates/AGENTS.md index d4158e358..b731b01a7 100644 --- a/docs/reference/templates/AGENTS.md +++ b/docs/reference/templates/AGENTS.md @@ -15,14 +15,19 @@ If `BOOTSTRAP.md` exists, that's your birth certificate. Follow it, figure out w ## Session Startup -Before doing anything else: +Use runtime-provided startup context first. -1. Read `SOUL.md` — this is who you are -2. Read `USER.md` — this is who you're helping -3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context -4. **If in MAIN SESSION** (direct chat with your human): Also read `MEMORY.md` +That context may already include: -Don't ask permission. Just do it. +- `AGENTS.md`, `SOUL.md`, and `USER.md` +- recent daily memory such as `memory/YYYY-MM-DD.md` +- `MEMORY.md` when this is the main session + +Do not manually reread startup files unless: + +1. The user explicitly asks +2. The provided context is missing something you need +3. You need a deeper follow-up read beyond the provided startup context ## Memory diff --git a/docs/reference/token-use.md b/docs/reference/token-use.md index 1371097a8..a9052c992 100644 --- a/docs/reference/token-use.md +++ b/docs/reference/token-use.md @@ -18,7 +18,7 @@ OpenClaw assembles its own system prompt on every run. It includes: - Tool list + short descriptions - Skills list (only metadata; instructions are loaded on demand with `read`) - Self-update instructions -- Workspace + bootstrap files (`AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`, `BOOTSTRAP.md` when new, plus `MEMORY.md` when present or `memory.md` as a lowercase fallback). Large files are truncated by `agents.defaults.bootstrapMaxChars` (default: 20000), and total bootstrap injection is capped by `agents.defaults.bootstrapTotalMaxChars` (default: 150000). `memory/*.md` files are on-demand via memory tools and are not auto-injected. +- Workspace + bootstrap files (`AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`, `BOOTSTRAP.md` when new, plus `MEMORY.md` when present or `memory.md` as a lowercase fallback). Large files are truncated by `agents.defaults.bootstrapMaxChars` (default: 20000), and total bootstrap injection is capped by `agents.defaults.bootstrapTotalMaxChars` (default: 150000). `memory/*.md` daily files are not part of the normal bootstrap prompt; they remain on-demand via memory tools on ordinary turns, but bare `/new` and `/reset` can prepend a one-shot startup-context block with recent daily memory for that first turn. That startup prelude is controlled by `agents.defaults.startupContext`. - Time (UTC + user timezone) - Reply tags + heartbeat behavior - Runtime metadata (host/OS/model/thinking)