OpenClaw 使用 Ace Data Cloud 教程

OpenClaw 是一个多渠道 AI 网关与可扩展插件运行时，支持以插件方式接入第三方模型与工具。@acedatacloud/openclaw-provider 是官方的 OpenClaw 插件，把 Ace Data Cloud 上的 50+ 大语言模型以及 Google 网页搜索接入到 OpenClaw 中，使用一个 API Key 即可调用。

本文介绍如何在 OpenClaw 中安装、配置并使用 Ace Data Cloud 插件。

申请流程

要使用本插件，首先可以到 Ace Data Cloud 控制台，或者识别下方二维码：

然后获取您的 API Token，留作备用。

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验本插件提供的服务。

安装 OpenClaw

如果尚未安装 OpenClaw，可以通过 npm 全局安装：

npm install -g openclaw

安装完成后检查命令是否可用：

openclaw --version

要求 Node.js 20 或更高版本。

安装 Ace Data Cloud 插件

OpenClaw 通过插件机制接入第三方模型。安装 @acedatacloud/openclaw-provider：

openclaw plugins install npm:@acedatacloud/openclaw-provider

安装完成后，OpenClaw 会自动注册一个 acedatacloud 渠道，可以承载 Chat（对话）与 Web Search（网页搜索）两种能力。

配置 API Token

有三种方式配置 API Token：

方式一：环境变量（推荐）

把以下内容写入 ~/.zshrc、~/.bashrc 或 ~/.bash_profile：

export ACEDATA_API_KEY="{token}"

其中 {token} 替换为您在 Ace Data Cloud 控制台复制的 API Token。也可以使用别名环境变量 ACEDATACLOUD_API_KEY，两者等价。

配置后重新打开终端，或执行：

source ~/.zshrc

方式二：交互式 onboarding

运行：

openclaw onboard --auth-choice acedatacloud-api-key

OpenClaw 会提示输入 API Token，并自动写入用户配置文件。

方式三：命令行参数

也可以在调用时直接通过 --acedata-api-key <key> 参数传入。

使用 Chat 能力

配置完成后，即可在 OpenClaw 中调用 Ace Data Cloud 提供的 LLM。模型 ID 形式为 acedatacloud/<model-name>。

一次性调用（one-shot） —— 用 openclaw infer model run 跑单轮对话：

openclaw infer model run --model acedatacloud/gpt-4.1-mini --prompt "用一句话解释什么是 OpenClaw"

openclaw infer model run --model acedatacloud/claude-opus-4-8 --prompt "解释 OpenClaw 插件机制"

设为默认模型 —— 之后交互式 / Agent 运行都会默认使用它：

openclaw config set agents.defaults.model.primary 'acedatacloud/claude-opus-4-8'

交互式终端 UI —— 直接进入本地对话界面：

openclaw chat

单次 Agent 任务 —— 让本地 Agent 跑一轮（需当前 shell 已设置 API Token）：

openclaw agent --local --model acedatacloud/claude-opus-4-8 -m "用一句话解释什么是 OpenClaw"

默认模型列表

插件内置了 62 个常用模型的目录，覆盖以下家族（按目录排序）：

完整列表请参考插件仓库的 src/chat/generated-catalog.ts，该文件由 pnpm sync-catalog 自动从 PlatformBackend/cost/api/_chat_models.json 生成。

动态模型 ID

不在内置目录中的模型 ID 也可直接传入 —— 插件会通过 resolveDynamicModel 把任意 acedatacloud/<id> 请求按 OpenAI 兼容方式转发到 https://api.acedata.cloud/v1：

openclaw infer model run --model acedatacloud/gpt-5.5 --prompt "测试新模型"

只要 id 在 Ace Data Cloud 后端可用（参考 /v1/models），调用就会成功。

使用 Web Search 能力

插件同时注册了一个网页搜索 provider，使用 Ace Data Cloud 的 Google SERP 接口。OpenClaw 会在 Agent 工作流中自动调用，也可用 openclaw infer web search 显式调用：

openclaw infer web search --provider acedatacloud --query "最新的 AI Agent 框架" --limit 5

命令行可用参数为 --provider、--query、--limit、--json。底层的 Google SERP 接口还支持 search（网页，默认）、images、news、videos、maps、places 等搜索类型，OpenClaw 在 Agent 工作流中会按需选用。

计费说明

插件本身不会重复计费 —— 所有用量都在 Ace Data Cloud 平台侧按 Credits 计算（按模型与请求大小定价）。Chat 与 Web Search 共用同一个 API Token，调用记录可在 platform.acedata.cloud/console/usages 查看。

为了避免 OpenClaw 客户端做重复估算，插件向 OpenClaw 报告 cost: 0。

手动配置

如果希望直接编辑配置文件，可在 ~/.openclaw/openclaw.json 中写入 API Token、默认模型并启用插件：

{  env: { ACEDATA_API_KEY: "ace-..." },  agents: {    defaults: {      model: { primary: "acedatacloud/claude-opus-4-8" },    },  },  plugins: {    entries: {      acedatacloud: { enabled: true },    },  },}

也可以配置 fallback 链，主模型不可用时自动降级到其他模型：

{  agents: {    defaults: {      model: {        primary: "acedatacloud/claude-opus-4-8",        fallbacks: ["acedatacloud/gpt-5.2-pro", "acedatacloud/gemini-3.1-pro"],      },    },  },}

故障排查

更多调试日志可通过全局参数 --log-level debug 打开，例如 openclaw --log-level debug infer model run --model acedatacloud/gpt-4o-mini --prompt "test"。

相关链接

• 插件仓库：AceDataCloud/OpenClawProvider
• npm 包：@acedatacloud/openclaw-provider
• OpenClaw 官网：openclaw.ai
• Ace Data Cloud 控制台：platform.acedata.cloud