惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

月光博客
月光博客
J
Java Code Geeks
F
Fortinet All Blogs
Blog — PlanetScale
Blog — PlanetScale
P
Proofpoint News Feed
U
Unit 42
B
Blog
宝玉的分享
宝玉的分享
腾讯CDC
Microsoft Azure Blog
Microsoft Azure Blog
酷 壳 – CoolShell
酷 壳 – CoolShell
Last Week in AI
Last Week in AI
博客园 - Franky
博客园 - 三生石上(FineUI控件)
人人都是产品经理
人人都是产品经理
Martin Fowler
Martin Fowler
博客园_首页
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
云风的 BLOG
云风的 BLOG
L
LangChain Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Y
Y Combinator Blog
The GitHub Blog
The GitHub Blog
博客园 - 叶小钗

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
fix(sessions): avoid guarded route-only entries · opencla...
steipete · 2026-04-28 · via Recent Commits to openclaw:main
Original file line numberDiff line numberDiff line change

@@ -15,7 +15,7 @@ Docs: https://docs.openclaw.ai

1515
1616

### Fixes

1717
18-

- Channels/sessions: skip last-route writes when inbound session recording explicitly disables creation, so plugin-owned guarded inbound paths cannot create route-only phantom sessions. Carries forward #73009. Thanks @jzakirov.

18+

- Channels/sessions: prevent guarded inbound session recording from creating route-only phantom sessions while still allowing last-route updates for sessions that already exist. Carries forward #73009. Thanks @jzakirov.

1919

- Plugins/runtime deps: stage bundled plugin dependencies imported by mirrored root dist chunks, so packaged memory and status commands do not miss `chokidar` or similar root-chunk dependencies after update. Fixes #72882 and #72970; carries forward #72992. Thanks @shrimpy8, @colin-chang, and @Schnup03.

2020

- Channels/Telegram: skip the optional webhook-info API call during polling-mode status checks and startup bot-label probes so long-polling setups avoid an unnecessary Telegram round trip. Carries forward #72990. Thanks @danielgruneberg.

2121

- CLI/message: resolve targeted `openclaw message` channels to their owning plugin before loading the registry, and fall back to configured channel plugins when the channel must be inferred, so scripted sends avoid full bundled plugin registry scans without assuming channel ids match plugin ids. Fixes #73006. Thanks @jasonftl.

Original file line numberDiff line numberDiff line change

@@ -59,6 +59,13 @@ OpenClaw infers a pinned owner from `allowFrom` when all of these are true:

5959

In that mismatch case, OpenClaw still records inbound session metadata, but it

6060

skips updating the main session `lastRoute`.

6161
62+

## Guarded inbound recording

63+
64+

Channel plugins can mark an inbound session record as `createIfMissing: false`

65+

when a guarded path must not create a new OpenClaw session. In that mode,

66+

OpenClaw may update metadata and `lastRoute` for an existing session, but it

67+

does not create a route-only session entry just because a message was observed.

68+
6269

## Routing rules (how an agent is chosen)

6370
6471

Routing picks **one agent** for each inbound message:

Original file line numberDiff line numberDiff line change

@@ -133,7 +133,7 @@ describe("recordInboundSession", () => {

133133

});

134134

});

135135
136-

