App Store Skill#

概述#

此 Skill 提供应用商店管理功能，用户可以通过自然语言对话来：

• 搜索应用商店 - "搜索 Redis"、"查找数据库应用"
• 查看应用详情 - "查看 Redis 详情"、"Redis 有什么版本"
• 查看已安装应用 - "我安装了哪些应用"、"列出所有应用"
• 安装应用 - "帮我安装 MySQL"、"安装应用 nginx"
• 卸载应用 - "卸载 MySQL"、"删除应用 wordpress"

配置要求#

首次使用（推荐方式）#

在首次使用时，通过对话设置配置（会自动保存到 Gateway 配置文件，后续对话会自动使用）：

text

用户: 设置 1Panel 配置
       地址：http://your-server:port
       密钥：your-api-key-here
AI: [调用 gateway 配置保存] 配置已保存到 Gateway！
    后续所有对话都会自动使用此配置，无需重复输入。

配置会保存到 openclaw.json 文件中的 skills.entries.appstore-skill.config 路径下。

环境变量（备用方式）#

如果需要通过环境变量配置，可以使用：

变量说明示例ONEPANEL_BASE_URL1Panel 服务器地址http://your-server:port``ONEPANEL_API_KEY1Panel API 认证密钥your-api-key-here``ONEPANEL_TIMEOUT_MS请求超时时间（可选）30000

注：同时也支持 APPSTORE_* 环境变量以保持向后兼容 推荐使用对话配置方式，配置会持久化保存，新对话无需重复输入。

工作流程#

搜索应用#

1. 用户发起搜索请求
2. 调用 searchApps 工具
3. 返回匹配的应用列表（包含名称、描述、是否已安装）

查看应用详情#

1. 用户请求查看应用详情
2. 调用 getAppByKey 获取应用信息
3. 返回应用详情（包含可用版本列表）

安装应用#

1. 用户请求安装应用
2. 调用 getAppByKey 获取应用信息和可用版本
3. 调用 getAppDetailId 获取 appDetailId（安装必需参数）
4. 调用 installApp 执行安装

卸载应用#

1. 用户请求卸载应用
2. 调用 listInstalledApps 获取已安装应用列表
3. 找到目标应用的 installId
4. 调用 uninstallApp 执行卸载

查看已安装应用#

1. 用户请求查看已安装应用
2. 调用 listInstalledApps 工具
3. 返回所有已安装应用的列表

配置示例#

text

用户: 设置 1Panel 配置
       地址：http://your-server:port
       密钥：your-api-key-here
       超时：30秒
AI: [保存配置到 Gateway] 配置已保存到 openclaw.json！
    您的 1Panel 服务器地址和密钥已持久化保存。
    后续对话会自动使用此配置，无需重复输入。

用户: 验证一下配置
AI: [调用 search_apps] 测试连接成功，配置有效。

技术说明#

配置读取优先级：

1. Gateway 配置 ( skills.entries.appstore-skill.config) - 优先级最高
2. 环境变量 ( ONEPANEL_* 或 APPSTORE_*)
3. 参数直接传递

对话示例#

text

用户: 帮我看看安装了哪些应用
AI: [调用 listInstalledApps] 您已安装以下应用：
    - MySQL (ID: 62)
    - WordPress (ID: 63)
    - Hermes Agent (ID: 37)

用户: 搜索一下 Redis
AI: [调用 searchApps] 找到 Redis 应用：
    - Redis: 高性能开源键值数据库
    是否需要查看详情或安装？

用户: Redis 有什么版本？
AI: [调用 getAppByKey] Redis 可用版本：
    - 8.6.2 (最新)
    - 7.4.8
    - 6.2.21

用户: 帮我安装 Redis
AI: [执行安装流程] 正在安装 Redis（版本 8.6.2）...
    安装完成！实例名称: redis

CLI 使用方式#

bash

# 搜索应用
APPSTORE_BASE_URL=http://... APPSTORE_API_KEY=... node dist/cli.js search redis

# 查看应用详情
node dist/cli.js info redis

# 安装应用（默认最新版本）
node dist/cli.js install redis my-redis

# 安装指定版本
node dist/cli.js install redis my-redis 7.4.8

# 列出已安装应用
node dist/cli.js list

# 卸载应用
node dist/cli.js uninstall 67

注意事项#

• 安装应用时，如果不指定版本，默认使用最新版本
• 安装应用时可以指定自定义实例名称，方便区分多个相同应用
• 某些应用可能需要额外的安装参数，会提示用户输入
• 卸载应用需要使用 installId，可以从已安装列表中获取