openclaw-agent-dashboard 1.0.35 → 1.0.37

package/dashboard/agents.py

@@ -45,8 +45,10 @@ async def get_agent(agent_id: str):
     """获取单个 Agent 详情"""
     agents = get_agents_with_status()
     
+    from data.config_reader import agent_ids_equal
+
     for agent in agents:
-        if agent['id'] == agent_id:
+        if agent_ids_equal(agent['id'], agent_id):
             if agent.get('lastActiveAt'):
                 agent['lastActiveFormatted'] = format_last_active(agent['lastActiveAt'])
             return agent
@@ -62,10 +64,9 @@ async def get_agent_output(agent_id: str, limit: int = 50):
     用于调试视图展示
     """
     from data.session_reader import get_session_turns
-    from data.config_reader import get_agents_list
-    
-    agents = get_agents_list()
-    if not any(a.get('id') == agent_id for a in agents):
+    from data.config_reader import get_agent_config
+
+    if not get_agent_config(agent_id):
         from fastapi import HTTPException
         raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
     

package/dashboard/api/agents.py

@@ -1,7 +1,7 @@
 """
 Agent API 路由
 """
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter
 from pydantic import BaseModel
 from typing import List, Optional
 import sys
@@ -45,43 +45,18 @@ async def get_agent(agent_id: str):
     """获取单个 Agent 详情"""
     agents = get_agents_with_status()
     
+    from data.config_reader import agent_ids_equal
+
     for agent in agents:
-        if agent['id'] == agent_id:
+        if agent_ids_equal(agent['id'], agent_id):
             if agent.get('lastActiveAt'):
                 agent['lastActiveFormatted'] = format_last_active(agent['lastActiveAt'])
             return agent
     
+    from fastapi import HTTPException
     raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
 
 
-class TimelineContextResponse(BaseModel):
-    """供「实时执行时序」与 runs.json 对齐：使用最新 run 的 childSessionKey 解析独立会话。"""
-    childSessionKey: Optional[str] = None
-
-
-@router.get("/agents/{agent_id}/timeline-context", response_model=TimelineContextResponse)
-async def get_agent_timeline_context(agent_id: str):
-    """
-    返回该 Agent 在 runs.json 中最近一条 run 的 childSessionKey（若有）。
-    前端传给 GET /api/timeline/{agent_id}?session_key= 以命中 sessions.json 指定 jsonl，
-    避免仅靠 mtime 选文件或误扫主会话合并路径。
-    """
-    from data.config_reader import get_agents_list
-    from data.subagent_reader import get_agent_runs
-
-    agents = get_agents_list()
-    if not any(a.get("id") == agent_id for a in agents):
-        raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
-
-    runs = get_agent_runs(agent_id, limit=1)
-    key = None
-    if runs:
-        key = runs[0].get("childSessionKey") or None
-        if isinstance(key, str) and not key.strip():
-            key = None
-    return TimelineContextResponse(childSessionKey=key)
-
-
 @router.get("/agents/{agent_id}/output")
 async def get_agent_output(agent_id: str, limit: int = 50):
     """
@@ -89,10 +64,10 @@ async def get_agent_output(agent_id: str, limit: int = 50):
     用于调试视图展示
     """
     from data.session_reader import get_session_turns
-    from data.config_reader import get_agents_list
-    
-    agents = get_agents_list()
-    if not any(a.get('id') == agent_id for a in agents):
+    from data.config_reader import get_agent_config
+
+    if not get_agent_config(agent_id):
+        from fastapi import HTTPException
         raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
     
     turns = get_session_turns(agent_id, limit=limit)

package/dashboard/api/collaboration.py

@@ -107,16 +107,21 @@ def _build_agent_active_tasks(
             ...
         }
     """
+    from data.config_reader import agent_ids_equal, canonical_agent_id_from_config
+
     agent_active_tasks: Dict[str, List[Dict[str, Any]]] = {}
 
     for run in active_runs:
         child_key = run.get('childSessionKey', '')
         requester_key = run.get('requesterSessionKey', '')
 
