首页 / 技能 / Freesound

📦 Freesound

v0.1.0

在本地 Windows OpenClaw 工作区配置并使用 Freesound API，支持 OAuth 登录、本地凭据存储及声音搜索辅助工具。用于...

4· 4·0 当前·0 累计
by @stanestane (Stanislav Stankovic)
生产力工具办公协作API开发网络工具浏览器自动化
下载技能包
最后更新
2026/4/20
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
该技能的代码、指令及请求的本地存储均与其声明用途（本地 Freesound OAuth、搜索与下载辅助）一致；未发现请求无关权限或外部数据外泄。
评估建议
该技能功能完整，为 Freesound 实现了本地 OAuth 及搜索/下载助手。使用前请：（1）自行检查已打包的脚本，并在隔离的 Python 环境中运行；（2）注意凭据以明文保存在 %APPDATA%/OpenClaw/freesound-api/credentials.json——切勿提交该文件或将密钥粘贴到聊天中；（3）OAuth 流程会启动本地服务器并打开浏览器完成登录（属正常现象）；（4）确认将保存的 client_secret 作为 API ‘token’ 使用，与你在 Freesound 应用中的配置一致；（5）一旦密钥泄露，立即轮换。...
详细分析 ▾
✓ 用途与能力
名称/描述（Freesound API helpers：OAuth、本地凭据存储、搜索、下载）与所含脚本（setup_credentials、oauth_login、search_sounds、download_sound、sound_details 及 helpers）一致。无需无关二进制文件或环境变量。
ℹ 指令范围
SKILL.md 指导运行附带的 Python 脚本、启动本地回调服务器、打开浏览器，并将凭据保存到 %APPDATA%，完全符合本地 OAuth 流程。它仅引用凭据文件和本地脚本。 注意：代码将 client_secret 和令牌以明文形式保存在 %APPDATA%\credentials.json，这是预期行为，但值得留意。 此外，api_utils 在没有 OAuth 令牌时会回退使用已保存的 client_secret 作为 API 的 'token' 参数；请确认这符合你的 Freesound 应用预期（某些 API 会提供独立的 API key）。
✓ 安装机制
无安装规范；仅为指令说明，附带打包的 Python 脚本。唯一声明的依赖是 requests 库，SKILL.md 提示如缺失请自行安装。技能本身不执行远程下载或解压操作。
ℹ 凭证需求
该技能在安装时无需环境变量或外部凭据。它会读取 APPDATA（用于计算本地存储路径），并将 client_id/client_secret 及 OAuth 令牌写入 %APPDATA%/OpenClaw/freesound-api/credentials.json。明文本地存储密钥是预期行为，但若设备共享或备份同步则存在常规风险——如泄露请轮换密钥。
✓ 持久化与权限
始终为 false，该 skill 不会请求持久化的平台级权限。它仅创建并使用自己的应用目录和凭证文件；不会修改其他 skill 或系统级 agent 配置。
安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv0.1.02026/4/20

首次公开发布：localhost OAuth 配置、搜索筛选器、音效详情、原始下载与预览下载。

● 无害

安装命令

点击复制
官方npx clawhub@latest install freesound-api
镜像加速npx clawhub@latest install freesound-api --registry https://cn.longxiaskill.com

技能文档

仅限本地使用，切勿在技能内公开 Freesound client secret。

本地存储

本技能将凭据保存在：
  • %APPDATA%\OpenClaw\freesound-api\credentials.json
请将密钥存放于此，而非 SKILL.md。

配置凭据

本地保存应用凭据： ``powershell python scripts\setup_credentials.py --client-id '' --client-secret '' --redirect-uri 'http://localhost:8787/callback' ` redirect URI 必须与 Freesound 注册时保持一致。

完成 OAuth 登录

运行： `powershell python scripts\oauth_login.py ` 流程：
  • 在端口 8787 启动临时 localhost 回调服务器
  • 浏览器打开 Freesound 授权页
  • 在 http://localhost:8787/callback 接收授权码
  • 换取 access token
  • 将 token 存回 %APPDATA%\OpenClaw\freesound-api\credentials.json
若浏览器未自动打开，请手动复制打印的 URL。

搜索声音

运行： `powershell python scripts\search_sounds.py "rain" --page-size 10 ` 带过滤示例： `powershell python scripts\search_sounds.py "rain" --license cc0 --duration-min 5 --duration-max 60 python scripts\search_sounds.py "thunder" --tag storm --tag ambience python scripts\search_sounds.py "wind" --filter "samplerate:[44100 TO *]" ` 搜索辅助优先使用 OAuth bearer token；若无 token，则回退以保存的 Freesound secret 作为 token 参数发起简单 API 调用。

获取声音详情

运行： `powershell python scripts\sound_details.py 322965 ` 可查看元数据、预览、评分、标签、格式信息及声音直链下载地址。

下载声音

运行： `powershell python scripts\download_sound.py 322965 --out-dir downloads ` 下载预览而非原文件： `powershell python scripts\download_sound.py 322965 --preview hq-mp3 --out-dir previews ` 使用当前 OAuth token 或保存的 API key，将原文件或所选预览存入指定目录。

公开发布安全须知

若公开发布本技能，仅发布技能文件夹与脚本，切勿包含 %APPDATA%\OpenClaw\freesound-api\credentials.json 或任何 client secret。

注意事项

  • redirect URI 必须保持一致，否则 token 交换失败。
  • 优先使用 OAuth 登录以获取用户级权限。
  • 若密钥被粘贴到聊天，视为已泄露，测试后请立即轮换。
  • 若本地缺少 requests`，请在 Python 环境中先行安装。
数据来源：ClawHub ↗ · 中文优化：龙虾技能库