Chapter 07
非功能需求
性能、安全性、可靠性与合规性要求。
7.1 安全性
| 需求 | 描述 | 优先级 |
|---|---|---|
| 沙箱执行 | Shell 命令默认在 Docker/沙箱中运行 | P0 |
| Exec 审批 | 高危命令需人工确认 | P0 |
| DM 配对 | 未知用户需配对码验证 | P0 |
| API Key 存储 | 本地 JSON5,不上传云端 | P0 |
| Gateway 认证 | Token/密码保护接口 | P0 |
| 插件权限 | 第三方插件声明权限 | P1 |
| 审计日志 | 关键操作可追溯 | P1 |
7.2 隐私
| 需求 | 描述 | 优先级 |
|---|---|---|
| 本地优先存储 | 对话、记忆、配置全部本地 | P0 |
| 零遥测 | 不收集用户数据 | P0 |
| 模型自由 | 可选本地模型实现零数据外传 | P0 |
| 数据可删 | 可完整删除所有本地数据 | P1 |
7.3 性能
| 指标 | 目标值 | 说明 |
|---|---|---|
| 消息路由延迟 | < 200ms | Gateway → Agent |
| 渠道端到端延迟 | < 3s | 不含模型推理 |
| 并发会话数 | ≥ 50 | 单 Gateway 实例 |
| Gateway 启动 | < 10s | 到所有渠道就绪 |
| 内存占用 | < 512MB | 基础运行时 |
| 热加载延迟 | < 3s | 技能/插件变更 |
7.4 可用性
| 需求 | 描述 | 优先级 |
|---|---|---|
| 一键安装 | npm install -g openclaw && openclaw onboard | P0 |
| 引导向导 | 首次运行交互式配置 | P0 |
| 错误恢复 | 渠道自动重连 + Agent 崩溃恢复 | P0 |
| Doctor 诊断 | openclaw doctor 自动检测修复 | P1 |
| 自动更新 | openclaw update | P1 |
7.5 可扩展性
| 需求 | 描述 | 优先级 |
|---|---|---|
| 插件架构 | Hook-based 生命周期 | P0 |
| 技能市场 | ClawHub 社区 | P0 |
| MCP 协议 | mcporter 桥接 | P1 |
| 多节点 | iOS/Android/macOS 远程接入 | P1 |
7.6 兼容性
| 维度 | 支持范围 |
|---|---|
| Node.js | >= 22.12.0 |
| OS (服务端) | macOS / Linux / Windows (WSL) |
| OS (客户端) | macOS / iOS 16+ / Android 10+ |
| 浏览器 (Web UI) | Chrome / Firefox / Safari 最新两版 |
| Docker | Docker 20+ / Podman |