-        # 解析执行者 Agent
-        child_agent_id = _parse_agent_id(child_key)
-        # 解析派发者 Agent
-        requester_agent_id = _parse_agent_id(requester_key)
+        # 解析执行者 Agent（会话 key 内为小写，映射到配置中的原始 id）
+        raw_child = _parse_agent_id(child_key)
+        raw_requester = _parse_agent_id(requester_key)
+        child_agent_id = canonical_agent_id_from_config(raw_child) if raw_child else ''
+        requester_agent_id = (
+            canonical_agent_id_from_config(raw_requester) if raw_requester else ''
+        )
 
         if not child_agent_id:
             continue
@@ -141,7 +146,7 @@ def _build_agent_active_tasks(
         }
 
         # 如果有派发者，添加 childAgentId（用于主 Agent 显示任务流向）
-        if requester_agent_id and requester_agent_id != child_agent_id:
+        if requester_agent_id and not agent_ids_equal(requester_agent_id, child_agent_id):
             task_item['childAgentId'] = child_agent_id
 
         # 1. 添加到派发者（如果派发者是某个已知 agent）
@@ -420,13 +425,15 @@ def _analyze_stuck_reason(agent_id: str, idle_seconds: int) -> Dict[str, Any]:
         }
     """
     from data.subagent_reader import get_active_runs
+    from data.config_reader import normalize_openclaw_agent_id
 
     # 检查是否在等待子 agent
     active_runs = get_active_runs()
+    prefix = f"agent:{normalize_openclaw_agent_id(agent_id)}:"
     for run in active_runs:
         requester_key = run.get('requesterSessionKey', '')
         # 如果这个 agent 是 requester，说明它在等待子 agent
-        if f'agent:{agent_id}:' in requester_key:
+        if prefix in requester_key:
             child_key = run.get('childSessionKey', '')
             if child_key and ':' in child_key:
                 parts = child_key.split(':')
@@ -533,7 +540,8 @@ async def get_collaboration():
     """获取协作流程数据 - 主 Agent 与子 Agents 的拓扑关系，含模型配置与最近调用"""
     from data.config_reader import (
         get_agents_list, get_agent_models, get_models_configured_by_agents,
-        get_model_display_name, get_main_agent_id
+        get_model_display_name, get_main_agent_id,
+        agent_ids_equal, normalize_openclaw_agent_id, canonical_agent_id_from_config,
     )
     from data.subagent_reader import get_active_runs
     from status.status_calculator import calculate_agent_status, get_current_task
@@ -553,8 +561,10 @@ async def get_collaboration():
         active_runs = get_active_runs()
 
         main_agent_id = get_main_agent_id()
-        main_agent_config = next((a for a in agents_list if a.get('id') == main_agent_id), None)
-        sub_agents_config = [a for a in agents_list if a.get('id') != main_agent_id]
+        main_agent_config = next(
+            (a for a in agents_list if agent_ids_equal(a.get('id'), main_agent_id)), None
+        )
+        sub_agents_config = [a for a in agents_list if not agent_ids_equal(a.get('id'), main_agent_id)]
 
         all_agents = [a for a in agents_list if a.get('id')]
         for agent in all_agents:
@@ -579,9 +589,10 @@ async def get_collaboration():
         main_stuck = None
         if active_runs:
             # 找到主 agent 作为 requester 的任务
+            main_prefix = f"agent:{normalize_openclaw_agent_id(main_agent_id)}:"
             for run in active_runs:
                 requester_key = run.get('requesterSessionKey', '')
-                if f'agent:{main_agent_id}:' in requester_key:
+                if main_prefix in requester_key:
                     main_current_task = _clean_task_name(run.get('task', ''))
                     break
             if not main_current_task and active_runs:
@@ -622,9 +633,10 @@ async def get_collaboration():
 
             # 获取子 agent 的当前任务
             current_task = ''
+            child_prefix = f"agent:{normalize_openclaw_agent_id(agent_id)}:"
             for run in active_runs:
                 child_key = run.get('childSessionKey', '')
-                if f'agent:{agent_id}:' in child_key:
+                if child_prefix in child_key:
                     current_task = _clean_task_name(run.get('task', ''))
                     break
 
@@ -695,6 +707,11 @@ async def get_collaboration():
             if not agent_id:
                 continue
 
+            agent_id_canon = canonical_agent_id_from_config(agent_id)
+            requester_id_canon = (
+                canonical_agent_id_from_config(requester_id) if requester_id else requester_id
+            )
+
             task_name = _clean_task_name(run.get('task', ''))
 
             task_id = f"task-{run.get('runId', agent_id)}"
@@ -708,8 +725,8 @@ async def get_collaboration():
             nodes.append(task_node)
 
             edges.append(CollaborationEdge(
-                id=f"edge-{agent_id}-{task_id}",
-                source=agent_id,
+                id=f"edge-{agent_id_canon}-{task_id}",
+                source=agent_id_canon,
                 target=task_id,
                 type="calls",
                 label="执行"
@@ -718,15 +735,15 @@ async def get_collaboration():
             # Spawn 链：主 Agent 派发 -> 子 Agent 执行
             if requester_id and requester_id != agent_id:
                 edges.append(CollaborationEdge(
-                    id=f"edge-spawn-{requester_id}-{task_id}",
-                    source=requester_id,
+                    id=f"edge-spawn-{requester_id_canon}-{task_id}",
+                    source=requester_id_canon,
                     target=task_id,
                     type="delegates",
                     label="派发"
                 ))
                 # 如果 requester 是主 agent，给主 agent 也添加一个任务节点（用户命令）
                 # 移除 main_agent_task_created 限制，支持多任务并行显示
-                if requester_id == main_agent_id:
+                if agent_ids_equal(requester_id, main_agent_id):
                     # 主 agent 的任务就是用户原始命令
                     main_task_id = f"task-main-{run.get('runId', 'current')}"
                     main_task_node = CollaborationNode(
@@ -745,7 +762,7 @@ async def get_collaboration():
                         label="执行"
                     ))
 
-            active_path.extend([main_agent_id, agent_id, task_id])
+            active_path.extend([main_agent_id, agent_id_canon, task_id])
 
     except Exception as e:
         print(f"Error building collaboration data: {e}")

package/dashboard/api/subagents.py

@@ -262,9 +262,10 @@ def _get_session_message_count(child_session_key: str) -> int:
     agent_id = parts[1]
 
     try:
-        from data.config_reader import get_openclaw_root
+        from data.config_reader import get_openclaw_root, normalize_openclaw_agent_id
         openclaw_path = get_openclaw_root()
-        sessions_index = openclaw_path / "agents" / agent_id / "sessions" / "sessions.json"
+        aid = normalize_openclaw_agent_id(agent_id)
+        sessions_index = openclaw_path / "agents" / aid / "sessions" / "sessions.json"
         if not sessions_index.exists():
             return 0
 
@@ -274,7 +275,7 @@ def _get_session_message_count(child_session_key: str) -> int:
         entry = index_map.get(child_session_key)
         if not entry:
             return 0
-        sessions_dir = openclaw_path / "agents" / agent_id / "sessions"
+        sessions_dir = openclaw_path / "agents" / aid / "sessions"
         session_path = resolve_session_jsonl_path(sessions_dir, entry)
         if not session_path:
             return 0
@@ -352,9 +353,10 @@ def _extract_subtasks_from_session(child_session_key: str) -> List[Dict[str, Any
     agent_id = parts[1]
 
     try:
-        from data.config_reader import get_openclaw_root
+        from data.config_reader import get_openclaw_root, normalize_openclaw_agent_id
         openclaw_path = get_openclaw_root()
-        sessions_index = openclaw_path / "agents" / agent_id / "sessions" / "sessions.json"
+        aid = normalize_openclaw_agent_id(agent_id)
+        sessions_index = openclaw_path / "agents" / aid / "sessions" / "sessions.json"
         if not sessions_index.exists():
             return []
 
@@ -364,7 +366,7 @@ def _extract_subtasks_from_session(child_session_key: str) -> List[Dict[str, Any
         entry = index_map.get(child_session_key)
         if not entry:
             return []
-        sessions_dir = openclaw_path / "agents" / agent_id / "sessions"
+        sessions_dir = openclaw_path / "agents" / aid / "sessions"
         session_path = resolve_session_jsonl_path(sessions_dir, entry)
         if not session_path:
             return []
@@ -512,9 +514,10 @@ def _extract_timeline_from_session(child_session_key: str) -> List[Dict[str, Any
     agent_id = parts[1]
 
     try:
-        from data.config_reader import get_openclaw_root
+        from data.config_reader import get_openclaw_root, normalize_openclaw_agent_id
         openclaw_path = get_openclaw_root()
-        sessions_index = openclaw_path / "agents" / agent_id / "sessions" / "sessions.json"
+        aid = normalize_openclaw_agent_id(agent_id)
+        sessions_index = openclaw_path / "agents" / aid / "sessions" / "sessions.json"
         if not sessions_index.exists():
             return []
 
@@ -524,7 +527,7 @@ def _extract_timeline_from_session(child_session_key: str) -> List[Dict[str, Any
         entry = index_map.get(child_session_key)
         if not entry:
             return []
-        sessions_dir = openclaw_path / "agents" / agent_id / "sessions"
+        sessions_dir = openclaw_path / "agents" / aid / "sessions"
         session_path = resolve_session_jsonl_path(sessions_dir, entry)
         if not session_path:
             return []

package/dashboard/api/timeline.py

@@ -1,15 +1,19 @@
 """
 Timeline API 路由 - 实时执行时序图
 """
+import logging
+import time
 from fastapi import APIRouter, Query, HTTPException
 from pydantic import BaseModel
 from typing import Optional, List, Dict, Any
 import sys
 from pathlib import Path
+
+LOG = logging.getLogger(__name__)
 sys.path.append(str(Path(__file__).parent.parent))
 
 from data.timeline_reader import get_timeline_steps, StepType, StepStatus
-from data.config_reader import get_agents_list
+from data.config_reader import get_agent_config
 
 router = APIRouter()
 
@@ -38,13 +42,17 @@ class TimelineResponse(BaseModel):
     agentName: Optional[str] = None
     model: Optional[str] = None
     startedAt: Optional[int] = None
+    runStartedAt: Optional[int] = None
     status: str
     steps: List[Dict[str, Any]]
     stats: TimelineStats
     message: Optional[str] = None
+    # 主 Agent 无会话文件时由后端置 True，避免前端误用「子代理」空态文案
+    isMainAgent: Optional[bool] = None
     # LLM 轮次分组
     rounds: Optional[List[LLMRound]] = None
     roundMode: Optional[bool] = None
+    dataSource: Optional[str] = None
 
 
 @router.get("/timeline/{agent_id}", response_model=TimelineResponse)
@@ -62,19 +70,21 @@ async def get_timeline(
     - 工具调用及结果
     - 错误信息
     """
