OpenClaw 接入 AGIPower 使用指南

OpenClaw（原名 Moltbot，最初名为 Clawdbot）是一个强大的 AI 消息网关，可以将多个消息平台（WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等）连接到 AI 模型。通过接入 AGIPower，您可以使用包括 GPT-5.2、Claude-4.5、Gemini-3、DeepSeek 等在内的多种模型。

AGIPower 完全支持 OpenAI API 协议，可以通过简单配置与 OpenClaw 配合使用。注意 OpenAI 协议的 base_url 为 https://api.agipower.ai/v1。

前置条件

Node.js 22 或更高版本
AGIPower API Key（参见下方第 0 步）

接入方式

有两种方式将 AGIPower 与 OpenClaw 配合使用：

方式	适用场景	复杂度
方式一：使用 AGIPower PR	完整的 AGIPower 集成，自动发现模型	简单
方式二：手动配置	稳定版本、自定义设置	中等

第 0 步：获取 AGIPower API Key

在配置 OpenClaw 之前，您需要一个 AGIPower API Key。AGIPower 提供两种计费方式：

订阅 API Key（推荐）

适用场景：个人开发、学习探索
特点：固定月费、成本可预测、5-10 倍价格杠杆
API Key 格式：sk-ss-v1-xxx

获取方式：
1. 访问订阅管理页面：https://agipower.ai/platform/subscription
2. 选择套餐（Pro $20/月、Max $100/月、Ultra $200/月）
3. 订阅后在页面创建订阅 API Key

详细说明请参阅：订阅套餐指南
https://agipower.ai/zh/guide/subscription

按量付费 API Key

适用场景：生产环境、商业产品、企业应用
特点：无速率限制、生产级稳定性、按实际用量计费
API Key 格式：sk-xxx

获取方式：
1. 访问按量付费页面：https://agipower.ai/platform/pay-as-you-go
2. 充值账户（充值自动赠送 20% 额外额度）
3. 在"按量付费 API Keys"区域创建 API Key

详细说明请参阅：按量付费指南
https://agipower.ai/zh/guide/pay-as-you-go

方式一：使用 AGIPower PR

使用 AGIPower 与 OpenClaw 最简单的方式是使用待合并的 AGIPower 集成 PR #3305，它提供了完整的 AGIPower 模型自动发现功能。

第 1 步：克隆并切换到 PR 分支

# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 切换到 PR #3305（AGIPower 集成）
git fetch origin pull/3305/head:agipower-integration
git checkout agipower-integration

# 安装依赖
pnpm install

# 构建项目
pnpm build

第 2 步：使用 AGIPower 运行引导程序

运行引导向导并选择 AGIPower 作为认证提供商：

pnpm openclaw onboard --auth-choice agipower-api-key

按照提示输入您的 AGIPower API Key。向导将自动：

配置 AGIPower 提供商
从 AGIPower API 发现可用模型
为您设置默认模型

第 3 步：验证设置

列出可用模型以验证配置：

pnpm openclaw models list

您应该看到带有 agipower/ 前缀的 AGIPower 模型，例如：

agipower/deepseek/deepseek-chat
agipower/openai/gpt-5.2
agipower/google/gemini-3-pro-preview
agipower/anthropic/claude-sonnet-4.5

第 4 步：测试集成

发送测试消息以验证一切正常：

pnpm openclaw agent --local --agent main --message "你好，请只回复'嗨！'"

方式二：手动配置

如果您希望使用 OpenClaw 的稳定版本或需要更多配置控制，可以在 openclaw.json 配置文件中手动将 AGIPower 配置为显式提供商。

第 1 步：安装 OpenClaw

通过 npm 全局安装 OpenClaw：

npm install -g openclaw@latest

或运行引导向导设置 OpenClaw：

openclaw onboard --install-daemon

第 2 步：配置 AGIPower 提供商

将 AGIPower 提供商配置添加到您的 ~/.openclaw/openclaw.json 文件：

