c2a（C2A 搜索）

App Store Skill

概述

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

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

配置要求

首次使用（推荐方式）

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

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

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

环境变量（备用方式）

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

注：同时也支持 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. 返回所有已安装应用的列表

配置示例

用户: 设置 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. 参数直接传递

对话示例

用户: 帮我看看安装了哪些应用
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 使用方式

# 搜索应用
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，可以从已安装列表中获取