mirror of
https://github.com/qingchencloud/clawpanel.git
synced 2026-05-07 06:22:53 +08:00
28 KiB
28 KiB
AI 助手功能扩展规划
基于现有工具架构（TOOL_DEFS + executeTool + getEnabledTools），扩展 6 大能力模块。 每个模块独立开关，遵循现有的
_config.tools.xxx+ 设置面板 toggle 模式。
当前架构概览
TOOL_DEFS = {
system: [get_system_info] // 始终可用
process: [list_processes, check_port] // 始终可用
interaction: [ask_user] // 始终可用
terminal: [run_command] // 开关控制
fileOps: [read_file, write_file, list_directory] // 开关控制
}
_config.tools = { terminal: true/false, fileOps: true/false }
扩展后：
TOOL_DEFS = {
...existing,
docker: [docker_list, docker_exec, docker_logs, wsl_exec] // 新增
webSearch: [web_search, fetch_url] // 新增
ssh: [ssh_exec, ssh_read_file, ssh_write_file] // 新增
knowledge: [search_knowledge] // 新增
}
_config.tools = {
...existing,
docker: false, // 默认关闭
webSearch: false, // 默认关闭
ssh: false, // 默认关闭
knowledge: false, // 默认关闭
}
模块一：Docker / WSL 管理工具
场景
- 用户的 OpenClaw 可能安装在 Docker 容器或 WSL 中
- 本地检测不到时，帮用户在容器/WSL 内操作
- 查看容器日志、进入容器执行命令、管理容器生命周期
工具定义
| 工具名 | 描述 | 参数 | 危险等级 |
|---|---|---|---|
docker_list |
列出 Docker 容器 | filter?, all? |
安全 |
docker_exec |
在容器内执行命令 | container, command |
⚠️ 危险 |
docker_logs |
查看容器日志 | container, lines? |
安全 |
docker_compose |
执行 docker-compose 命令 | action, file?, service? |
⚠️ 危险 |
wsl_exec |
在 WSL 内执行命令 | distro?, command |
⚠️ 危险 |
wsl_list |
列出 WSL 发行版 | — | 安全 |
后端实现
Tauri (Rust):
- docker_list → Command::new("docker").args(["ps", ...])
- docker_exec → Command::new("docker").args(["exec", container, ...])
- wsl_exec → Command::new("wsl").args(["-d", distro, "-e", ...]) (Windows only)
dev-api.js (Web):
- execSync('docker ps --format json')
- execSync(`docker exec ${container} ${command}`)
- execSync(`wsl -d ${distro} -e ${command}`) (Windows only)
安全围栏
docker_exec/wsl_exec归入 DANGEROUS_TOOLSdocker rm,docker rmi,docker system prune归入 CRITICAL_PATTERNS
UI 扩展
- 设置面板工具权限 tab 新增 toggle：
Docker / WSL 工具 — 允许管理容器和 WSL 环境
内置技能卡片
{
id: 'detect-docker-openclaw',
icon: '🐳',
name: '检测 Docker/WSL 中的 OpenClaw',
desc: '扫描 Docker 容器和 WSL，查找 OpenClaw 安装',
tools: ['docker'],
prompt: `请帮我检查 Docker 和 WSL 中是否安装了 OpenClaw。
1. 调用 get_system_info 判断操作系统
2. 用 docker_list 列出所有容器，过滤包含 openclaw/gateway 的
3. 如果是 Windows，用 wsl_list 列出 WSL 发行版
4. 对每个 WSL 发行版，用 wsl_exec 执行 "which openclaw" 检测
5. 汇总发现的 OpenClaw 实例及其状态`
}
优先级：🔴 高（解决用户最常见困惑）
工时估算：1-2 天
模块二：联网搜索工具
场景
- 用户遇到不常见的错误，AI 知识库可能没有
- 搜索 GitHub Issues、文档、Stack Overflow 找到解决方案
- 查找最新版本信息、API 文档等
工具定义
| 工具名 | 描述 | 参数 | 危险等级 |
|---|---|---|---|
web_search |
联网搜索关键词 | query, max_results? |
安全 |
fetch_url |
抓取网页内容 | url |
安全 |
后端实现方案（3 选 1）
方案 A：DuckDuckGo Instant Answer API（推荐，免费无 Key）
// 搜索
const resp = await fetch(`https://api.duckduckgo.com/?q=${encodeURIComponent(query)}&format=json`)
// 但 Instant Answer 只返回摘要，不返回搜索结果列表
// 实际搜索需要用 DuckDuckGo HTML 页面解析或第三方库
方案 B：SearXNG 代理（自托管，最灵活）
// 部署一个 SearXNG 实例，或者用公共实例
const resp = await fetch(`https://searx.example.com/search?q=${query}&format=json`)
方案 C：Jina Reader API（推荐搭配使用，免费）
// 将任意 URL 转为纯文本/Markdown
const resp = await fetch(`https://r.jina.ai/${targetUrl}`)
const text = await resp.text()
推荐组合
- 搜索：使用 DuckDuckGo 的
html.duckduckgo.com/html/?q=xxx页面解析结果 - 内容抓取：使用 Jina Reader
r.jina.ai/URL获取纯文本 - 两者都 免费无 Key，无需用户配置
系统提示词补充
## web_search 使用指南
当你无法确定答案或需要最新信息时，可以使用 web_search 搜索互联网。
搜索后，如果需要更多内容，可以用 fetch_url 抓取具体页面。
搜索技巧：
- 加 site:github.com 搜索 GitHub
- 加 site:stackoverflow.com 搜索 StackOverflow
- 搜索错误信息时，用引号包裹关键错误文本
安全围栏
- 搜索和抓取不涉及破坏性操作，不归入 DANGEROUS_TOOLS
- 但需要网络请求，添加超时保护（10 秒）
- URL 抓取限制最大内容长度（100KB → 截断）
UI 扩展
联网搜索 — 允许搜索互联网和抓取网页内容（需联网）
优先级：🔴 高（大幅提升问题解决能力）
工时估算：0.5-1 天
模块三：SSH 远程管理工具
场景
- 用户的 OpenClaw 部署在远程服务器上
- 帮用户远程安装、配置、排查 OpenClaw
- 远程查看日志、重启服务、修改配置
工具定义
| 工具名 | 描述 | 参数 | 危险等级 |
|---|---|---|---|
ssh_exec |
在远程服务器执行命令 | connection_id, command |
⚠️ 危险 |
ssh_read_file |
读取远程文件 | connection_id, path |
安全 |
ssh_write_file |
写入远程文件 | connection_id, path, content |
⚠️ 危险 |
配置数据结构
_config.sshConnections = [
{
id: 'my-server',
name: '生产服务器',
host: '192.168.1.100',
port: 22,
user: 'root',
authType: 'key', // 'key' | 'password'
keyPath: '~/.ssh/id_rsa',
// password 不存储在 localStorage，每次询问或用 keytar 安全存储
}
]
后端实现
Tauri (Rust):
- 使用 ssh2 crate 或调用系统 ssh CLI
- ssh_exec → Command::new("ssh").args(["-p", port, "user@host", command])
- ssh_read_file → ssh + cat
- ssh_write_file → 通过 stdin pipe 写入
dev-api.js (Web):
- 使用 node-ssh 或 ssh2 npm 包
- 或者直接调用 ssh CLI
设置 UI：新增 tab「远程连接」
┌─────────────────────────────────────────────┐
│ 模型配置 │ 工具权限 │ 远程连接 │ 助手人设 │
├─────────────────────────────────────────────┤
│ │
│ ┌─ 生产服务器 ──────────────── [编辑] [删] │
│ │ root@192.168.1.100:22 (密钥认证) │
│ └──────────────────────────────────────────│
│ │
│ ┌─ 测试服务器 ──────────────── [编辑] [删] │
│ │ admin@10.0.0.5:22 (密码认证) │
│ └──────────────────────────────────────────│
│ │
│ [+ 添加连接] │
│ │
│ 提示：推荐使用 SSH 密钥认证。 │
│ 生成密钥：ssh-keygen -t ed25519 │
│ 复制公钥：ssh-copy-id user@host │
│ │
└─────────────────────────────────────────────┘
安全围栏
ssh_exec,ssh_write_file归入 DANGEROUS_TOOLS- 密码认证：每次执行时用 ask_user 确认，或使用系统密钥链
- SSH 密钥路径验证：检查文件是否存在
- 关键命令（rm -rf, reboot 等）在远程同样走 CRITICAL_PATTERNS
系统提示词补充
## SSH 远程管理
用户可能配置了远程服务器连接。当操作远程服务器时：
- 先用 ask_user 确认要操作哪个连接
- 远程命令比本地更谨慎，优先使用只读操作
- 修改配置前先备份（cp xxx xxx.bak）
内置技能卡片
{
id: 'remote-manage',
icon: '🌐',
name: '远程管理 OpenClaw',
desc: '通过 SSH 连接远程服务器，管理 OpenClaw',
tools: ['ssh', 'fileOps'],
prompt: `请帮我管理远程服务器上的 OpenClaw。
1. 获取系统信息，列出已配置的 SSH 连接
2. 用 ask_user 让我选择要操作的服务器
3. 用 ssh_exec 检查远程 OpenClaw 状态
4. 检查 Gateway 进程和端口
5. 读取远程配置和日志
6. 汇总远程 OpenClaw 状态报告`
}
优先级：🟡 中（用户量较少但价值极高）
工时估算：2-3 天
模块四：知识库 + 灵魂移植（借尸还魂 🔥）
核心理念
OpenClaw 的 Agent 有一套完整的身份系统，由工作区引导文件定义：
~/.openclaw/workspace/ ← Agent 的"灵魂"所在
├── AGENTS.md ← 操作指令、规则、记忆管理方式
├── SOUL.md ← 人设、边界、语气（"Who You Are"）
├── IDENTITY.md ← 名称、物种、风格、表情符号、头像
├── USER.md ← 用户档案（名字、称呼、时区、偏好）
├── TOOLS.md ← 工具本地笔记（SSH 配置、设备名等）
├── HEARTBEAT.md ← 心跳任务清单
├── MEMORY.md ← 精选长期记忆（仅主会话加载）
└── memory/ ← 每日记忆日志
├── 2026-03-04-1609.md
└── ...
~/.openclaw/agents/<agentId>/agent/ ← Agent 的运行时状态
├── models.json ← 模型提供商配置（baseUrl + apiKey + models）
├── auth-profiles.json ← 认证配置文件
└── auth.json
"借尸还魂"不是复用知识库，而是完整接管 Agent 的灵魂—— ClawPanel 的 AI 助手直接读取这些文件，像 OpenClaw 一样把它们注入 system prompt， 从而变成那个 Agent：有他的名字、他的性格、他的记忆、他认识的用户。
4A：灵魂移植（Agent Identity Takeover）
工作流程
- 扫描
~/.openclaw/workspace/和~/.openclaw/agents/目录 - 发现 所有可用的 Agent 身份（main、test 等）
- 用户选择 要附身的 Agent
- 读取 该 Agent 的全部引导文件：
SOUL.md→ 注入为人设（替换 ClawPanel 助手的默认人设）IDENTITY.md→ 提取名称/表情/风格（替换助手名称和性格描述）USER.md→ 注入用户上下文（知道用户叫什么、偏好什么）AGENTS.md→ 注入操作规则（Agent 的行为准则）TOOLS.md→ 注入工具笔记MEMORY.md→ 注入长期记忆memory/→ 注入最近的每日记忆（最近 3 天）
- 注入 到
buildSystemPrompt()中，完全替代默认人设
实现
// 新增配置项
_config.soulSource = null // null = 使用 ClawPanel 默认 | 'openclaw:main' | 'openclaw:test' | 'custom'
_config.soulCache = null // 缓存读取的灵魂文件内容
// buildSystemPrompt 改造
function buildSystemPrompt() {
if (_config.soulSource?.startsWith('openclaw:')) {
// 借尸还魂模式：使用 OpenClaw Agent 的灵魂
return buildOpenClawSoulPrompt()
}
// 默认模式：使用 ClawPanel 自带的系统提示词
return buildDefaultPrompt()
}
function buildOpenClawSoulPrompt() {
const soul = _config.soulCache
if (!soul) return buildDefaultPrompt() // fallback
let prompt = ''
// 1. 身份注入
if (soul.identity) {
prompt += `# Identity\n${soul.identity}\n\n`
}
// 2. 灵魂注入（人设、边界、语气）
if (soul.soul) {
prompt += `# Soul\n${soul.soul}\n\n`
}
// 3. 用户上下文
if (soul.user) {
prompt += `# User\n${soul.user}\n\n`
}
// 4. 操作规则
if (soul.agents) {
prompt += `# Operating Instructions\n${soul.agents}\n\n`
}
// 5. 工具笔记
if (soul.tools) {
prompt += `# Tool Notes\n${soul.tools}\n\n`
}
// 6. 长期记忆
if (soul.memory) {
prompt += `# Long-term Memory\n${soul.memory}\n\n`
}
// 7. 最近的每日记忆
if (soul.recentMemories?.length) {
prompt += `# Recent Memory\n`
for (const m of soul.recentMemories) {
prompt += `## ${m.date}\n${m.content}\n\n`
}
}
// 8. 追加 ClawPanel 特有的工具说明（保持工具能力）
prompt += buildToolInstructions()
return prompt
}
灵魂加载函数
async function loadOpenClawSoul(agentId = 'main') {
const home = await getHomeDir()
const ws = `${home}/.openclaw/workspace` // 工作区是全局的，不按 agentId 分
const readSafe = async (path) => {
try { return await api.assistantReadFile(path) }
catch { return null }
}
const soul = {
identity: await readSafe(`${ws}/IDENTITY.md`),
soul: await readSafe(`${ws}/SOUL.md`),
user: await readSafe(`${ws}/USER.md`),
agents: await readSafe(`${ws}/AGENTS.md`),
tools: await readSafe(`${ws}/TOOLS.md`),
memory: await readSafe(`${ws}/MEMORY.md`),
recentMemories: [],
}
// 读取最近 3 天的每日记忆
try {
const memDir = await api.assistantListDir(`${ws}/memory`)
const files = memDir.split('\n').filter(f => f.match(/\d{4}-\d{2}-\d{2}/))
const recent = files.sort().slice(-3)
for (const f of recent) {
const content = await readSafe(`${ws}/memory/${f.trim()}`)
if (content) soul.recentMemories.push({ date: f.trim(), content })
}
} catch {}
return soul
}
UI：设置面板「助手人设」Tab 改造
┌─────────────────────────────────────────────┐
│ 模型配置 │ 工具权限 │ 知识库 │ 远程连接 │ 人设 │
├─────────────────────────────────────────────┤
│ │
│ 身份来源 │
│ ┌──────────────────────────────────────────│
│ │ ● ClawPanel 默认人设 │ ← 当前默认
│ │ ○ OpenClaw Agent 身份（借尸还魂） │ ← 新增
│ │ ○ 自定义人设 │
│ └──────────────────────────────────────────│
│ │
│ ─── 当选择「OpenClaw Agent」时显示 ──── │
│ │
│ 选择 Agent: [main ▼] │
│ │
│ 📜 灵魂文件预览 │
│ ┌──────────────────────────────────────────│
│ │ SOUL.md ✅ 已加载 (1.6KB) │
│ │ IDENTITY.md ✅ 已加载 (636B) │
│ │ USER.md ✅ 已加载 (237B) │
│ │ AGENTS.md ✅ 已加载 (7.8KB) │
│ │ TOOLS.md ✅ 已加载 (860B) │
│ │ MEMORY.md ❌ 未找到 │
│ │ memory/ 📝 2 个日志文件 │
│ └──────────────────────────────────────────│
│ │
│ [👻 附身！] [🔄 刷新] │
│ │
│ ⚠️ 附身后，助手将使用该 Agent 的人格、 │
│ 记忆和用户偏好。可随时切回默认。 │
│ │
│ ─── 当选择「ClawPanel 默认」时显示 ──── │
│ │
│ 助手名称: [晴辰助手 ] │
│ 助手性格: [________________________] │
│ │
└─────────────────────────────────────────────┘
附身后的效果
| 维度 | 默认模式 | 附身模式 |
|---|---|---|
| 名称 | "晴辰助手" | IDENTITY.md 中的名称 |
| 性格 | 简洁专业 | SOUL.md 定义的风格 |
| 称呼用户 | "你" | USER.md 中的称呼（如"爸爸"） |
| 行为规则 | ClawPanel 内置 | AGENTS.md 的规则体系 |
| 记忆 | 无 | MEMORY.md + 每日记忆 |
| 工具知识 | ClawPanel 内置 | TOOLS.md 的本地笔记 |
| 工具能力 | 保持不变 | 保持 ClawPanel 的工具 |
关键设计：附身只替换"灵魂"（system prompt），工具能力保持 ClawPanel 的。 因为 OpenClaw 的工具（exec/read/edit/write）和 ClawPanel 的工具本质相同， 但 ClawPanel 有独有的 docker/ssh/搜索等扩展工具，这些要保留。
4B：自定义知识库
在灵魂移植之外，仍然支持用户上传额外的知识文档：
数据存储
~/.openclaw/clawpanel-kb/
├── index.json # 知识库索引
├── docs/
│ ├── api-guide.md # 用户上传的文档
│ ├── faq.md
│ └── deploy-notes.txt
└── chunks/ # 分块索引（可选，用于大文档）
└── ...
实现方案
V1（简单方案）：
- 小文档（<8KB）直接全文注入 system prompt 尾部
- 大文档做关键词搜索（正则匹配 + 上下文窗口）
- 总注入 token 上限：4000 tokens
- 知识库和灵魂移植可叠加使用
V2（进阶方案）：
- embedding 语义搜索
search_knowledge工具让 AI 按需检索
优先级：<EFBFBD> 高（灵魂移植是杀手级差异化功能）
工时估算：灵魂移植 1-2 天，自定义知识库 V1 额外 1 天
模块五：模型配置自动导入
场景
- 用户已安装 OpenClaw 并配置了模型
- ClawPanel AI 助手需要单独配置模型（目前手动填写）
- 一键从 OpenClaw 配置导入，省去重复配置
实现
数据来源（两个层级）
层级 1：全局配置 ~/.openclaw/openclaw.json
{
"models": {
"providers": {
"shengsuanyun": {
"baseUrl": "http://127.0.0.1:8082/v1",
"apiKey": "sk-xxx",
"api": "openai-completions"
}
}
}
}
层级 2：Agent 模型注册表 ~/.openclaw/agents/<agentId>/agent/models.json
{
"providers": {
"openai": {
"baseUrl": "http://127.0.0.1:8082/v1",
"apiKey": "sk-eB3ybVNFvqB4fGrTUp3F8Lq16QxF7tut",
"api": "openai-completions",
"models": [
{ "id": "gpt-5.4", "name": "gpt-5.4", "contextWindow": 200000, "maxTokens": 8192 },
{ "id": "gpt-5.2-codex", "name": "gpt-5.2-codex", ... }
]
}
}
}
推荐优先读取 Agent 的 models.json——它有完整的 baseUrl + apiKey + models 列表， 一键就能填充 ClawPanel 助手的配置。
读取逻辑
async function discoverOpenClawModels() {
const home = await getHomeDir()
const results = []
// 1. 扫描所有 Agent 的 models.json
try {
const agents = await api.assistantListDir(`${home}/.openclaw/agents`)
for (const agentId of agents.split('\n').map(s => s.trim()).filter(Boolean)) {
try {
const raw = await api.assistantReadFile(`${home}/.openclaw/agents/${agentId}/agent/models.json`)
const data = JSON.parse(raw)
for (const [providerId, provider] of Object.entries(data.providers || {})) {
results.push({
source: `Agent: ${agentId}`,
providerId,
baseUrl: provider.baseUrl,
apiKey: provider.apiKey,
apiType: provider.api === 'openai-completions' ? 'openai' : provider.api,
models: (provider.models || []).map(m => m.id || m.name),
})
}
} catch {}
}
} catch {}
// 2. 读取全局 openclaw.json 作为补充
try {
const raw = await api.assistantReadFile(`${home}/.openclaw/openclaw.json`)
const config = JSON.parse(raw)
for (const [providerId, provider] of Object.entries(config.models?.providers || {})) {
// 去重：如果 Agent models.json 已有相同 providerId，跳过
if (!results.find(r => r.providerId === providerId)) {
results.push({
source: '全局配置',
providerId,
baseUrl: provider.baseUrl,
apiKey: provider.apiKey,
apiType: 'openai',
models: [], // 全局配置没有 models 列表
})
}
}
} catch {}
return results
}
UI：模型配置 tab 新增「导入」按钮
┌─────────────────────────────────────────────┐
│ API Base URL API 类型 │
│ [________________________] [OpenAI 兼容 ▼] │
│ │
│ API Key [测试] [拉取] [📥 导入] │ ← 新增「导入」按钮
│ [________________________] │
│ │
│ 模型 温度 │
│ [________________________] [0.7] │
│ │
└─────────────────────────────────────────────┘
点击「📥 导入」弹出选择面板：
┌─────────────────────────────────────────────┐
│ 从 OpenClaw 导入模型配置 │
│ │
│ 检测到以下已配置的服务商： │
│ │
│ ○ OpenAI │
│ https://api.openai.com/v1 │
│ 模型: gpt-4o, gpt-4o-mini │
│ │
│ ○ DeepSeek │
│ https://api.deepseek.com │
│ 模型: deepseek-chat, deepseek-reasoner │
│ │
│ ○ 本地 Ollama │
│ http://127.0.0.1:11434/v1 │
│ 模型: qwen2.5:7b │
│ │
│ 选择一个服务商，自动填充配置。 │
│ [取消] [导入] │
└─────────────────────────────────────────────┘
后端
Tauri: 已有 read_openclaw_config 命令
dev-api.js: 已有 read_config handler
// 只需在前端加一个读取+解析+填充的逻辑
优先级：🔴 高（零成本，纯前端，极大提升体验）
工时估算：0.5 天
实施路线图
Phase 1：快速见效（1-2 天）
| 序号 | 功能 | 工时 | 理由 |
|---|---|---|---|
| 1 | 模型配置自动导入 | 0.5d | 读 Agent models.json → 一键填充，纯前端零风险 |
| 2 | 联网搜索工具 | 0.5-1d | DuckDuckGo + Jina，免费无 Key |
| 3 | 灵魂移植（借尸还魂） | 1-2d | 杀手级差异化——读 SOUL/IDENTITY/USER/AGENTS/MEMORY → 变身 |
Phase 2：核心扩展（2-3 天）
| 序号 | 功能 | 工时 | 理由 |
|---|---|---|---|
| 4 | Docker/WSL 工具 | 1-2d | 解决用户最常见的安装困惑 |
| 5 | 自定义知识库 V1 | 1d | 用户上传 md/txt → 注入 prompt |
Phase 3：高级功能（3-5 天）
| 序号 | 功能 | 工时 | 理由 |
|---|---|---|---|
| 6 | SSH 远程管理 | 2-3d | 价值最高但复杂度也最高 |
| 7 | 知识库 V2（语义搜索） | 3-5d | 依赖 embedding API |
设置面板 Tab 规划
当前 3 个 Tab → 扩展为 5 个 Tab：
模型配置 │ 工具权限 │ 知识库 │ 远程连接 │ 助手人设
工具权限 Tab 最终形态
基础工具
☑ 终端工具 — 允许执行 Shell 命令
☑ 文件工具 — 允许读写文件和浏览目录
扩展工具
☐ Docker/WSL — 允许管理容器和 WSL 环境
☐ 联网搜索 — 允许搜索互联网和抓取网页
☐ SSH 远程 — 允许连接远程服务器（需先配置连接）
☐ 知识库 — 允许检索知识库内容
ℹ️ 进程列表、端口检测、系统信息工具始终可用（非聊天模式下）。
技术注意事项
1. Token 预算管理
灵魂移植 + 知识库注入会占用 context window，需要精细管理：
| 组件 | 预算 | 说明 |
|---|---|---|
| ClawPanel 基础 prompt | ~2000 tokens | 产品介绍、工具指南、技能卡片 |
| SOUL.md | ~500 tokens | 人设通常简短 |
| IDENTITY.md | ~200 tokens | 名称/风格 |
| USER.md | ~200 tokens | 用户档案 |
| AGENTS.md | ~3000 tokens | 操作规则（最大，可截断） |
| TOOLS.md | ~300 tokens | 工具笔记 |
| MEMORY.md | ~2000 tokens | 长期记忆（截断保留最近部分） |
| 每日记忆 (3天) | ~1500 tokens | 自动截断 |
| 自定义知识库 | ~4000 tokens | 用户上传文档 |
| 搜索结果 | ~2000 tokens | web_search 返回内容 |
| 总计上限 | ~16000 tokens | 留足空间给对话历史 |
策略：
- AGENTS.md 超过 3000 tokens 时截断尾部，保留前面的核心规则
- MEMORY.md 超过 2000 tokens 时只保留最后 2000 tokens
- 每日记忆超过 500 tokens/天时截断
- 灵魂文件加载时计算总 token 并在 UI 中显示
2. 跨平台兼容
- Docker CLI 在 Windows/Mac/Linux 都可用
- WSL 仅 Windows
- SSH 密钥路径：Windows 用
%USERPROFILE%\.ssh\，Mac/Linux 用~/.ssh/
3. 安全存储
- SSH 密码/API Key：
- Tauri 模式：使用 keytar 或 tauri-plugin-store 加密存储
- Web 模式：仅支持密钥认证（不存储密码）
- 知识库文件：存储在
~/.openclaw/下，与用户数据同目录
4. 工具发现
AI 模型需要知道哪些工具可用。当前已在 buildSystemPrompt() 中列出技能卡片。
新增工具后，需要在系统提示词中补充使用指南（类似现有的 ask_user 指南）。
文件变更预估
| 文件 | 变更 |
|---|---|
src/pages/assistant.js |
TOOL_DEFS 新增 4 类 · executeTool 新增 case · getEnabledTools 新增分支 · 设置面板 UI · 模型导入弹窗 |
src-tauri/src/commands/assistant.rs |
新增 Rust 命令：docker_, wsl_, ssh_*, web_search, fetch_url |
scripts/dev-api.js |
新增 Web 模式 handler：同上 |
src/style/assistant.css |
知识库管理 UI · SSH 连接管理 UI · 导入弹窗样式 |
src/pages/assistant.js (prompt) |
系统提示词新增各工具使用指南 |