{
  "models": {
    "mode": "merge",
    "providers": {
      "agipower": {
        "baseUrl": "https://api.agipower.ai/v1",
        "apiKey": "sk-ss-v1-your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek/deepseek-chat",
            "name": "DeepSeek Chat",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 64000,
            "maxTokens": 8192
          },
          {
            "id": "openai/gpt-5.2",
            "name": "GPT-5.2",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "google/gemini-3-pro-preview",
            "name": "Gemini 3 Pro",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "agipower/openai/gpt-5.2"
      },
      "models": {
        "agipower/deepseek/deepseek-chat": {},
        "agipower/openai/gpt-5.2": {},
        "agipower/google/gemini-3-pro-preview": {},
        "agipower/anthropic/claude-sonnet-4.5": {}
      }
    }
  }
}

请将 sk-ss-v1-your-api-key-here 替换为您的实际 AGIPower API Key。

第 3 步：添加更多模型（可选）

您可以在 models 数组中添加更多模型。请查看 AGIPower 模型列表了解可用模型及其功能。每个模型定义需要：

字段	说明
`id`	AGIPower 中显示的模型 ID（例如 `openai/gpt-5.2`）
`name`	模型的显示名称
`reasoning`	模型是否支持推理模式
`input`	输入类型：`["text"]` 或 `["text", "image"]`
`cost`	成本配置（订阅套餐设为 0）
`contextWindow`	最大上下文窗口大小（token 数）
`maxTokens`	最大输出 token 数

第 4 步：验证配置

列出可用模型：

openclaw models list

您应该看到已配置的 AGIPower 模型：

Model                                      Input      Ctx      Local Auth  Tags
agipower/deepseek/deepseek-chat              text       63k      no    yes   configured
agipower/openai/gpt-5.2                      text+image 195k     no    yes   default,configured
agipower/google/gemini-3-pro-preview         text+image 195k     no    yes   configured
agipower/anthropic/claude-sonnet-4.5         text+image 195k     no    yes   configured

第 5 步：设置默认模型

设置您偏好的默认模型：

openclaw models set agipower/openai/gpt-5.2

使用 AGIPower 模型

配置完成后，您可以通过多种方式使用 AGIPower 模型：

通过 CLI Agent

# 运行快速 agent 命令
openclaw agent --local --agent main --message "用简单的话解释量子计算"

通过消息通道

配置您的消息通道（WhatsApp、Telegram、Discord 等），网关将自动使用您配置的 AGIPower 模型：

# 启动网关
openclaw gateway run

# 检查通道状态
openclaw channels status

切换模型

您可以随时切换模型：

# 设置不同的默认模型
openclaw models set agipower/anthropic/claude-sonnet-4.5

# 或在命令中指定模型（仅方式一）
openclaw agent --local --agent main --model agipower/deepseek/deepseek-chat --message "你好"

故障排除

常见问题

API Key 错误或认证失败

问题：出现 API Key 无效或未授权的错误 解决方案：

检查 API Key 格式：
- 订阅 API Key 应以 sk-ss-v1- 开头
- 按量付费 API Key 应以 sk- 开头
- 确保没有多余的空格或换行符
验证 API Key：
- 订阅：访问订阅管理页面检查订阅状态和配额
- 按量付费：访问按量付费页面确保余额充足
检查配置文件语法：
- 确保 JSON 格式正确（无尾随逗号、正确引号）
- 验证 API Key 正确放置在 apiKey 字段中

模型未找到

问题：OpenClaw 报告找不到模型 解决方案：

方式一（PR 分支）：
- 确保您在 agipower-integration 分支上（从 PR #3305 检出）
- 拉取最新更改后运行 pnpm build
方式二（手动配置）：
- 验证模型已在 models.providers.agipower.models 中定义
- 检查模型 ID 是否完全匹配（区分大小写）
- 同时将模型添加到 agents.defaults.models

连接失败

问题：OpenClaw 无法连接到 AGIPower 解决方案：

