Session Mode Switch

Name: Session Mode Switch
Rating: 3.5 (1 reviews)
Author: Wishyouerehere9610

By Wishyouerehere9610 👁 31 views ▲ 0 votes

Session-level Fast/Standard/Expert mode switch plugin for OpenClaw

Homepage GitHub

Configuration Example

{
  "modelTargets": {
    "fast": { "provider": "dashscope-fast", "model": "qwen3" },
    "expert": { "provider": "dashscope-expert", "model": "qwen3" }
  }
}

README

# Session Mode for OpenClaw

> 用一个确定性的 OpenClaw 插件，把会话切换成 Fast、Standard、Expert 三种工作模式。

Session Mode 解决的是一个很具体的问题：同一个 AI 工作台里，轻量问答、日常协作和复杂研发任务不该共用同一套上下文预算、输出预算、推理强度和工具权限。插件通过 `/mode` 命令把模式绑定到当前 `sessionKey`，让每个会话独立选择合适的模型目标和执行策略。

## 能力概览

- `/mode fast|standard|expert|status|help`：切换或查询当前会话模式；控制命令本身不发起模型调用。
- Fast：32k 上下文、4k 输出、低推理，只允许 `read`、`write`、`web_search`、`web_fetch`、`session_status`。
- Standard：不注入覆盖，继续使用 OpenClaw 新会话默认配置。
- Expert：128k 上下文、16k 输出、高推理，路由到管理员预配置的高预算模型目标。
- Session 隔离：模式按 `sessionKey` 原子持久化，一个会话不会覆盖另一个会话。
- 执行前控制：Fast 工具白名单由 `before_tool_call` hook 强制执行。

## 当前状态

核心命令、状态存储、工具策略、模型目标路由、本地原型机和运行时注册检查已经完成。当前证据包括：

| 证据层 | 状态 | 入口 |
|---|---|---|
| 行为测试 | 9 项通过 | [`plugin/tests`](./plugin/tests) |
| 本地原型机 | 可复现三档切换、工具拦截、会话隔离和模型路由 | [`prototype/session-mode-prototype.mjs`](./prototype/session-mode-prototype.mjs) |
| 运行时注册 | `mode` 命令与两个 typed hooks 可被 runtime inspect 发现 | [`evidence/runtime/install-lifecycle.md`](./evidence/runtime/install-lifecycle.md) |
| 交付站点 | 产品说明、技术方案、测试评估、成本复盘和过程记录统一展示 | [`delivery/index.html`](./delivery/index.html) |

## 快速开始

```bash
cd plugin
npm test
npm run typecheck

cd ..
/Users/sonic/.openclaw-bundle/node/bin/node prototype/session-mode-prototype.mjs
/Users/sonic/.openclaw-bundle/wrapper/openclaw plugins inspect session-mode-switch --runtime --json
```

模型目标在 OpenClaw 中预先配置，插件只保存路由名称：

```json
{
  "modelTargets": {
    "fast": { "provider": "dashscope-fast", "model": "qwen3" },
    "expert": { "provider": "dashscope-expert", "model": "qwen3" }
  }
}
```

Standard 没有目标映射。Fast 与 Expert 的 `contextWindow`、`maxTokens`、`thinking` 和 `reasoningEffort` 由宿主模型配置承载，插件只负责按当前会话选择目标。

## GitHub Pages 展示

根目录提供了 `index.html` 跳转页。启用 GitHub Pages 后，可以直接打开仓库 Pages 首页查看交付站点；本地也可以直接打开：

```bash
open delivery/index.html
```

## 工程方法

这个项目采用“人工决策 + AI 执行 + 证据验收”的方式推进。

- 人工负责：产品目标、技术路线取舍、项目周期和关键节点、交付形态、产品价值与视觉审美。
- AI 负责：需求结构化、源码检索、候选实现、测试补全、命令验证、报告整理和站点生成。
- 验收方式：每个结论都落到 `REQ -> CODE -> TEST -> EVID`，不把生成内容直接当作完成证明。

模型使用也按阶段控制成本：前期需求理解和 Spec 使用 Codex + 5.6 sol 处理不确定性；实施阶段切换到 Codex 5.5 完成机械实现、文档整理和验证。高推理模型只用在高不确定性阶段，确定性检查交给测试、类型检查和脚本。

实际全流程约 5 小时：前期理解与方案约 1.5 小时，后续实现、验证、报告和交付站点整理约 3.5 小时。时间记录用于解释项目推进方式，不包装成精确计费账单。

使用统计面板显示：总请求 843，总使用 Token 230.37M，总使用额度 $119.45，折算约 ¥860。成本报告以这组真实 usage 作为主口径。

## 项目结构

```text
.
├── delivery/    # 离线项目站点，可作为 GitHub Pages 展示页
├── docs/        # Spec、技术报告、测试评估、成本复盘和方法手册
├── evidence/    # 运行输出、截图、manifest 和最终验证记录
├── plugin/      # OpenClaw 插件源码与测试
├── prototype/   # 本地原型机 harness
└── worklog/     # 设计、开发、调试和时间记录
```

## 主要文档

- [产品 Spec](./docs/00-product-spec.md)
- [技术报告](./docs/02-tech-report.md)
- [测试与评估报告](./docs/03-test-evaluation-report.md)
- [AI Coding 过程报告](./docs/04-ai-coding-report.md)
- [模型、Agent 与 Token 报告](./docs/05-model-agent-token-report.md)
- [真实用量与模型复盘](./docs/07-cost-control-report.md)
- [可复用方法与 Skill](./docs/08-reusable-methods.md)
- [安装与复现](./docs/06-install-reproduce.md)
- [最终验证报告](./evidence/final-verification.md)

## 路线图

- 可视化模式选择器：在命令入口之外提供更低门槛的模式切换。
- 固定任务集评测：记录三档模式的 Token、延迟、成功率、工具调用数和错误类型。
- ArkClaw 策略层：把模式、预算、权限和 Trace 做成团队级模板，分发到不同 Agent 工作流。
- 商业化机会：作为企业 Agent 治理增值层，按治理席位、策略模板、调用量或审计留存周期收费。

## 数据边界

状态文件只保存会话键和模式，不保存聊天正文、模型回复、附件或用户资料。Provider、模型凭证和连接器认证由宿主系统管理，不进入插件状态和交付材料。

tools