mirror of
https://github.com/qingchencloud/clawpanel.git
synced 2026-05-06 20:02:49 +08:00
3.1 KiB
3.1 KiB
ClawPanel v0.9.0 规划
命令执行权限管理 (Issue #55)
需求
AI 助手执行终端命令时,允许用户配置白名单/黑名单规则,控制哪些命令可以执行。
规则类型
| 类型 | 示例 | 说明 |
|---|---|---|
| 精确匹配 | go run main.go |
只允许/禁止这一条完整命令 |
| 前缀通配 | go * |
允许/禁止所有 go 开头的命令 |
| 全局 | * |
允许/禁止所有命令 |
配置模式
- 确认模式(默认)— 每条命令都弹窗确认
- 白名单模式 — 匹配白名单的命令自动执行,其余弹窗确认
- 黑名单模式 — 匹配黑名单的命令直接拒绝,其余弹窗确认
- 无限模式 — 所有命令自动执行(当前已有的 unlimited 模式)
存储位置
~/.openclaw/clawpanel.json → commandRules 字段:
{
"commandRules": {
"mode": "whitelist",
"rules": [
{ "pattern": "go run *", "action": "allow" },
{ "pattern": "npm *", "action": "allow" },
{ "pattern": "rm -rf /", "action": "deny" },
{ "pattern": "git *", "action": "allow" }
]
}
}
实现方案
-
设置页面 UI — 安全设置页面新增「命令规则」区域
- 规则列表(增删改)
- 模式切换(确认/白名单/黑名单/无限)
- 预设模板(开发者常用、安全最小权限等)
-
存储 — 读写
clawpanel.json的commandRules -
拦截逻辑 —
assistant.js的assistant_exec调用前- 解析命令字符串
- 按规则列表逐条匹配(支持 glob 通配符)
- 匹配到 allow → 自动执行
- 匹配到 deny → 直接拒绝并提示
- 无匹配 → 按模式决定(弹窗确认或拒绝)
-
Rust 后端 —
assistant_exec命令增加规则检查- 从
clawpanel.json读取规则 - glob 匹配逻辑
- 返回
{ allowed: bool, rule: string }给前端
- 从
优先级
中等。当前 AI 助手已有 4 种模式(聊天/规划/执行/无限),命令规则是对「执行」模式的细化增强。
安装体验优化
默认安装原版包
当前版本选择器默认选中「汉化版」,改为默认「原版」(official)。用户可切换。
安装页面环境检测实时生效
保存自定义 Node.js 路径后,检查是否需要重启才生效。v0.8.0 已改用 RwLock 支持运行时刷新,需验证是否完全生效。
Linux Web 版后台更新机制
Linux Web 版检测到新版本后,目前只能手动 git pull。需要实现:
- 面板内一键更新按钮(自动 git pull + npm install + 重启服务)
- 或者 systemd 服务自动拉取更新
其他待规划功能
- 消息渠道:渠道级别的消息统计(收发量、响应时间)
- 模型配置:支持更多服务商预设(硅基流动、智谱、百川、通义千问等国内模型)
- Docker 桌面版:Rust 原生 Docker API(bollard crate)替代 Node.js 后端
- 前端热更新增量包:只下载变更文件,减小更新包体积
- 多语言支持:i18n 框架(中/英双语)