检查网络连接是否正常
验证 baseUrl 设置为 https://api.agipower.ai/v1
确保防火墙没有阻止出站 HTTPS 连接
尝试运行 curl https://api.agipower.ai/v1/models 测试连通性

显示缓存的旧模型

问题：配置更改后仍显示旧模型 解决方案：

终止运行中的网关进程：
```
pkill -9 -f openclaw-gateway
```
重新构建项目（如果使用方式一）：
```
pnpm build
```
再次列出模型：
```
openclaw models list
```

支持的模型

AGIPower 提供多种模型供选择。以下是 OpenClaw 的一些热门选项：

模型	ID	最佳用途
GPT-5.2	`openai/gpt-5.2`	通用、编码
Claude Sonnet 4.5	`anthropic/claude-sonnet-4.5`	平衡性能
Claude Opus 4.5	`anthropic/claude-opus-4.5`	复杂推理
Gemini 3 Pro	`google/gemini-3-pro-preview`	多模态任务
DeepSeek Chat	`deepseek/deepseek-chat`	高性价比编码
Qwen3 Coder	`alibaba/qwen3-coder-plus`	代码生成

完整的支持模型列表，请访问 AGIPower 模型列表。

联系我们

如果您在使用过程中遇到任何问题，或有建议和反馈，请通过以下渠道联系我们：

官方网站：https://agipower.ai
技术支持邮箱：support@agipower.ai

更多联系方式和详情，请访问我们的联系我们页面。

关于 AGIPower

API 参考

最佳实践

帮助中心

Openclaw

OpenClaw 接入 AGIPower 使用指南

前置条件

接入方式

第 0 步：获取 AGIPower API Key

方式一：使用 AGIPower PR

第 1 步：克隆并切换到 PR 分支

第 2 步：使用 AGIPower 运行引导程序

第 3 步：验证设置

第 4 步：测试集成

方式二：手动配置

第 1 步：安装 OpenClaw

第 2 步：配置 AGIPower 提供商

第 3 步：添加更多模型（可选）

第 4 步：验证配置

第 5 步：设置默认模型

使用 AGIPower 模型

通过 CLI Agent

通过消息通道

切换模型

故障排除

常见问题

API Key 错误或认证失败

模型未找到

连接失败

显示缓存的旧模型

支持的模型

联系我们

关于 AGIPower

API 参考

最佳实践

帮助中心

Documentation Index

​OpenClaw 接入 AGIPower 使用指南

​前置条件

​接入方式

​第 0 步：获取 AGIPower API Key

​方式一：使用 AGIPower PR

​第 1 步：克隆并切换到 PR 分支

​第 2 步：使用 AGIPower 运行引导程序

​第 3 步：验证设置

​第 4 步：测试集成

​方式二：手动配置

​第 1 步：安装 OpenClaw

​第 2 步：配置 AGIPower 提供商

​第 3 步：添加更多模型（可选）

​第 4 步：验证配置

​第 5 步：设置默认模型

​使用 AGIPower 模型

​通过 CLI Agent

​通过消息通道

​切换模型

​故障排除

​常见问题

​API Key 错误或认证失败

​模型未找到

​连接失败

​显示缓存的旧模型

​支持的模型

​联系我们

OpenClaw 接入 AGIPower 使用指南

前置条件

接入方式

第 0 步：获取 AGIPower API Key

方式一：使用 AGIPower PR

第 1 步：克隆并切换到 PR 分支

第 2 步：使用 AGIPower 运行引导程序

第 3 步：验证设置

第 4 步：测试集成

方式二：手动配置

第 1 步：安装 OpenClaw

第 2 步：配置 AGIPower 提供商

第 3 步：添加更多模型（可选）

第 4 步：验证配置

第 5 步：设置默认模型

使用 AGIPower 模型

通过 CLI Agent

通过消息通道

切换模型

故障排除

常见问题

API Key 错误或认证失败

模型未找到

连接失败

显示缓存的旧模型

支持的模型

联系我们