Skip to main content

​
概述

OpenClaw 是一个开源的 AI Agent 网关，用于将聊天应用桥接到 AI 编程 Agent。它支持多种 AI 模型提供商和 API 格式，让你可以通过统一的网关连接 Claude Code、Cursor 等 AI 编程工具。 本指南将引导你从零开始手动安装 OpenClaw 并将其连接到 AihubMax。
如果你希望更快速地完成安装，可以参考 OpenClaw 一键安装 指南。

​
前置条件

AihubMax API Key

一个有效的 AihubMax API Key。

Node.js

Node.js >= 22.12.0。

npm

npm（随 Node.js 一同安装）。

Git

已安装 Git。

​
安装与配置

1

安装 OpenClaw

通过 npm 全局安装 OpenClaw：
2

验证安装

确认 OpenClaw 已正确安装：
3

运行初始化

运行 onboarding 命令以初始化 OpenClaw 并安装后台守护进程：
该命令会创建配置目录和默认配置文件。
4

配置模型提供商

编辑主配置文件，添加 AihubMax 作为模型提供商。
在 models.providers 部分，添加以下三个提供商配置块（分别对应不同的 API 格式）：
请将所有三个提供商配置块中的 sk-your-foxapi-api-key 替换为你的实际 AihubMax API Key。
5

配置默认 Agent 模型

编辑 Agent 模型配置文件以设置默认模型：
在 agents 字段中设置主模型：
格式为 <提供商名称>/<模型ID>。

​
验证连接

  1. 切换到指定模型以确认其可用：
  2. 启动与 Agent 的对话，测试连接是否正常。
  3. 如果能正常收到响应，说明 AihubMax 集成已成功。

​
切换模型

你可以随时使用以下命令切换当前活跃模型：
示例：

​
常见问题

  • 确认 Node.js 版本 >= 22.12.0：node --version
  • 重新安装 OpenClaw：npm install -g openclaw@latest
  • 检查 npm 全局 bin 目录是否在系统 PATH 中。
  • 检查 openclaw.json 中的 apiKey 和 baseUrl 是否正确。
  • 确认各 API 格式对应的 Base URL：
    • Anthropic：https://api.aihubmax.com
    • Google：https://api.aihubmax.com/v1beta
    • OpenAI：https://api.aihubmax.com/v1
  • 使用 curl 测试 API Key 是否有效：
  • 确认提供商名称和模型 ID 与 openclaw.json 中定义的完全一致。
  • 格式必须为 <提供商>/<模型ID>，例如 foxapi-anthropic/claude-opus-4-6。
  • 重新运行初始化命令：openclaw onboard --install-daemon
  • 检查系统日志获取守护进程错误信息。