OpenClaw
会话模式切换

Session Mode 是一个独立 OpenClaw 插件。它通过 /mode 命令在同一会话中切换 Fast、Standard 和 Expert，并把模型目标、推理预算与工具策略绑定到当前 sessionKey。

npm run quickstart
npm run openclaw:ui:build
npm run openclaw:native:setup
OPENCLAW_STATE_DIR=.artifacts/native-openclaw-state openclaw gateway run

普通用户不应为每类任务反复调整上下文、输出预算、推理强度和工具权限。Session Mode 提供三个可理解的模式，并把配置选择限制在当前会话。

运行流程

1. /mode 解析目标模式和当前 sessionKey。
2. 状态存储以原子写入保存 sessionKey -> mode。
3. before_tool_call 在工具执行前检查 Fast 白名单。
4. before_model_resolve 为 Fast 或 Expert 选择预配置模型目标。
5. Standard 不返回模型覆盖。

验收标准

• 插件 18 项、宿主 6 项自动化测试已由 GitHub Actions 通过。
• OpenClaw runtime inspect 可以发现一个命令、两个 typed hooks 和一个 HTTP route。
• 原生 Chat 可以切换 Fast、Standard、Expert，并回读当前会话状态。
• Fast 实际拦截 exec；Standard 和 Expert 实际执行并返回结果。
• 结构化验收回读模型目录预算和宿主 session 覆盖。

session-mode-switch 是一个可独立 link 安装的 OpenClaw 插件。插件没有修改 OpenClaw 内核。当前已验证四类运行时注册点：/mode 命令、before_tool_call、before_model_resolve 和 /session-mode-switch HTTP route。构建脚本在官方 Control UI 产物中注入模式控件资源，Gateway 通过 controlUi.root 提供页面。

npm run quickstart 执行插件测试、类型检查、宿主 UI 测试和原生 UI 构建。测试覆盖 Profile、命令解析、会话状态、Fast 工具策略、OpenClaw 适配层、Control UI 构建和 Gateway API。

需求状态

REQ-01 至 REQ-08 已验证，覆盖模式预算、Fast 工具边界、Standard 默认、Session 隔离、插件生命周期和 OpenClaw 原生 WebUI 控件。REQ-09 与 REQ-10 由 AI Coding 报告、真实用量、TDD 记录和工程日志支撑。

评估结论

当前版本包含基础插件和原生 WebUI 控件。后续使用固定任务集记录 usage、延迟、工具调用数、错误类型和用户选模纠正率，再评估三档模式对成本与成功率的长期影响。

本项目没有把模型生成内容直接视为完成结果。实施顺序是：从产品行为建立需求编号，检查 OpenClaw SDK 和本机运行状态，先写行为测试，再实现核心模块和适配层，最后用插件生命周期命令核对注册结果。

模型按阶段选择：需求理解和 Spec 使用 Codex + 5.6 sol，主要处理截图需求、约束拆解和技术方案不确定性；实施阶段切换到 Codex 5.5，负责机械编码、文档整理、链接扫描和验证。

人工负责问题定义、技术路线取舍、项目周期和关键节点、交付形态、产品价值判断以及视觉审美；AI 负责把这些决策落成候选方案、代码、测试、运行命令、报告和站点。

/mode 命令返回 continueAgent=false。模式切换和状态查询属于确定性控制命令，不进入产品模型回合。AI Coding 成本按使用统计面板记录：总使用 Token 230.37M，总使用额度 $119.45。

主要实施由单一主 Agent 完成；交付收口增加两个只读审计 Agent。当前工具没有提供分 Agent usage，因此不估算各 Agent 的 Token。

后续如果要评估模式收益，每个模式应执行固定轻量任务和固定多步任务，记录输入、输出、总 Token、首 Token 延迟、总延迟、工具调用数、任务成功率和错误类型。

前置条件：Node 22 或更高版本、开源 OpenClaw 2026.6.33，以及一份能正常启动 Gateway 的本机配置。默认模型需支持至少 128k 上下文、16k 输出，并声明 reasoning 能力。

