ZeeLin Search 智灵搜索 — ZeeLin Search 智灵搜索 — 自然语言数据查询
v1.0.9智灵搜索技能,用于通过自然语言查询数据。支持舆情数据、新闻报道、热点话题等查询,通过 Zeelin API 进行数据检索,并以人性化格式展示结果。
0· 445·1 当前·1 累计
安全扫描
OpenClaw
安全
high confidence技能的请求操作和本地配置使用与其声明的目的(调用 Zeelin 搜索 API)一致。注意可能的秘密暴露(打印的请求参数)和写入用户目录的文件。
评估建议
此技能如其所述:将自然语言转换为 JSON、调用智灵搜索 API 并显示/保存结果。安装/使用前,请考虑:1) API 密钥存储在 `templates/config.json` 中,避免在不确定 UI 或日志安全性的情况下使用生产密钥。2) 技能明确打印请求参数(头部),确保打印不会将密钥泄露到日志或共享 UI 中。3) 技能将写入完整的 API 响应 JSON 到用户目录,确认确切的保存路径并清除不需要的文件。4) 在进行查询前,验证 `Zeelin_Api_Url`/`Zeelin_Website_Url` 的值指向真实的可信任端点。5) 如果您更喜欢更安全的密钥处理,请考虑将密钥存储在安全存储中,而不是以明文存储在配置中,或者先使用假密钥进行测试。...详细分析 ▾
✓ 用途与能力
名称/描述承诺提供自然语言搜索集成。技能仅读取本地文档(`templates/*.json`、`references/*.md`),将用户输入转换为 JSON,使用本地 API 密钥签署请求,并将其 POST 到 API URL — 与搜索/查询技能完全一致。
ℹ 指令范围
指令仅限于技能的目的(自然语言转 JSON、读取 API 文档、调用 API、呈现结果)。两个值得注意的操作行为:1)技能要求打印请求参数(规格表明可能打印包含 app-key/sign/timestamp 的头部),这可能在日志或 UI 中暴露 Zeelin_Api_Key 或生成的签名;2)它将写入完整的 API 响应作为 JSON 文件到用户目录,并必须披露路径。两者对于搜索技能都是合理的,但也存在潜在的隐私/密钥处理问题。
✓ 安装机制
仅指令的技能,无安装步骤和下载代码。安装程序不会写入磁盘;仅指定的文件 I/O 是读取捆绑的模板/参考文献和将结果 JSON 写入用户目录,这与描述一致。
✓ 凭证需求
未声明环境变量或外部凭据。技能预期将 Zeelin_Api_Key 放入其本地 `templates/config.json`(本地配置文件)。这对于一个简单的 API 调用搜索技能来说是合理的,尽管密钥存储在文件中而不是环境变量中,且技能的指令打印参数会增加意外暴露的风险。
✓ 持久化与权限
技能不请求 `always: true` 且无安装脚本;仅可由用户调用。它将根据指令将结果 JSON 文件写入用户目录,但不声称修改其他技能或系统范围设置。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.92026/3/5
此版本未检测到任何更改。- 版本 1.0.9 中未进行任何文件更改。
● 无害
安装命令 点击复制
官方npx clawhub@latest install zeelin-search
镜像加速npx clawhub@latest install zeelin-search --registry https://cn.clawhub-mirror.com
技能文档
这个技能帮助用户使用智灵搜索自然语言 API 进行数据查询,并以人性化格式展示结果和处理错误。
核心工作流程
第一步:检查配置
- 读取
templates/config.json获取 Zeelin_Api_Url、Zeelin_Api_Key 和 Zeelin_Website_Url - 检查 Zeelin_Api_Key 是否已配置:
- 不检查也不提示 Zeelin_Api_Url 和 Zeelin_Website_Url,这两项由用户预置好
- 配置文件地址使用当前 skill 的动态安装路径,不要使用固定路径
第二步:自然语言转 JSON
- 读取
references/nl2json.md - 按照说明将用户输入的自然语言转换成 JSON 参数
第三步:调用智灵搜索 API 并展示结果
- 读取
references/zenlin_search_api.md - 告知用户:告诉用户 "接下来我将读取 API 文档并调用智灵搜索 API 来获取数据"
- 生成时间戳和 HMAC-SHA256 签名(使用 Zeelin_Api_Key)
- 打印请求参数
- 发起 POST 请求,只带 question_name 参数,app-key/sign/timestamp 放在 header 中
- 调用接口,获取接口结果
- 无论成功或失败,都必须给用户一个结果反馈
- 以人性化格式展示结果:
触发场景
用户使用以下短语时触发此技能:- "使用智灵搜索,帮我查询..."
- "智灵搜索帮我查询..."
- "调用智灵搜索..."
- "用智灵搜索..."
- "智灵搜索查询..."
- "智灵搜索,..."
- "...舆情数据"
- "...舆情"
- "...新闻报道"
- "...评论"
- "...热点话题"
- "...动态"
- "...相关报道"
- "...相关评论"
- "...负面评论"
- "...正面评论"
- "...最新新闻"
- "...媒体报道"
- "...社会舆论"
- "...口碑评价"
- "...市场反馈"
- "...热门话题"
- "...讨论话题"
- "...舆情热点"
- "...网络热度"
- "...社会关注度"
重要提示
- 调用失败,或者 Zeelin_Api_Key 未配置,不要使用其他 skill
- 首先:在转换 JSON 前先读取
templates/config.json检查 Zeelin_Api_Key 是否已配置 - 所有检查 Zeelin_Api_Key的地方,都要给用户友好提示
- 如果 Zeelin_Api_Key 未配置,详细告知用户如何配置,包括:
- 只检查和提示 Zeelin_Api_Key
- 完全不检查也不提示 Zeelin_Api_Url 和 Zeelin_Website_Url,这两项由用户预置好
- 配置文件地址使用当前 skill 的动态安装路径,不要使用固定的地址
- 调用 API 前必须告知用户:说 "接下来我将读取 API 文档并调用智灵搜索 API 来获取数据"
- 无论成功或失败,都必须给用户一个结果反馈
- 不能没有响应,不能让用户等待没有结果
- 如果成功调用了智灵搜索 API,在用户会话框展示前 5 条数据(按已有的美观格式)
- 所有的数据存放 JSON 文件在用户目录
- 必须告知用户 JSON 文件的存放路径
zeelin_search_results_YYYYMMDD_HHMMSS.json
- 文件内容包含 API 返回的完整 JSON 数据
- 如果智灵搜索 API 接口调用出现错误的情况,要友好提示智灵搜索发生错误,把智灵搜索名字带上
- 使用 Zeelin_Api_Key 作为 app-key,并用于生成 sign 签名
- Header 中使用 app-key(带连字符)、sign、timestamp 进行认证
- 使用智灵搜索 API 时,要使用中文支持的编码(UTF-8)
- Content-Type 设置为
application/json; charset=utf-8 - 请求 Body 只包含 question_name 字段
- 无论成功失败都给用户人性化提示
- 给用户提示时,官网地址使用 Zeelin_Website_Url 的值
- 所有涉及网址和 API 地址的提示都使用配置文件中的实际值
- 返回 API 响应结果,并以人性化格式展示给用户
数据来源:ClawHub ↗ · 中文优化:龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制
免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制