安装 Skill 并调用数据

装上数据技能，用自然语言查询与分析

小龙虾本身并不知道平台上有哪些数据、该怎么调用。这一步为它装上平台的「OPD 数据」Skill：装好后，数据接口的鉴权、参数与频控规则都已内置，你无需写代码、无需手拼参数，直接用日常语言描述需求，小龙虾就会自动完成查询。

「OPD 数据」Skill 已发布至技能市场：clawhub.ai/originp-data/skills/opd-data。无需下载任何文件，把下方指令发给小龙虾即可一键安装。

装好之后能做什么

  • 无需手动拼接参数：说人话即可发起查询，如「查一下贵州茅台的公司基本信息」
  • 鉴权与频控自动处理：沿用你的账号密钥，安全又省心
  • 支持接口组合编排：可让 AI 一次完成查询、筛选、统计与分析

安装步骤

安装全程无需输入命令：把下方指令发给小龙虾，搜索、下载、启用、重启都由它自己完成。所有发给小龙虾的话都已单独列出，可直接复制。

  1. 复制下方「指令 1」发给小龙虾，它会自动从技能市场搜索并安装「OPD 数据」Skill
  2. 装好后复制「指令 2」发给小龙虾，让技能生效
  3. 在对话框提问验证，例如「查一下贵州茅台的基本信息」，能返回数据即安装成功

指令 1：安装技能

请安装技能 opd-data

指令 2：重启小龙虾

重启一下
把指令发给小龙虾，它会自动完成技能安装与重启
备选：命令行手动安装（自动安装失败时使用）

若小龙虾未能自动完成安装，可在 PowerShell 中手动执行命令，直接从技能市场（clawhub.ai）安装。技能标识符（slug）为 opd-data，依次执行以下命令：

第一步：从 ClawHub 安装技能

openclaw skills install @originp-data/opd-data

第二步：重启网关，让技能生效

openclaw gateway restart
不确定技能是否存在时，可先执行 openclaw skills search opd-data 搜索确认；执行 openclaw skills list 可查看已安装的技能列表。

配置 API Key（一次性）

Skill 通过本机配置文件读取你的数据访问密钥（形如 opd_xxx）。安装后配置一次即可，全程只需一句话，无需打开任何系统设置：

  1. 在平台复制你的 API Key
  2. 把下方「指令」发给小龙虾（把 opd_xxx 替换成你的实际密钥），它会自动把密钥保存到本机 Skill 配置文件中
  3. 直接提问验证，能正常取数即配置完成（无需重启）

指令：配置数据密钥

配置我的数据密钥：opd_xxx
把配置指令发给小龙虾保存密钥
API Key 属于账号凭证。此方式会把密钥保存到本机 Skill 配置文件（~/.opd/api_key）中用于本地取数，仅保存在你的电脑上，不会上传到任何服务器。请妥善保管密钥，不要截图发到群聊或公开场合。
安装图表 Skill（可选）

默认只安装「OPD 数据」Skill 即可完成数据查询。若希望 AI 将查询结果渲染为图表（K 线、折线、柱状、饼图等交互式 HTML 图表），需额外安装图表 Skill「echarts-ai-skill」。它已发布在技能市场，无需本地下载，依次把下面两条指令发给小龙虾即可：

指令 1：安装图表技能

帮我安装 echarts-ai-skill

指令 2：重启小龙虾

重启一下
若自动安装失败，可在 PowerShell 中手动执行：openclaw skills install echarts-ai-skill，再执行 openclaw gateway restart 重启网关生效。
Skill 调用遵循平台的订阅校验与频控规则；更多 Skill 列表与发布后的安装说明将在平台「Skill」页面陆续上线。

用自然语言查询数据

Skill 装好并配置密钥后，你就真正实现了「零基础」取数：无需写代码，直接在对话框中用日常语言提问，AI 就会帮你查询和分析平台数据。

还没打开管理界面？直接在浏览器访问 127.0.0.1:18789（建议收藏为书签），在对话框中输入你的问题即可；也可以直接在终端对话。

像平时聊天一样，直接说出你想知道的信息即可，例如：

  • “帮我查一下贵州茅台的基本信息”
  • “查查最近上市的 10 家公司”
  • “把刚才查到的结果整理成表格文件，方便我下载”
直接用日常语言提问，AI 自动查询并返回结果

让 AI 帮你分析数据

查到数据后，还可以继续请 AI 帮你梳理和分析，例如：

  • “这些公司都分布在哪些省份？各有多少家，帮我排个序”
  • “这几家公司按成立时间从早到晚排一下”
  • “把结果整理成表格，并告诉我每列代表什么意思”
把需求说清楚（想查什么、想要表格还是文字、需不需要排序），AI 回答得越准确。建议从简单的问题开始，一步步补充条件。
AI 工具会同时用到两把密钥：本站密钥用于取数，大模型密钥用于对话。请确认两把密钥均已妥善配置并保持额度充足。

如何确认 AI 真的调用了平台数据

AI 有时会凭记忆或联网搜索作答，而不是真正查数据。为此，平台提供调用日志：AI 每次通过你的密钥取数，都会在「我的订阅 → 调用统计 → 调用日志」中留下记录。

  • AI 每次真实取数都会留下日志记录，可与回答一一对应
  • 日志里找不到对应接口，说明答案并非来自本站数据，请检查 Skill 与密钥配置
  • 「调用统计」还能按接口汇总取数、按天查看趋势
验证方法：向 AI 提问后，去「我的订阅 → 调用统计 → 调用日志」看看。有对应接口的「成功」记录，就说明 AI 确实实时调用了平台数据。