it("skips last-route updates when session creation is disabled", async () => {

136+

it("forwards session creation policy to last-route updates", async () => {

137137

await recordInboundSession({

138138

storePath: "/tmp/openclaw-session-store.json",

139139

sessionKey: "agent:main:demo-channel:1234:thread:42",

@@ -152,6 +152,11 @@ describe("recordInboundSession", () => {

152152

createIfMissing: false,

153153

}),

154154

);

155-

expect(updateLastRouteMock).not.toHaveBeenCalled();

155+

expect(updateLastRouteMock).toHaveBeenCalledWith(

156+

expect.objectContaining({

157+

sessionKey: "agent:main:main",

158+

createIfMissing: false,

159+

}),

160+

);

156161

});

157162

});

Original file line numberDiff line numberDiff line change

@@ -51,7 +51,7 @@ export async function recordInboundSession(params: {

5151

.catch(params.onRecordError);

5252
5353

const update = params.updateLastRoute;

54-

if (!update || createIfMissing === false) {

54+

if (!update) {

5555

return;

5656

}

5757

if (shouldSkipPinnedMainDmRouteUpdate(update.mainDmOwnerPin)) {

@@ -70,5 +70,6 @@ export async function recordInboundSession(params: {

7070

// Avoid leaking inbound origin metadata into a different target session.

7171

ctx: targetSessionKey === canonicalSessionKey ? ctx : undefined,

7272

groupResolution,

73+

createIfMissing,

7374

});

7475

}

Original file line numberDiff line numberDiff line change

@@ -356,6 +356,52 @@ describe("sessions", () => {

356356

expect(store[sessionKey]?.origin?.chatType).toBe("group");

357357

});

358358
359+

it("updateLastRoute skips missing sessions when creation is disabled", async () => {

360+

const sessionKey = "agent:main:demo-chat:group:room-123";

361+

const { storePath } = await createSessionStoreFixture({

362+

prefix: "updateLastRoute-no-create",

363+

entries: {},

364+

});

365+
366+

const result = await updateLastRoute({

367+

storePath,

368+

sessionKey,

369+

deliveryContext: {

370+

channel: "demo-chat",

371+

to: "room-123",

372+

},

373+

createIfMissing: false,

374+

});

375+
376+

const store = loadSessionStore(storePath);

377+

expect(result).toBeNull();

378+

expect(store[sessionKey]).toBeUndefined();

379+

});

380+
381+

it("updateLastRoute updates existing sessions when creation is disabled", async () => {

382+

const sessionKey = "agent:main:demo-chat:group:room-123";

383+

const { storePath } = await createSessionStoreFixture({

384+

prefix: "updateLastRoute-existing-no-create",

385+

entries: {

386+

[sessionKey]: buildMainSessionEntry(),

387+

},

388+

});

389+
390+

await updateLastRoute({

391+

storePath,

392+

sessionKey,

393+

deliveryContext: {

394+

channel: "demo-chat",

395+

to: "room-123",

396+

},

397+

createIfMissing: false,

398+

});

399+
400+

const store = loadSessionStore(storePath);

401+

expect(store[sessionKey]?.lastChannel).toBe("demo-chat");

402+

expect(store[sessionKey]?.lastTo).toBe("room-123");

403+

});

404+
359405

it("updateLastRoute does not bump updatedAt on existing sessions (#49515)", async () => {

360406

const mainSessionKey = "agent:main:main";

361407

const frozenUpdatedAt = 1000;

Original file line numberDiff line numberDiff line change

@@ -70,4 +70,5 @@ export type UpdateLastRoute = (params: {

7070

deliveryContext?: DeliveryContext;

7171

ctx?: MsgContext;

7272

groupResolution?: GroupKeyResolution | null;

73-

}) => Promise<SessionEntry>;

73+

createIfMissing?: boolean;

74+

}) => Promise<SessionEntry | null>;

Original file line numberDiff line numberDiff line change

@@ -757,12 +757,17 @@ export async function updateLastRoute(params: {

757757

deliveryContext?: DeliveryContext;

758758

ctx?: MsgContext;

759759

groupResolution?: import("./types.js").GroupKeyResolution | null;

760-

}) {

760+

createIfMissing?: boolean;

761+

}): Promise<SessionEntry | null> {

761762

const { storePath, sessionKey, channel, to, accountId, threadId, ctx } = params;

763+

const createIfMissing = params.createIfMissing ?? true;

762764

return await withSessionStoreLock(storePath, async () => {

763765

const store = loadSessionStore(storePath);

764766

const resolved = resolveSessionStoreEntry({ store, sessionKey });

765767

const existing = resolved.existing;

768+

if (!existing && !createIfMissing) {

769+

return null;

770+

}

766771

const explicitContext = normalizeDeliveryContext(params.deliveryContext);

767772

const inlineContext = normalizeDeliveryContext({

768773

channel,