Session scope filtering fails - falls back to all main sessions

[Bozhu12]

Bug Description

When setting EVOLVER_SESSION_SCOPE to a workspace name (e.g. workspace-helperclaw), the evolver falls back to reading ALL sessions from the main agent directory, ignoring the scope.

Expected: Only read sessions whose cwd field contains workspaces/<scope>.

Actual: Logs show [SessionScope] No sessions match scope "workspace-helperclaw". Using all 15 session(s) (fallback). — reading from ~/.openclaw/agents/main/sessions instead of ~/.openclaw/agents/helperclaw/sessions.

Environment

• evolver: v1.62.1 (tested on origin/main, commit 0bffa8c)
• Node.js: v24
• Platform: Linux

Steps to Reproduce

EVOLVER_SESSION_SCOPE=workspace-helperclaw EVOLVE_BRIDGE=false node index.js run

Observe log output:

[SessionScope] No sessions match scope "workspace-helperclaw". Using all 15 session(s) (fallback).

Root Cause Analysis

Two bugs cause this:

Bug 1: AGENT_SESSIONS_DIR is derived from AGENT_NAME env var (defaults to "main" from .env), not from EVOLVER_SESSION_SCOPE. Even when scope is set, the code reads from ~/.openclaw/agents/main/sessions instead of ~/.openclaw/agents/helperclaw/sessions.

Bug 2: The scope matching logic uses f.name.toLowerCase().includes(scopeLower) — but session files are UUIDs (e.g. c982d748-b38e-4b58-bd99-adf064741790.jsonl) which never contain the workspace scope string. Additionally, readRecentLog() reads from the tail of each file, but the session header (containing cwd) is at the head of the file.

Workaround

From bash, set both variables:

AGENT_NAME=helperclaw EVOLVER_SESSION_SCOPE=workspace-helperclaw EVOLVE_BRIDGE=false node index.js run

Result: [SessionScope] Using all 3 session(s) (fallback). — correctly reads 3 sessions from helperclaw instead of 15 from main. The content-based matching still fails (falls back to all 3 sessions) due to Bug 2.

Suggested Fix

1. Add deriveSessionsDir() that extracts the agent name from EVOLVER_SESSION_SCOPE (e.g. workspace-helperclaw → helperclaw) and reads from that agent's sessions directory.

2. For scope content matching, read the first ~800 bytes of each session file (not the tail) and match the cwd field which contains workspaces/<scopeName>.

A reference implementation for v1.32.4 (readable source) is available at: https://github.com/Bozhu12/evolver/commit/db31a1f

[Bozhu12]

Bug 确认：v1.62.1 仍然存在 Session Scope 过滤失效问题

测试时间： 2026-04-14

确认结果： Bug 在 v1.62.1 (main branch) 仍然存在。

根因分析（v1.62.1）

v1.62.1 的 src/evolve.js 是 754KB 混淆 bundle，代码不可直接分析。但通过行为测试可以确认：

Bug 1：AGENT_SESSIONS_DIR 硬编码推导

# 行为测试
AGENT_NAME=main       → 读 ~/.openclaw/agents/main/sessions (41个session文件)
AGENT_NAME=helperclaw → 读 ~/.openclaw/agents/helperclaw/sessions (28个session文件)

EVOLVER_SESSION_SCOPE=workspace-helperclaw 时：

• 应该读 helperclaw/sessions
• 实际默认读 main/sessions（Bug 存在）

Bug 2：Scope 内容过滤读文件尾不读头

v1.62.1 日志：

[SessionScope] No sessions match scope "workspace-helperclaw". Using all 3 session(s) (fallback).

使用 AGENT_NAME=helperclaw workaround 后：

[SessionScope] Filtered to 3 session(s) matching scope "workspace-helperclaw" via content scan.

证明 scope 内容过滤本身有效，但前提是读到了正确的 session 文件（workaround 绕过了 Bug 1）。

Workaround

AGENT_NAME=helperclaw EVOLVER_SESSION_SCOPE=workspace-helperclaw node index.js run

修复建议

代码已混淆，无法直接打 patch。需要：

1. 团队提供未混淆的 src/evolve.js 源码
2. 或者在混淆前版本中修复，修复内容：

修复点 A（推导 sessions 目录）：

// 添加 deriveSessionsDir() 函数
function deriveSessionsDir() {
  const scope = String(process.env.EVOLOLVER_SESSION_SCOPE || '').trim();
  if (/^workspace[-_]/i.test(scope)) {
    const agentSuffix = scope.replace(/^workspace[-_]/i, '');
    const derivedAgent = agentSuffix.replace(/[-_]/g, '');
    const sessionsPath = path.join(os.homedir(), `.openclaw/agents/${derivedAgent}/sessions`);
    if (fs.existsSync(sessionsPath)) return sessionsPath;
  }
  return path.join(os.homedir(), `.openclaw/agents/${AGENT_NAME}/sessions`);
}
const AGENT_SESSIONS_DIR = deriveSessionsDir();

修复点 B（scope 内容匹配读文件开头）：

// 读文件开头 800B 找 cwd 字段（不是读末尾 600B）
const fd = fs.openSync(fp, 'r');
const buf = Buffer.alloc(Math.min(800, stats.size));
fs.readSync(fd, buf, 0, buf.length, 0);  // position=0 → 读开头
fs.closeSync(fd);
const header = buf.toString('utf8');
return header.toLowerCase().includes(`workspaces/${scopeLower}`);

参考实现 commit（v1.32.4，可读源码）：fix/session-scope-filtering 分支