npm run quickstart
npm run openclaw:native:setup
OPENCLAW_STATE_DIR=.artifacts/native-openclaw-state \
  openclaw gateway run

# 另一终端
npm run openclaw:native:verify
open http://127.0.0.1:18891/

预期：插件 18 项、宿主测试 6 项通过；Gateway 页面包含 OpenClaw shell 与 Session Mode 控件，结构化结果包含三档工具策略、Fast / Expert 模型预算和宿主 session 覆盖。

本次成本主口径来自使用统计面板。面板显示：今日调用 675 次、今日消费 $100.86、今日 Token 189.64M；总请求 843、总使用额度 $119.45、总使用 Token 230.37M。

实际全流程约 5 小时：前期理解与方案约 1.5 小时，实施、验证、报告和站点整理约 3.5 小时。时间口径与 Token 统计分开记录。

实际美元成本：$119.45
人民币参考：$119.45 x 7.2 ≈ ¥860

成本控制策略：需求冻结后再大规模改写；长文档先定位片段再编辑；验证脚本批量执行；只有架构判断和复杂纠偏使用高推理模型。

可复用 Skill 卡片

• openclaw-requirement-mapper：把自然语言需求转换为 REQ、验收条件、代码、测试和运行证据。
• openclaw-plugin-guardrails：约束 session 隔离、工具执行前拦截和模型目标路由。
• native-host-evidence：构建隔离宿主、执行真实会话、输出截图与结构化结果。
• agent-cost-ledger：记录模型、Agent、usage、费用、重试原因和任务结果。
• human-decision-ledger：记录人工对目标、范围、交付形态和视觉审美的关键判断。
• opensource-project-site：把 README、Spec、测试和路线图整理为外部项目站点。

过程记录区分观察、实现、验证和呈现。历史计划不会被包装成完成证明。

1. 理解：从功能目标建立验收矩阵，识别三个模式、五工具白名单、Session 隔离和插件安装边界。
2. 设计：采用 /mode、sessionKey 原子持久化、工具执行前拦截和模型目标路由。
3. 开发：Profile → 命令 → 状态 → 工具策略 → SDK 适配，按风险从纯核心到运行边界推进。
4. 调试：修正 /fast 冲突、旧 hook API 假设、参数注入能力和原生 UI 会话映射。
5. 验证：自动化测试、runtime inspect、原生宿主会话、链接检查和结构检查分别记录。

模型记录：需求理解与 Spec 使用 Codex + 5.6 sol；实施与整理使用 Codex 5.5；方向判断用高推理模型，重复执行用成本更低的模型，确定性事实用命令验证。

人工干预记录：人工确定产品目标、技术方案取舍、项目周期和关键节点、交付物形态、产品价值、视觉方向和可操作范围，并把表达从内部任务说明调整为外部开源项目说明。

时间口径：全流程实际约 5 小时。前期理解与方案约 1.5 小时，后续实现、验证、报告和站点整理约 3.5 小时；文件时间保留为活动窗口参考，不替代人工净工时记录。

开源 OpenClaw 2026.6.33 已加载插件和定制 Control UI。runtime 注册与真实 Chat 行为分别验收。

commands: ["mode"]
typedHooks: ["before_model_resolve", "before_tool_call"]
httpRouteCount: 1
route: /session-mode-switch
diagnostics: []

结构化验证确认 OpenClaw shell、Session Mode 资源和宿主目录预算；Fast 拦截 exec，Standard 与 Expert 放行。三档 Chat 工具结果另有宿主截图。

当前版本完成模式切换、会话隔离、Fast 工具边界、Standard 默认、Expert 高预算目标、插件注册、OpenClaw 原生 WebUI 控件、中文文档和统一交付站点。

证据清单把需求、代码、测试和宿主结果连接起来。REQ-01 至 REQ-10 均可回到源码、测试、工程记录或真实运行证据。