AceDataCloud API 指南

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install api-guide
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 api-guide。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AceDataCloud API 指南将带你完成从账户和 API 密钥设置到成功发送第一个请求的全过程，并为 OpenClaw Gateway 配置提供实用指导。它会说明 ClawHub 登录凭据与 AceDataCloud 服务 API 密钥之间的区别，帮助你在通过 Openclaw Skills 使用 AceDataCloud 服务之前配置正确的访问权限。
请将本通用指南与计划调用的具体服务 Skill 配合使用：该 Skill 会提供端点、模型、请求字段和任务详情。本指南还介绍安全的密钥处理方式、计费注意事项、异步任务轮询以及常见 API 错误。

应用场景

首次从 OpenClaw 调用 AceDataCloud 服务之前。
使用 ClawHub CLI 安装
@acedatacloud/suno
@acedatacloud/google-search
等服务 Skill 时。
创建或选择 API 密钥，以及检查服务使用权限、余额、定价或允许的路由时。
在 OpenClaw Gateway 主机上配置 API 令牌，或在终端中测试令牌时。
请求返回身份验证、访问、验证、速率限制、超时或服务器错误时。
生成请求返回
task_id
，需要检查任务状态且不想重复提交可能产生费用的任务时。

工作原理

如有需要，先安装 ClawHub CLI，然后安装适用于所需工作流程的 AceDataCloud 服务 Skill。确认发布者为 @acedatacloud。
登录 AceDataCloud Applications 控制台。选择或初始化一个应用，检查服务访问权限和定价，然后复制现有 API 密钥或创建受限密钥。
确保密钥限制允许所有必需的 API 路由。对于异步工作流程，请同时包含提交路由和任务查询路由。
将密钥作为 ACEDATACLOUD_API_TOKEN 存储在 OpenClaw Gateway 环境中，或在终端中导出该变量以进行直接测试。请妥善保密密钥，不要在存储的值前添加 Bearer 。
按照服务 Skill 中记录的请求格式操作。向正确的端点发送第一个请求，并附上必需的授权标头和 JSON 请求体。
对于异步任务，请保存返回的 task_id，并查询对应的任务端点，直到任务进入终止状态。不要仅为查看进度而再次提交生成任务。
根据响应和本指南中的状态码检查来诊断错误。必要时查看账户用量，并向支持团队提供任务 ID 或跟踪 ID——绝不要分享 API 密钥。

配置指南

安装 ClawHub 和相关服务 Skill：
npm install -g clawhub
clawhub install @acedatacloud/suno
clawhub list
将 @acedatacloud/suno 替换为适用于你工作流程的服务 Skill，例如 @acedatacloud/google-search，并确认发布者为 @acedatacloud。
在 AceDataCloud Applications 控制台 https://platform.acedata.cloud/console/applications 中创建或复制服务 API 密钥。检查服务使用权限、余额、当前价格、到期时间、限制和 Allowed APIs。platform-... 管理令牌不是服务 API 密钥。
在 OpenClaw Gateway 主机上，将密钥添加到 ~/ .openclaw/ .env：
ACEDATACLOUD_API_TOKEN=your_api_key_here
限制文件权限并重启 Gateway，然后启动新会话：
chmod 600 ~/ .openclaw/ .env
如需直接在终端中测试，请改为导出该变量：
export ACEDATACLOUD_API_TOKEN="your_api_key_here"
发送第一个 Google Search 请求。请先检查当前定价；请求可能会产生费用。密钥必须允许 /serp/google：
curl -X POST https://api.acedata.cloud/serp/google \ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"query":"AceDataCloud","type":"search"}' 对于图像、视频或音乐生成，请使用所选服务 Skill 的 Quick Start，并遵循其中的端点和请求架构。
AceDataCloud API 指南 数据架构与分类体系
本指南不定义本地数据库，也不会生成项目数据文件。其配置和工作流程使用以下信息：
项目 位置或格式 用途
Skill 元数据 SKILL.md 中的 YAML front matter 将 Skill 标识为 api-guide，描述其用途，并记录许可证、作者、版本和兼容性要求。
API 凭据 ~/ .openclaw/ .env 中的 ACEDATACLOUD_API_TOKEN，或终端环境变量 授权服务 API 请求。请对该值保密；将 Bearer 方案放在 HTTP Authorization 标头中，而不是存储在令牌里。
请求数据 发送到服务端点的 JSON 请求体 包含特定服务的字段，例如 Google Search 示例中的 query 和 type。确切架构请参阅相关服务 Skill。
异步任务引用 提交请求时返回的 task_id 用于通过对应的 /tasks 端点轮询原始任务。请保留并重复使用该 ID，而不要为了检查状态重新提交任务。
API 路由权限 密钥的 Allowed APIs 配置 限制密钥可调用的路由；异步工作流程可能需要同时开放提交路由和任务查询路由。
诊断参考信息 响应详情、任务 ID 或跟踪 ID 有助于调查故障。可以向支持团队提供任务 ID 或跟踪 ID，但绝不要提供 API 密钥。

高级特性

支持通过
~/ .openclaw/ .env
持久配置 OpenClaw Gateway，也支持通过导出的环境变量直接在终端中测试。
说明通用应用密钥、特定服务密钥和账户管理令牌之间的区别。
涵盖密钥到期时间、限制和 Allowed APIs，便于将访问权限限制为工作流程所需的路由。
提供异步任务生命周期指导：保留原始
task_id
、轮询对应端点，并避免重复提交可能产生费用的任务。
在服务支持的情况下，建议设置
callback_url
时使用自己拥有的真实公共 webhook。
提供状态码故障排除清单，涵盖 400、401、403、429、待处理任务、超时和 5xx 响应。
可作为特定服务 Openclaw Skills 的入门辅助指南；这些 Skills 会提供确切的模型、请求字段和端点。

name: api-guide description: Set up an AceDataCloud API key, make a first request, and troubleshoot authentication, access, billing, and asynchronous tasks. Use before calling an AceDataCloud service for the first time. license: Apache-2.0