{"id":247,"date":"2026-03-21T22:47:24","date_gmt":"2026-03-21T14:47:24","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/reference-session-management-compaction\/"},"modified":"2026-03-21T23:08:54","modified_gmt":"2026-03-21T15:08:54","slug":"reference-session-management-compaction","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/reference-session-management-compaction\/","title":{"rendered":"\u4f1a\u8bdd\u7ba1\u7406\u6df1\u5165\u4e86\u89e3"},"content":{"rendered":"<h1>\u4f1a\u8bdd\u7ba1\u7406\u6df1\u5165\u4e86\u89e3<\/h1>\n<h1>\u4f1a\u8bdd\u7ba1\u7406\u4e0e\u538b\u7f29\uff08\u6df1\u5165\u4e86\u89e3\uff09<\/h1>\n<p>\u672c\u6587\u6863\u89e3\u91ca OpenClaw \u5982\u4f55\u7aef\u5230\u7aef\u7ba1\u7406\u4f1a\u8bdd\uff1a<\/p>\n<ul>\n<li><strong>\u4f1a\u8bdd\u8def\u7531<\/strong>\uff08\u5165\u7ad9\u6d88\u606f\u5982\u4f55\u6620\u5c04\u5230 <code>sessionKey<\/code>\uff09<\/li>\n<li><strong>\u4f1a\u8bdd\u5b58\u50a8<\/strong>\uff08<code>sessions.json<\/code>\uff09\u53ca\u5176\u8ddf\u8e2a\u7684\u5185\u5bb9<\/li>\n<li><strong>\u8bb0\u5f55\u6301\u4e45\u5316<\/strong>\uff08<code>*.jsonl<\/code>\uff09\u53ca\u5176\u7ed3\u6784<\/li>\n<li><strong>\u8bb0\u5f55\u6e05\u7406<\/strong>\uff08\u8fd0\u884c\u524d\u7684\u63d0\u4f9b\u5546\u7279\u5b9a\u4fee\u590d\uff09<\/li>\n<li><strong>\u4e0a\u4e0b\u6587\u9650\u5236<\/strong>\uff08\u4e0a\u4e0b\u6587\u7a97\u53e3 vs \u8ddf\u8e2a\u7684 token \u6570\uff09<\/li>\n<li><strong>\u538b\u7f29<\/strong>\uff08\u624b\u52a8 + \u81ea\u52a8\u538b\u7f29\uff09\u4ee5\u53ca\u5728\u4f55\u5904\u6302\u63a5\u538b\u7f29\u524d\u5de5\u4f5c<\/li>\n<li><strong>\u9759\u9ed8\u5185\u52a1\u5904\u7406<\/strong>\uff08\u4f8b\u5982\u4e0d\u5e94\u4ea7\u751f\u7528\u6237\u53ef\u89c1\u8f93\u51fa\u7684\u8bb0\u5fc6\u5199\u5165\uff09<\/li>\n<\/ul>\n<p>\u5982\u679c\u4f60\u60f3\u5148\u4e86\u89e3\u66f4\u9ad8\u5c42\u6b21\u7684\u6982\u8ff0\uff0c\u8bf7\u4ece\u4ee5\u4e0b\u5185\u5bb9\u5f00\u59cb\uff1a<\/p>\n<ul>\n<li><a href=\"\/concepts\/session\">\/concepts\/session<\/a><\/li>\n<li><a href=\"\/concepts\/compaction\">\/concepts\/compaction<\/a><\/li>\n<li><a href=\"\/concepts\/session-pruning\">\/concepts\/session-pruning<\/a><\/li>\n<li><a href=\"\/reference\/transcript-hygiene\">\/reference\/transcript-hygiene<\/a><\/li>\n<\/ul>\n<hr \/>\n<h2>\u4e8b\u5b9e\u6765\u6e90\uff1aGateway \u7f51\u5173<\/h2>\n<p>OpenClaw \u56f4\u7ed5\u4e00\u4e2a\u62e5\u6709\u4f1a\u8bdd\u72b6\u6001\u7684\u5355\u4e00 <strong>Gateway \u7f51\u5173\u8fdb\u7a0b<\/strong>\u8bbe\u8ba1\u3002<\/p>\n<ul>\n<li>UI\uff08macOS \u5e94\u7528\u3001web \u63a7\u5236 UI\u3001TUI\uff09\u5e94\u8be5\u5411 Gateway \u7f51\u5173\u67e5\u8be2\u4f1a\u8bdd\u5217\u8868\u548c token \u8ba1\u6570\u3002<\/li>\n<li>\u5728\u8fdc\u7a0b\u6a21\u5f0f\u4e0b\uff0c\u4f1a\u8bdd\u6587\u4ef6\u5728\u8fdc\u7a0b\u4e3b\u673a\u4e0a\uff1b&#8221;\u68c0\u67e5\u4f60\u7684\u672c\u5730 Mac \u6587\u4ef6&#8221;\u4e0d\u4f1a\u53cd\u6620 Gateway \u7f51\u5173\u6b63\u5728\u4f7f\u7528\u7684\u5185\u5bb9\u3002<\/li>\n<\/ul>\n<hr \/>\n<h2>\u4e24\u4e2a\u6301\u4e45\u5316\u5c42<\/h2>\n<p>OpenClaw \u5728\u4e24\u4e2a\u5c42\u4e2d\u6301\u4e45\u5316\u4f1a\u8bdd\uff1a<\/p>\n<ol>\n<li>\n<p><strong>\u4f1a\u8bdd\u5b58\u50a8\uff08<code>sessions.json<\/code>\uff09<\/strong><br \/>\n   * \u952e\/\u503c\u6620\u5c04\uff1a<code>sessionKey -&gt; SessionEntry<\/code><br \/>\n   * \u5c0f\u578b\u3001\u53ef\u53d8\u3001\u53ef\u5b89\u5168\u7f16\u8f91\uff08\u6216\u5220\u9664\u6761\u76ee\uff09<br \/>\n   * \u8ddf\u8e2a\u4f1a\u8bdd\u5143\u6570\u636e\uff08\u5f53\u524d\u4f1a\u8bdd ID\u3001\u6700\u540e\u6d3b\u52a8\u65f6\u95f4\u3001\u5f00\u5173\u3001token \u8ba1\u6570\u5668\u7b49\uff09<\/p>\n<\/li>\n<li>\n<p><strong>\u8bb0\u5f55\uff08<code>&lt;sessionId&gt;.jsonl<\/code>\uff09<\/strong><br \/>\n   * \u5177\u6709\u6811\u5f62\u7ed3\u6784\u7684\u4ec5\u8ffd\u52a0\u8bb0\u5f55\uff08\u6761\u76ee\u6709 <code>id<\/code> + <code>parentId<\/code>\uff09<br \/>\n   * \u5b58\u50a8\u5b9e\u9645\u5bf9\u8bdd + \u5de5\u5177\u8c03\u7528 + \u538b\u7f29\u6458\u8981<br \/>\n   * \u7528\u4e8e\u4e3a\u540e\u7eed\u56de\u5408\u91cd\u5efa\u6a21\u578b\u4e0a\u4e0b\u6587<\/p>\n<\/li>\n<\/ol>\n<hr \/>\n<h2>\u78c1\u76d8\u4e0a\u7684\u4f4d\u7f6e<\/h2>\n<p>\u5728 Gateway \u7f51\u5173\u4e3b\u673a\u4e0a\uff0c\u6bcf\u4e2a\u667a\u80fd\u4f53\uff1a<\/p>\n<ul>\n<li>\u5b58\u50a8\uff1a<code>~\/.openclaw\/agents\/&lt;agentId&gt;\/sessions\/sessions.json<\/code><\/li>\n<li>\u8bb0\u5f55\uff1a<code>~\/.openclaw\/agents\/&lt;agentId&gt;\/sessions\/&lt;sessionId&gt;.jsonl<\/code><\/li>\n<li>Telegram \u8bdd\u9898\u4f1a\u8bdd\uff1a<code>...\/&lt;sessionId&gt;-topic-&lt;threadId&gt;.jsonl<\/code><\/li>\n<\/ul>\n<p>OpenClaw \u901a\u8fc7 <code>src\/config\/sessions.ts<\/code> \u89e3\u6790\u8fd9\u4e9b\u4f4d\u7f6e\u3002<\/p>\n<hr \/>\n<h2>\u4f1a\u8bdd\u952e\uff08<code>sessionKey<\/code>\uff09<\/h2>\n<p><code>sessionKey<\/code> \u6807\u8bc6\u4f60\u6240\u5728\u7684<em>\u54ea\u4e2a\u5bf9\u8bdd\u6876<\/em>\uff08\u8def\u7531 + \u9694\u79bb\uff09\u3002<\/p>\n<p>\u5e38\u89c1\u6a21\u5f0f\uff1a<\/p>\n<ul>\n<li>\u4e3b\u8981\/\u76f4\u63a5\u804a\u5929\uff08\u6bcf\u4e2a\u667a\u80fd\u4f53\uff09\uff1a<code>agent:&lt;agentId&gt;:&lt;mainKey&gt;<\/code>\uff08\u9ed8\u8ba4 <code>main<\/code>\uff09<\/li>\n<li>\u7fa4\u7ec4\uff1a<code>agent:&lt;agentId&gt;:&lt;channel&gt;:group:&lt;id&gt;<\/code><\/li>\n<li>\u623f\u95f4\/\u9891\u9053\uff08Discord\/Slack\uff09\uff1a<code>agent:&lt;agentId&gt;:&lt;channel&gt;:channel:&lt;id&gt;<\/code> \u6216 <code>...:room:&lt;id&gt;<\/code><\/li>\n<li>\u5b9a\u65f6\u4efb\u52a1\uff1a<code>cron:&lt;job.id&gt;<\/code><\/li>\n<li>Webhook\uff1a<code>hook:&lt;uuid&gt;<\/code>\uff08\u9664\u975e\u88ab\u8986\u76d6\uff09<\/li>\n<\/ul>\n<p>\u89c4\u8303\u89c4\u5219\u8bb0\u5f55\u5728 <a href=\"\/concepts\/session\">\/concepts\/session<\/a>\u3002<\/p>\n<hr \/>\n<h2>\u4f1a\u8bdd ID\uff08<code>sessionId<\/code>\uff09<\/h2>\n<p>\u6bcf\u4e2a <code>sessionKey<\/code> \u6307\u5411\u4e00\u4e2a\u5f53\u524d\u7684 <code>sessionId<\/code>\uff08\u7ee7\u7eed\u5bf9\u8bdd\u7684\u8bb0\u5f55\u6587\u4ef6\uff09\u3002<\/p>\n<p>\u7ecf\u9a8c\u6cd5\u5219\uff1a<\/p>\n<ul>\n<li><strong>\u91cd\u7f6e<\/strong>\uff08<code>\/new<\/code>\u3001<code>\/reset<\/code>\uff09\u4e3a\u8be5 <code>sessionKey<\/code> \u521b\u5efa\u4e00\u4e2a\u65b0\u7684 <code>sessionId<\/code>\u3002<\/li>\n<li><strong>\u6bcf\u65e5\u91cd\u7f6e<\/strong>\uff08\u9ed8\u8ba4 Gateway \u7f51\u5173\u4e3b\u673a\u672c\u5730\u65f6\u95f4\u51cc\u6668 4:00\uff09\u5728\u91cd\u7f6e\u8fb9\u754c\u540e\u7684\u4e0b\u4e00\u6761\u6d88\u606f\u65f6\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 <code>sessionId<\/code>\u3002<\/li>\n<li><strong>\u7a7a\u95f2\u8fc7\u671f<\/strong>\uff08<code>session.reset.idleMinutes<\/code> \u6216\u65e7\u7248 <code>session.idleMinutes<\/code>\uff09\u5f53\u6d88\u606f\u5728\u7a7a\u95f2\u7a97\u53e3\u540e\u5230\u8fbe\u65f6\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 <code>sessionId<\/code>\u3002\u5f53\u540c\u65f6\u914d\u7f6e\u4e86\u6bcf\u65e5\u548c\u7a7a\u95f2\u65f6\uff0c\u4ee5\u5148\u8fc7\u671f\u8005\u4e3a\u51c6\u3002<\/li>\n<\/ul>\n<p>\u5b9e\u73b0\u7ec6\u8282\uff1a\u51b3\u7b56\u53d1\u751f\u5728 <code>src\/auto-reply\/reply\/session.ts<\/code> \u7684 <code>initSessionState()<\/code> \u4e2d\u3002<\/p>\n<hr \/>\n<h2>\u4f1a\u8bdd\u5b58\u50a8\u6a21\u5f0f\uff08<code>sessions.json<\/code>\uff09<\/h2>\n<p>\u5b58\u50a8\u7684\u503c\u7c7b\u578b\u662f <code>src\/config\/sessions.ts<\/code> \u4e2d\u7684 <code>SessionEntry<\/code>\u3002<\/p>\n<p>\u5173\u952e\u5b57\u6bb5\uff08\u4e0d\u5b8c\u6574\uff09\uff1a<\/p>\n<ul>\n<li><code>sessionId<\/code>\uff1a\u5f53\u524d\u8bb0\u5f55 ID\uff08\u6587\u4ef6\u540d\u4ece\u6b64\u6d3e\u751f\uff0c\u9664\u975e\u8bbe\u7f6e\u4e86 <code>sessionFile<\/code>\uff09<\/li>\n<li><code>updatedAt<\/code>\uff1a\u6700\u540e\u6d3b\u52a8\u65f6\u95f4\u6233<\/li>\n<li><code>sessionFile<\/code>\uff1a\u53ef\u9009\u7684\u663e\u5f0f\u8bb0\u5f55\u8def\u5f84\u8986\u76d6<\/li>\n<li><code>chatType<\/code>\uff1a<code>direct | group | room<\/code>\uff08\u5e2e\u52a9 UI \u548c\u53d1\u9001\u7b56\u7565\uff09<\/li>\n<li><code>provider<\/code>\u3001<code>subject<\/code>\u3001<code>room<\/code>\u3001<code>space<\/code>\u3001<code>displayName<\/code>\uff1a\u7fa4\u7ec4\/\u9891\u9053\u6807\u7b7e\u7684\u5143\u6570\u636e<\/li>\n<li>\u5f00\u5173\uff1a<\/li>\n<li><code>thinkingLevel<\/code>\u3001<code>verboseLevel<\/code>\u3001<code>reasoningLevel<\/code>\u3001<code>elevatedLevel<\/code><\/li>\n<li><code>sendPolicy<\/code>\uff08\u6bcf\u4f1a\u8bdd\u8986\u76d6\uff09<\/li>\n<li>\u6a21\u578b\u9009\u62e9\uff1a<\/li>\n<li><code>providerOverride<\/code>\u3001<code>modelOverride<\/code>\u3001<code>authProfileOverride<\/code><\/li>\n<li>Token \u8ba1\u6570\u5668\uff08\u5c3d\u529b\u800c\u4e3a\/\u4f9d\u8d56\u63d0\u4f9b\u5546\uff09\uff1a<\/li>\n<li><code>inputTokens<\/code>\u3001<code>outputTokens<\/code>\u3001<code>totalTokens<\/code>\u3001<code>contextTokens<\/code><\/li>\n<li><code>compactionCount<\/code>\uff1a\u6b64\u4f1a\u8bdd\u952e\u5b8c\u6210\u81ea\u52a8\u538b\u7f29\u7684\u6b21\u6570<\/li>\n<li><code>memoryFlushAt<\/code>\uff1a\u6700\u540e\u4e00\u6b21\u538b\u7f29\u524d\u8bb0\u5fc6\u5237\u65b0\u7684\u65f6\u95f4\u6233<\/li>\n<li><code>memoryFlushCompactionCount<\/code>\uff1a\u6700\u540e\u4e00\u6b21\u5237\u65b0\u8fd0\u884c\u65f6\u7684\u538b\u7f29\u8ba1\u6570<\/li>\n<\/ul>\n<p>\u5b58\u50a8\u53ef\u4ee5\u5b89\u5168\u7f16\u8f91\uff0c\u4f46 Gateway \u7f51\u5173\u662f\u6743\u5a01\uff1a\u5b83\u53ef\u80fd\u4f1a\u5728\u4f1a\u8bdd\u8fd0\u884c\u65f6\u91cd\u5199\u6216\u91cd\u65b0\u6c34\u5408\u6761\u76ee\u3002<\/p>\n<hr \/>\n<h2>\u8bb0\u5f55\u7ed3\u6784\uff08<code>*.jsonl<\/code>\uff09<\/h2>\n<p>\u8bb0\u5f55\u7531 <code>@mariozechner\/pi-coding-agent<\/code> \u7684 <code>SessionManager<\/code> \u7ba1\u7406\u3002<\/p>\n<p>\u6587\u4ef6\u662f JSONL \u683c\u5f0f\uff1a<\/p>\n<ul>\n<li>\u7b2c\u4e00\u884c\uff1a\u4f1a\u8bdd\u5934\uff08<code>type: \"session\"<\/code>\uff0c\u5305\u62ec <code>id<\/code>\u3001<code>cwd<\/code>\u3001<code>timestamp<\/code>\u3001\u53ef\u9009\u7684 <code>parentSession<\/code>\uff09<\/li>\n<li>\u7136\u540e\uff1a\u5e26\u6709 <code>id<\/code> + <code>parentId<\/code> \u7684\u4f1a\u8bdd\u6761\u76ee\uff08\u6811\u5f62\u7ed3\u6784\uff09<\/li>\n<\/ul>\n<p>\u503c\u5f97\u6ce8\u610f\u7684\u6761\u76ee\u7c7b\u578b\uff1a<\/p>\n<ul>\n<li><code>message<\/code>\uff1a\u7528\u6237\/\u52a9\u624b\/\u5de5\u5177\u7ed3\u679c\u6d88\u606f<\/li>\n<li><code>custom_message<\/code>\uff1a\u6269\u5c55\u6ce8\u5165\u7684\u6d88\u606f\uff0c<em>\u786e\u5b9e<\/em>\u8fdb\u5165\u6a21\u578b\u4e0a\u4e0b\u6587\uff08\u53ef\u4ee5\u4ece UI \u9690\u85cf\uff09<\/li>\n<li><code>custom<\/code>\uff1a<em>\u4e0d<\/em>\u8fdb\u5165\u6a21\u578b\u4e0a\u4e0b\u6587\u7684\u6269\u5c55\u72b6\u6001<\/li>\n<li><code>compaction<\/code>\uff1a\u6301\u4e45\u5316\u7684\u538b\u7f29\u6458\u8981\uff0c\u5e26\u6709 <code>firstKeptEntryId<\/code> \u548c <code>tokensBefore<\/code><\/li>\n<li><code>branch_summary<\/code>\uff1a\u5bfc\u822a\u6811\u5206\u652f\u65f6\u7684\u6301\u4e45\u5316\u6458\u8981<\/li>\n<\/ul>\n<p>OpenClaw \u6709\u610f<strong>\u4e0d<\/strong>&#8220;\u4fee\u590d&#8221;\u8bb0\u5f55\uff1bGateway \u7f51\u5173\u4f7f\u7528 <code>SessionManager<\/code> \u6765\u8bfb\/\u5199\u5b83\u4eec\u3002<\/p>\n<hr \/>\n<h2>\u4e0a\u4e0b\u6587\u7a97\u53e3 vs \u8ddf\u8e2a\u7684 token<\/h2>\n<p>\u4e24\u4e2a\u4e0d\u540c\u7684\u6982\u5ff5\u5f88\u91cd\u8981\uff1a<\/p>\n<ol>\n<li><strong>\u6a21\u578b\u4e0a\u4e0b\u6587\u7a97\u53e3<\/strong>\uff1a\u6bcf\u4e2a\u6a21\u578b\u7684\u786c\u4e0a\u9650\uff08\u6a21\u578b\u53ef\u89c1\u7684 token\uff09<\/li>\n<li><strong>\u4f1a\u8bdd\u5b58\u50a8\u8ba1\u6570\u5668<\/strong>\uff1a\u5199\u5165 <code>sessions.json<\/code> \u7684\u6eda\u52a8\u7edf\u8ba1\uff08\u7528\u4e8e \/status \u548c\u4eea\u8868\u677f\uff09<\/li>\n<\/ol>\n<p>\u5982\u679c\u4f60\u5728\u8c03\u6574\u9650\u5236\uff1a<\/p>\n<ul>\n<li>\u4e0a\u4e0b\u6587\u7a97\u53e3\u6765\u81ea\u6a21\u578b\u76ee\u5f55\uff08\u53ef\u4ee5\u901a\u8fc7\u914d\u7f6e\u8986\u76d6\uff09\u3002<\/li>\n<li>\u5b58\u50a8\u4e2d\u7684 <code>contextTokens<\/code> \u662f\u8fd0\u884c\u65f6\u4f30\u8ba1\/\u62a5\u544a\u503c\uff1b\u4e0d\u8981\u5c06\u5176\u89c6\u4e3a\u4e25\u683c\u4fdd\u8bc1\u3002<\/li>\n<\/ul>\n<p>\u66f4\u591a\u4fe1\u606f\uff0c\u53c2\u89c1 <a href=\"\/reference\/token-use\">\/token-use<\/a>\u3002<\/p>\n<hr \/>\n<h2>\u538b\u7f29\uff1a\u5b83\u662f\u4ec0\u4e48<\/h2>\n<p>\u538b\u7f29\u5c06\u8f83\u65e7\u7684\u5bf9\u8bdd\u603b\u7ed3\u4e3a\u8bb0\u5f55\u4e2d\u7684\u6301\u4e45\u5316 <code>compaction<\/code> \u6761\u76ee\uff0c\u5e76\u4fdd\u6301\u6700\u8fd1\u7684\u6d88\u606f\u4e0d\u53d8\u3002<\/p>\n<p>\u538b\u7f29\u540e\uff0c\u672a\u6765\u7684\u56de\u5408\u4f1a\u770b\u5230\uff1a<\/p>\n<ul>\n<li>\u538b\u7f29\u6458\u8981<\/li>\n<li><code>firstKeptEntryId<\/code> \u4e4b\u540e\u7684\u6d88\u606f<\/li>\n<\/ul>\n<p>\u538b\u7f29\u662f<strong>\u6301\u4e45\u5316\u7684<\/strong>\uff08\u4e0e\u4f1a\u8bdd\u4fee\u526a\u4e0d\u540c\uff09\u3002\u53c2\u89c1 <a href=\"\/concepts\/session-pruning\">\/concepts\/session-pruning<\/a>\u3002<\/p>\n<hr \/>\n<h2>\u81ea\u52a8\u538b\u7f29\u4f55\u65f6\u53d1\u751f\uff08Pi \u8fd0\u884c\u65f6\uff09<\/h2>\n<p>\u5728\u5d4c\u5165\u5f0f Pi \u667a\u80fd\u4f53\u4e2d\uff0c\u81ea\u52a8\u538b\u7f29\u5728\u4e24\u79cd\u60c5\u51b5\u4e0b\u89e6\u53d1\uff1a<\/p>\n<ol>\n<li><strong>\u6ea2\u51fa\u6062\u590d<\/strong>\uff1a\u6a21\u578b\u8fd4\u56de\u4e0a\u4e0b\u6587\u6ea2\u51fa\u9519\u8bef \u2192 \u538b\u7f29 \u2192 \u91cd\u8bd5\u3002<\/li>\n<li><strong>\u9608\u503c\u7ef4\u62a4<\/strong>\uff1a\u5728\u6210\u529f\u7684\u56de\u5408\u540e\uff0c\u5f53\uff1a<\/li>\n<\/ol>\n<p><code>contextTokens &gt; contextWindow - reserveTokens<\/code><\/p>\n<p>\u5176\u4e2d\uff1a<\/p>\n<ul>\n<li><code>contextWindow<\/code> \u662f\u6a21\u578b\u7684\u4e0a\u4e0b\u6587\u7a97\u53e3<\/li>\n<li><code>reserveTokens<\/code> \u662f\u4e3a\u63d0\u793a + \u4e0b\u4e00\u4e2a\u6a21\u578b\u8f93\u51fa\u4fdd\u7559\u7684\u7a7a\u95f4<\/li>\n<\/ul>\n<p>\u8fd9\u4e9b\u662f Pi \u8fd0\u884c\u65f6\u8bed\u4e49\uff08OpenClaw \u6d88\u8d39\u4e8b\u4ef6\uff0c\u4f46 Pi \u51b3\u5b9a\u4f55\u65f6\u538b\u7f29\uff09\u3002<\/p>\n<hr \/>\n<h2>\u538b\u7f29\u8bbe\u7f6e\uff08<code>reserveTokens<\/code>\u3001<code>keepRecentTokens<\/code>\uff09<\/h2>\n<p>Pi \u7684\u538b\u7f29\u8bbe\u7f6e\u4f4d\u4e8e Pi \u8bbe\u7f6e\u4e2d\uff1a<\/p>\n<p><code>json5  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n{<br \/>\n  compaction: {<br \/>\n    enabled: true,<br \/>\n    reserveTokens: 16384,<br \/>\n    keepRecentTokens: 20000,<br \/>\n  },<br \/>\n}<\/code><\/p>\n<p>OpenClaw \u8fd8\u4e3a\u5d4c\u5165\u5f0f\u8fd0\u884c\u5f3a\u5236\u6267\u884c\u5b89\u5168\u4e0b\u9650\uff1a<\/p>\n<ul>\n<li>\u5982\u679c <code>compaction.reserveTokens &lt; reserveTokensFloor<\/code>\uff0cOpenClaw \u4f1a\u63d0\u5347\u5b83\u3002<\/li>\n<li>\u9ed8\u8ba4\u4e0b\u9650\u662f <code>20000<\/code> \u4e2a token\u3002<\/li>\n<li>\u8bbe\u7f6e <code>agents.defaults.compaction.reserveTokensFloor: 0<\/code> \u4ee5\u7981\u7528\u4e0b\u9650\u3002<\/li>\n<li>\u5982\u679c\u5b83\u5df2\u7ecf\u66f4\u9ad8\uff0cOpenClaw \u4e0d\u4f1a\u6539\u53d8\u5b83\u3002<\/li>\n<\/ul>\n<p>\u539f\u56e0\uff1a\u4e3a\u538b\u7f29\u53d8\u5f97\u4e0d\u53ef\u907f\u514d\u4e4b\u524d\u7684\u591a\u56de\u5408&#8221;\u5185\u52a1\u5904\u7406&#8221;\uff08\u5982\u8bb0\u5fc6\u5199\u5165\uff09\u7559\u51fa\u8db3\u591f\u7684\u7a7a\u95f4\u3002<\/p>\n<p>\u5b9e\u73b0\uff1a<code>src\/agents\/pi-settings.ts<\/code> \u4e2d\u7684 <code>ensurePiCompactionReserveTokens()<\/code>\uff08\u4ece <code>src\/agents\/pi-embedded-runner.ts<\/code> \u8c03\u7528\uff09\u3002<\/p>\n<hr \/>\n<h2>\u7528\u6237\u53ef\u89c1\u7684\u754c\u9762<\/h2>\n<p>\u4f60\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u65b9\u5f0f\u89c2\u5bdf\u538b\u7f29\u548c\u4f1a\u8bdd\u72b6\u6001\uff1a<\/p>\n<ul>\n<li><code>\/status<\/code>\uff08\u5728\u4efb\u4f55\u804a\u5929\u4f1a\u8bdd\u4e2d\uff09<\/li>\n<li><code>openclaw status<\/code>\uff08CLI\uff09<\/li>\n<li><code>openclaw sessions<\/code> \/ <code>sessions --json<\/code><\/li>\n<li>\u8be6\u7ec6\u6a21\u5f0f\uff1a<code>\ud83e\uddf9 Auto-compaction complete<\/code> + \u538b\u7f29\u8ba1\u6570<\/li>\n<\/ul>\n<hr \/>\n<h2>\u9759\u9ed8\u5185\u52a1\u5904\u7406\uff08<code>NO_REPLY<\/code>\uff09<\/h2>\n<p>OpenClaw \u652f\u6301\u7528\u4e8e\u540e\u53f0\u4efb\u52a1\u7684&#8221;\u9759\u9ed8&#8221;\u56de\u5408\uff0c\u7528\u6237\u4e0d\u5e94\u8be5\u770b\u5230\u4e2d\u95f4\u8f93\u51fa\u3002<\/p>\n<p>\u7ea6\u5b9a\uff1a<\/p>\n<ul>\n<li>\u52a9\u624b\u4ee5 <code>NO_REPLY<\/code> \u5f00\u59cb\u5176\u8f93\u51fa\uff0c\u8868\u793a&#8221;\u4e0d\u8981\u5411\u7528\u6237\u53d1\u9001\u56de\u590d&#8221;\u3002<\/li>\n<li>OpenClaw \u5728\u6295\u9012\u5c42\u5265\u79bb\/\u6291\u5236\u6b64\u5185\u5bb9\u3002<\/li>\n<\/ul>\n<p>\u4ece <code>2026.1.10<\/code> \u5f00\u59cb\uff0c\u5f53\u90e8\u5206\u5757\u4ee5 <code>NO_REPLY<\/code> \u5f00\u5934\u65f6\uff0cOpenClaw \u8fd8\u4f1a\u6291\u5236<strong>\u8349\u7a3f\/\u6253\u5b57\u6d41\u5f0f\u8f93\u51fa<\/strong>\uff0c\u56e0\u6b64\u9759\u9ed8\u64cd\u4f5c\u4e0d\u4f1a\u5728\u56de\u5408\u4e2d\u9014\u6cc4\u6f0f\u90e8\u5206\u8f93\u51fa\u3002<\/p>\n<hr \/>\n<h2>\u538b\u7f29\u524d&#8221;\u8bb0\u5fc6\u5237\u65b0&#8221;\uff08\u5df2\u5b9e\u73b0\uff09<\/h2>\n<p>\u76ee\u6807\uff1a\u5728\u81ea\u52a8\u538b\u7f29\u53d1\u751f\u4e4b\u524d\uff0c\u8fd0\u884c\u4e00\u4e2a\u9759\u9ed8\u7684\u667a\u80fd\u4f53\u56de\u5408\uff0c\u5c06\u6301\u4e45\u72b6\u6001\u5199\u5165\u78c1\u76d8\uff08\u4f8b\u5982\u667a\u80fd\u4f53\u5de5\u4f5c\u7a7a\u95f4\u4e2d\u7684 <code>memory\/YYYY-MM-DD.md<\/code>\uff09\uff0c\u8fd9\u6837\u538b\u7f29\u5c31\u4e0d\u4f1a\u64e6\u9664\u5173\u952e\u4e0a\u4e0b\u6587\u3002<\/p>\n<p>OpenClaw \u4f7f\u7528<strong>\u9884\u9608\u503c\u5237\u65b0<\/strong>\u65b9\u6cd5\uff1a<\/p>\n<ol>\n<li>\u76d1\u63a7\u4f1a\u8bdd\u4e0a\u4e0b\u6587\u4f7f\u7528\u60c5\u51b5\u3002<\/li>\n<li>\u5f53\u5b83\u8d8a\u8fc7&#8221;\u8f6f\u9608\u503c&#8221;\uff08\u4f4e\u4e8e Pi \u7684\u538b\u7f29\u9608\u503c\uff09\u65f6\uff0c\u5411\u667a\u80fd\u4f53\u8fd0\u884c\u4e00\u4e2a\u9759\u9ed8\u7684&#8221;\u73b0\u5728\u5199\u5165\u8bb0\u5fc6&#8221;\u6307\u4ee4\u3002<\/li>\n<li>\u4f7f\u7528 <code>NO_REPLY<\/code> \u4ee5\u4fbf\u7528\u6237\u770b\u4e0d\u5230\u4efb\u4f55\u5185\u5bb9\u3002<\/li>\n<\/ol>\n<p>\u914d\u7f6e\uff08<code>agents.defaults.compaction.memoryFlush<\/code>\uff09\uff1a<\/p>\n<ul>\n<li><code>enabled<\/code>\uff08\u9ed8\u8ba4\uff1a<code>true<\/code>\uff09<\/li>\n<li><code>softThresholdTokens<\/code>\uff08\u9ed8\u8ba4\uff1a<code>4000<\/code>\uff09<\/li>\n<li><code>prompt<\/code>\uff08\u5237\u65b0\u56de\u5408\u7684\u7528\u6237\u6d88\u606f\uff09<\/li>\n<li><code>systemPrompt<\/code>\uff08\u4e3a\u5237\u65b0\u56de\u5408\u9644\u52a0\u7684\u989d\u5916\u7cfb\u7edf\u63d0\u793a\uff09<\/li>\n<\/ul>\n<p>\u8bf4\u660e\uff1a<\/p>\n<ul>\n<li>\u9ed8\u8ba4\u7684\u63d0\u793a\/\u7cfb\u7edf\u63d0\u793a\u5305\u542b <code>NO_REPLY<\/code> \u63d0\u793a\u4ee5\u6291\u5236\u6295\u9012\u3002<\/li>\n<li>\u5237\u65b0\u6bcf\u4e2a\u538b\u7f29\u5468\u671f\u8fd0\u884c\u4e00\u6b21\uff08\u5728 <code>sessions.json<\/code> \u4e2d\u8ddf\u8e2a\uff09\u3002<\/li>\n<li>\u5237\u65b0\u4ec5\u5bf9\u5d4c\u5165\u5f0f Pi \u4f1a\u8bdd\u8fd0\u884c\uff08CLI \u540e\u7aef\u8df3\u8fc7\u5b83\uff09\u3002<\/li>\n<li>\u5f53\u4f1a\u8bdd\u5de5\u4f5c\u7a7a\u95f4\u662f\u53ea\u8bfb\u65f6\uff08<code>workspaceAccess: \"ro\"<\/code> \u6216 <code>\"none\"<\/code>\uff09\uff0c\u5237\u65b0\u4f1a\u88ab\u8df3\u8fc7\u3002<\/li>\n<li>\u53c2\u89c1<a href=\"\/concepts\/memory\">\u8bb0\u5fc6<\/a>\u4e86\u89e3\u5de5\u4f5c\u7a7a\u95f4\u6587\u4ef6\u5e03\u5c40\u548c\u5199\u5165\u6a21\u5f0f\u3002<\/li>\n<\/ul>\n<p>Pi \u8fd8\u5728\u6269\u5c55 API \u4e2d\u516c\u5f00\u4e86 <code>session_before_compact<\/code> \u94a9\u5b50\uff0c\u4f46 OpenClaw \u7684\u5237\u65b0\u903b\u8f91\u76ee\u524d\u4f4d\u4e8e Gateway \u7f51\u5173\u7aef\u3002<\/p>\n<hr \/>\n<h2>\u6545\u969c\u6392\u9664\u68c0\u67e5\u6e05\u5355<\/h2>\n<ul>\n<li>\u4f1a\u8bdd\u952e\u9519\u8bef\uff1f\u4ece <a href=\"\/concepts\/session\">\/concepts\/session<\/a> \u5f00\u59cb\uff0c\u5e76\u5728 <code>\/status<\/code> \u4e2d\u786e\u8ba4 <code>sessionKey<\/code>\u3002<\/li>\n<li>\u5b58\u50a8 vs \u8bb0\u5f55\u4e0d\u5339\u914d\uff1f\u4ece <code>openclaw status<\/code> \u786e\u8ba4 Gateway \u7f51\u5173\u4e3b\u673a\u548c\u5b58\u50a8\u8def\u5f84\u3002<\/li>\n<li>\u538b\u7f29\u8fc7\u4e8e\u9891\u7e41\uff1f\u68c0\u67e5\uff1a<\/li>\n<li>\u6a21\u578b\u4e0a\u4e0b\u6587\u7a97\u53e3\uff08\u592a\u5c0f\uff09<\/li>\n<li>\u538b\u7f29\u8bbe\u7f6e\uff08<code>reserveTokens<\/code> \u5bf9\u4e8e\u6a21\u578b\u7a97\u53e3\u6765\u8bf4\u592a\u9ad8\u4f1a\u5bfc\u81f4\u66f4\u65e9\u7684\u538b\u7f29\uff09<\/li>\n<li>\u5de5\u5177\u7ed3\u679c\u81a8\u80c0\uff1a\u542f\u7528\/\u8c03\u6574\u4f1a\u8bdd\u4fee\u526a<\/li>\n<li>\u9759\u9ed8\u56de\u5408\u6cc4\u6f0f\uff1f\u786e\u8ba4\u56de\u590d\u4ee5 <code>NO_REPLY<\/code>\uff08\u7cbe\u786e token\uff09\u5f00\u5934\uff0c\u5e76\u4e14\u4f60\u4f7f\u7528\u7684\u6784\u5efa\u7248\u672c\u5305\u542b\u6d41\u5f0f\u8f93\u51fa\u6291\u5236\u4fee\u590d\u3002<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>\u4f1a\u8bdd\u7ba1\u7406\u6df1\u5165\u4e86\u89e3 \u4f1a\u8bdd\u7ba1\u7406\u4e0e\u538b\u7f29\uff08\u6df1\u5165\u4e86\u89e3\uff09 \u672c\u6587\u6863\u89e3\u91ca OpenClaw \u5982\u4f55\u7aef\u5230\u7aef\u7ba1\u7406\u4f1a\u8bdd\uff1a \u4f1a\u8bdd\u8def\u7531\uff08\u5165 [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-247","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/247","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=247"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/247\/revisions"}],"predecessor-version":[{"id":542,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/247\/revisions\/542"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=247"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=247"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=247"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}