📦 Perplexity — 困惑度
v1.0.0通过 OpenRouter 在 CLI 中使用 Sonar:本地 OpenRouter Sonar 网页搜索 CLI,使用用户的 OpenRouter API 密钥。当你需要由 OpenRouter 支持的网页搜索或本地引文研究时使用。
0· 5·0 当前·0 累计
下载技能包
最后更新
2026/4/21
安全扫描
OpenClaw
可疑
high confidence代码和 SKILL.md 实现了一个基于本地 OpenRouter 的 Sonar CLI,功能如描述所示,但注册元数据缺少必需的 OPENROUTER_API_KEY(存在明显不一致),且包需从外部仓库安装/运行脚本——安装前请验证。
评估建议
该包确实如其所言:一个本地 CLI,通过你的 OPENROUTER_API_KEY 调用 openrouter.ai。安装前:(1) 验证你克隆的仓库/来源(该包在注册表中无主页);(2) 注意 README 要求运行仓库里的 Bun 脚本——务必先自行检查脚本内容再赋予可执行权限;(3) 只有信任代码时才设置 OPENROUTER_API_KEY,建议使用受限 API key 或专用账户;(4) 注册表元数据遗漏了必需的环境变量——视为红旗,优先进行源码验证;(5) 如有疑虑,在隔离环境(容器/虚拟机)中运行,并检查网络流量确认其仅与 openrouter.ai 通信。...详细分析 ▾
ℹ 用途与能力
技能名称/描述与附带的 README、SKILL.md 以及 Bun CLI 脚本一致:它实现了一个本地化的 sonar CLI,调用 OpenRouter 端点并映射 Perplexity Sonar 模型。然而,声明的注册元数据未列出必需的 OPENROUTER_API_KEY,尽管 SKILL.md 和脚本都需要该密钥——这一元数据遗漏存在不一致。
✓ 指令范围
运行时指令与 CLI 代码仅限于向 openrouter.ai 构建 chat-completion 请求、列出模型,以及可选地写入用户请求的输出文件。SKILL.md 不会引导代理读取无关文件或其他凭据。唯一引用的环境变量是 OPENROUTER_API_KEY(必需)以及几个可选的 OPENROUTER_* 变量,这些变量均与所述功能相符。
✓ 安装机制
技能注册表中没有打包的安装规范;README 建议克隆 GitHub 仓库,并将 TypeScript/Bun 脚本软链接到 ~/.local/bin。这是一种常见的轻量级安装方式;它需要 Bun 运行时并从外部仓库运行脚本,这符合预期,但也存在本地执行第三方脚本所带来的常规信任/运行时风险。
⚠ 凭证需求
代码确实只需一个 API 凭证(OPENROUTER_API_KEY),并可选择性地使用 model/referrer/title 环境变量。然而,注册元数据声称“所需环境变量:无”,而 SKILL.md 和脚本均指出 OPENROUTER_API_KEY 为必填。此不一致可能导致意外泄露或配置错误,使用前应予修正。
✓ 持久化与权限
该技能并非始终启用,不会请求系统级配置更改,也不会修改其他技能。它以本地 CLI 形式按需运行,不请求提升权限或持久权限。
⚠ scripts/openrouter-sonar.ts:19
环境变量访问结合网络发送
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/21
OpenRouter Sonar CLI 技能初始发布。 - 为基于 OpenRouter 的网页搜索与引用研究提供本地 `sonar` 命令行界面。 - 支持多种 Sonar 模型及便捷的短模型名。 - 附带列出模型、研究查询及以多种格式(`text`、`md`、`json`)保存输出的工具。 - 使用用户的 `OPENROUTER_API_KEY` 及可选环境变量进行配置。 - 通过 CLI 选项提供文件输出与模型选择功能。
● 无害
安装命令
点击复制官方npx clawhub@latest install openclaw-sonar
镜像加速npx clawhub@latest install openclaw-sonar --registry https://cn.longxiaskill.com
技能文档
本技能提供由 OpenRouter Sonar 模型驱动的本地 sonar CLI,并启用网页搜索功能。
命令
搜索
``bash
sonar "latest OpenRouter Sonar features"
sonar "best document AI underwriting startups" --model sonar-pro
sonar "credit underwriting agents" --model sonar-reasoning-pro
sonar "latest underwriting automation startups" --format md --output notes.md
sonar "OpenRouter Sonar pricing" --format json --output sonar.json
` 默认模型:
sonar
支持的短模型名:
- sonar
sonar-prosonar-pro-searchsonar-reasoningsonar-reasoning-prosonar-deep-research
内部映射为:
- perplexity/sonar
perplexity/sonar-properplexity/sonar-pro-searchperplexity/sonar-reasoningperplexity/sonar-reasoning-properplexity/sonar-deep-research
模型
`bash
sonar models
` 快捷方式
`bash
sonar pro "latest OpenRouter Sonar features"
sonar pro-search "best cited search workflow for agents"
sonar deep "compare OpenRouter Sonar vs Tavily for research"
sonar reason "reason through the strongest arguments for and against RAG here"
sonar reason-pro "compare three underwriting architectures and justify the best one"
` 研究
`bash
sonar research "Compare Tavily, Exa, and Sonar for cited research workflows"
sonar research "Latest UK AI policy changes" --format md --output policy.md
` research 默认模型:
- sonar-deep-research
输出
使用 --output 写入文件,--format 指定格式。
支持格式:
texttxtmdjson
环境
必需:
OPENROUTER_API_KEY
可选:
- OPENROUTER_SONAR_MODEL
(使用短名,如sonar或sonar-pro) OPENROUTER_REFEREROPENROUTER_TITLE
说明
- 本工具为本地 CLI,非 MCP。
- 使用启用网页搜索的 OpenRouter chat completions。
优先使用短模型名,完整perplexity/...` 名仍可用。