-    # 验证 agent_id
-    agents = get_agents_list()
-    agent_info = None
-    for a in agents:
-        if a.get('id') == agent_id:
-            agent_info = a
-            break
-
+    agent_info = get_agent_config(agent_id)
     if not agent_info:
         raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
 
-    # 获取时序数据
+    t0 = time.perf_counter()
     result = get_timeline_steps(agent_id, session_key, limit)
+    elapsed_ms = (time.perf_counter() - t0) * 1000
+    if elapsed_ms >= 200.0:
+        LOG.info(
+            "timeline agent=%s limit=%d steps=%d ms=%.1f",
+            agent_id,
+            limit,
+            len(result.get("steps", [])),
+            elapsed_ms,
+        )
 
     # 补充 Agent 信息
     result['agentName'] = agent_info.get('name', agent_id)
@@ -101,8 +111,7 @@ async def get_timeline_steps_only(
 
     可按步骤类型过滤
     """
-    agents = get_agents_list()
-    if not any(a.get('id') == agent_id for a in agents):
+    if not get_agent_config(agent_id):
         raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
 
     result = get_timeline_steps(agent_id, session_key, limit)
@@ -122,8 +131,7 @@ async def get_timeline_summary(agent_id: str, session_key: Optional[str] = Query
 
     快速查看会话概览，不返回详细步骤
     """
-    agents = get_agents_list()
-    if not any(a.get('id') == agent_id for a in agents):
+    if not get_agent_config(agent_id):
         raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
 
     result = get_timeline_steps(agent_id, session_key, limit=10)  # 只需基本信息

package/dashboard/collaboration.py

@@ -113,7 +113,7 @@ async def get_collaboration():
     """获取协作流程数据 - 主 Agent 与子 Agents 的拓扑关系，含模型配置与最近调用"""
     from data.config_reader import (
         get_agents_list, get_agent_models, get_models_configured_by_agents,
-        get_model_display_name, get_main_agent_id
+        get_model_display_name, get_main_agent_id, agent_ids_equal,
     )
     from data.subagent_reader import get_active_runs
     from status.status_calculator import calculate_agent_status
@@ -132,8 +132,10 @@ async def get_collaboration():
         active_runs = get_active_runs()
 
         main_agent_id = get_main_agent_id()
-        main_agent_config = next((a for a in agents_list if a.get('id') == main_agent_id), None)
-        sub_agents_config = [a for a in agents_list if a.get('id') != main_agent_id]
+        main_agent_config = next(
+            (a for a in agents_list if agent_ids_equal(a.get('id'), main_agent_id)), None
+        )
+        sub_agents_config = [a for a in agents_list if not agent_ids_equal(a.get('id'), main_agent_id)]
 
         all_agents = [a for a in agents_list if a.get('id')]
         for agent in all_agents:

package/dashboard/data/agent_config_manager.py

@@ -7,7 +7,7 @@ from typing import Dict, Any, List, Optional
 import shutil
 from datetime import datetime
 
-from data.config_reader import get_openclaw_root
+from data.config_reader import get_openclaw_root, normalize_openclaw_agent_id, agent_ids_equal
 from data.session_reader import normalize_sessions_index
 
 
@@ -52,7 +52,7 @@ def get_agent_config(agent_id: str) -> Optional[Dict[str, Any]]:
     agent_list = agents.get('list', [])
 
     for agent in agent_list:
-        if agent.get('id') == agent_id:
+        if agent_ids_equal(agent.get('id'), agent_id):
             return agent
     return None
 
@@ -192,7 +192,7 @@ def update_agent_model(agent_id: str, primary: Optional[str] = None, fallbacks:
 
     found = False
     for agent in agent_list:
-        if agent.get('id') == agent_id:
+        if agent_ids_equal(agent.get('id'), agent_id):
             if 'model' not in agent:
                 agent['model'] = {}
 
@@ -223,7 +223,8 @@ def get_agent_full_info(agent_id: str) -> Dict[str, Any]:
     model_config = get_agent_model_config(agent_id)
 
     # 检查运行状态
-    session_file = get_openclaw_root() / "agents" / agent_id / "sessions" / "sessions.json"
+    aid = normalize_openclaw_agent_id(agent_id)
+    session_file = get_openclaw_root() / "agents" / aid / "sessions" / "sessions.json"
     status = 'idle'
     last_active = None
 
@@ -242,7 +243,7 @@ def get_agent_full_info(agent_id: str) -> Dict[str, Any]:
 
     return {
         'found': True,
-        'id': agent_id,
+        'id': agent_config.get('id', agent_id),
         'name': agent_config.get('name', agent_id),
         'workspace': agent_config.get('workspace', ''),
         'model': model_config,

package/dashboard/data/chain_reader.py

@@ -43,8 +43,10 @@ def _get_agent_info(agent_id: str) -> Dict[str, Any]:
     """获取单个 agent 的信息"""
     config = _get_agents_config()
     agents = config.get('agents', {}).get('list', [])
+    from data.config_reader import agent_ids_equal
+
     for a in agents:
-        if a.get('id') == agent_id:
+        if agent_ids_equal(a.get('id'), agent_id):
             return a
     return {}
 

package/dashboard/data/config_reader.py

@@ -4,8 +4,46 @@
 """
 import json
 import os
+import re
 from pathlib import Path
-from typing import List, Dict, Any
+from typing import List, Dict, Any, Optional
+
+# 与 OpenClaw core 的 normalizeAgentId 对齐（dist/session-key-*.js）
+_DEFAULT_OPENCLAW_AGENT_ID = "main"
+_VALID_OPENCLAW_AGENT_ID_RE = re.compile(r"^[a-z0-9][a-z0-9_-]{0,63}$", re.IGNORECASE)
+_INVALID_OPENCLAW_AGENT_CHARS_RE = re.compile(r"[^a-z0-9_-]+")
+
+
+def normalize_openclaw_agent_id(value: Optional[str]) -> str:
+    """
+    将 agents.list[].id 规范化为状态目录名（agents/<id>/sessions）。
+    OpenClaw 落盘时始终使用该形式；配置里可写任意大小写。
+    """
+    trimmed = (value or "").strip()
+    if not trimmed:
+        return _DEFAULT_OPENCLAW_AGENT_ID
+    normalized = trimmed.lower()
+    if _VALID_OPENCLAW_AGENT_ID_RE.match(trimmed):
+        return normalized
+    sanitized = _INVALID_OPENCLAW_AGENT_CHARS_RE.sub("-", normalized)
+    sanitized = sanitized.lstrip("-").rstrip("-")[:64] or _DEFAULT_OPENCLAW_AGENT_ID
+    return sanitized
+
+
+def agent_ids_equal(a: Optional[str], b: Optional[str]) -> bool:
+    """两枚 Agent ID 是否在 OpenClaw 语义下相同（大小写/规范化后）。"""
+    return normalize_openclaw_agent_id(a) == normalize_openclaw_agent_id(b)
+
+
+def canonical_agent_id_from_config(agent_id: str) -> str:
+    """
+    返回 agents.list 中条目的原始 id（与配置一致），供 UI 节点 id 与边 source/target 对齐。
+    若配置中无匹配，则回退为规范化 id。
+    """
+    cfg = get_agent_config(agent_id)
+    if cfg and cfg.get("id"):
+        return str(cfg["id"])
+    return normalize_openclaw_agent_id(agent_id)
 
 
 def get_openclaw_root() -> Path:
@@ -52,8 +90,11 @@ def get_agents_list() -> List[Dict[str, Any]]:
 
 
 def get_main_agent_id() -> str:
-    """获取主 Agent ID（配置中 id 为 main 的，或列表第一个）"""
+    """获取主 Agent ID：优先 default:true，其次 id 为 main，否则列表第一项。"""
     agents = get_agents_list()
+    for a in agents:
+        if a.get('default') is True:
+            return a.get('id', 'main')
     for a in agents:
         if a.get('id') == 'main':
             return 'main'
@@ -78,10 +119,11 @@ def get_workspace_paths() -> List[Path]:
 
 
 def get_agent_config(agent_id: str) -> Dict[str, Any]:
-    """获取单个 Agent 配置"""
+    """获取单个 Agent 配置（id 与 openclaw.json 中条目大小写可不一致）。"""
     agents = get_agents_list()
+    target = normalize_openclaw_agent_id(agent_id)
     for agent in agents:
-        if agent.get('id') == agent_id:
+        if normalize_openclaw_agent_id(agent.get("id")) == target:
             return agent
     return {}
 

package/dashboard/data/error_analyzer.py

@@ -31,7 +31,7 @@ class ErrorSeverity(Enum):
     LOW = "low"            # 轻微错误，可忽略
 
 
-from data.config_reader import get_openclaw_root
+from data.config_reader import get_openclaw_root, normalize_openclaw_agent_id
 
 
 # 错误模式匹配规则
@@ -313,7 +313,8 @@ def get_tool_call_chain(session_path: Path, before_turn: int, limit: int = 10) -
 
 def analyze_agent_errors(agent_id: str, session_limit: int = 5) -> Dict[str, Any]:
     """分析 Agent 的错误情况"""
-    sessions_dir = get_openclaw_root() / "agents" / agent_id / "sessions"
+    aid = normalize_openclaw_agent_id(agent_id)
+    sessions_dir = get_openclaw_root() / "agents" / aid / "sessions"
     if not sessions_dir.exists():
         return {'agentId': agent_id, 'error': 'Sessions directory not found', 'errors': []}
 
@@ -415,7 +416,8 @@ def analyze_all_agents_errors() -> Dict[str, Any]:
 
 def get_error_detail(agent_id: str, session_file: str, turn_index: int) -> Optional[Dict[str, Any]]:
     """获取单个错误的详细信息"""
-    session_path = get_openclaw_root() / "agents" / agent_id / "sessions" / session_file
+    aid = normalize_openclaw_agent_id(agent_id)
+    session_path = get_openclaw_root() / "agents" / aid / "sessions" / session_file
     if not session_path.exists():
         return None
 

package/dashboard/data/session_reader.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from typing import List, Dict, Any, Optional
 
 
-from data.config_reader import get_openclaw_root
+from data.config_reader import get_openclaw_root, normalize_openclaw_agent_id
 
 _META_SESSION_INDEX_KEYS = frozenset({"entries", "version", "schema"})
 
@@ -70,7 +70,7 @@ def resolve_session_jsonl_path(sessions_dir: Path, entry: Dict[str, Any]) -> Opt
 
 def get_agent_sessions_path(agent_id: str) -> Optional[Path]:
     """获取 Agent 的 sessions 目录"""
-    sessions_path = get_openclaw_root() / "agents" / agent_id / "sessions"
+    sessions_path = get_openclaw_root() / "agents" / normalize_openclaw_agent_id(agent_id) / "sessions"
     if not sessions_path.exists():
         return None
     return sessions_path
@@ -211,7 +211,8 @@ def get_session_updated_at(agent_id: str) -> int:
     获取 Agent 会话的最后更新时间（sessions.json 中 updatedAt 的最大值）
     用于判断「最近 5 分钟是否有 session 活动」
     """
-    sessions_index = get_openclaw_root() / "agents" / agent_id / "sessions" / "sessions.json"
+    aid = normalize_openclaw_agent_id(agent_id)
+    sessions_index = get_openclaw_root() / "agents" / aid / "sessions" / "sessions.json"
     if not sessions_index.exists():
         return 0
     
@@ -261,12 +262,13 @@ def get_session_turns(agent_id: str, session_key: Optional[str] = None, limit: i
     解析 jsonl 获取会话轮次，每轮包含 user/assistant/toolResult 及 usage
     返回格式: [{ turnIndex, role, content, usage?, toolCalls?, stopReason?, timestamp }]
     """
-    sessions_index = get_openclaw_root() / "agents" / agent_id / "sessions" / "sessions.json"
+    aid = normalize_openclaw_agent_id(agent_id)
+    sessions_index = get_openclaw_root() / "agents" / aid / "sessions" / "sessions.json"
     if not sessions_index.exists():
         return []
     
     session_file: Optional[Path] = None
-    sessions_path = get_openclaw_root() / "agents" / agent_id / "sessions"
+    sessions_path = get_openclaw_root() / "agents" / aid / "sessions"
     if session_key:
         try:
             with open(sessions_index, 'r', encoding='utf-8') as f: