OpenClaw

OpenClaw 可通过 Gateway 将 AI 助手接入聊天界面。本指南以 OpenClaw 2026.10.5 为例，说明如何安装并使用 AIHubMix 模型。

安装

OpenClaw 需要 Node.js 24.16+（仅 24.x）或 26.1+；Node.js 25 不受支持。推荐 Node.js 26。官方安装脚本会在需要时安装兼容的 Node.js，并自动启动初次设置。 macOS、Linux 或 WSL2：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

已自行管理 Node.js 的用户也可通过 npm 安装。npm 12 或 11.16+ 使用：

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard

npm 11.15 及更早版本安装时去掉 --allow-scripts=openclaw。安装脚本已启动初次设置时，无需再次运行 openclaw onboard。

初次设置

新安装时，在 openclaw onboard 中阅读安全提示，选择 Quick start，创建 One agent。到模型连接选择界面时，选择 Skip for now。此时 OpenClaw 会准备工作区和本地 Gateway 配置，然后退出；AI 连接和 Gateway 尚未启动。接着选择下方一种 AIHubMix 配置方法。

AIHubMix 不在内置厂商列表中。若希望直接在向导内配置，可选择 More… → Custom Provider，填写 https://aihubmix.com/v1、AIHubMix API Key、OpenAI-compatible 和可用的模型 ID。向导会先发送真实请求验证，成功后才保存连接并启动前台 Gateway。

配置 AIHubMix

方法一：使用插件

aihubmix-auth 是第三方插件。安装时核对 npm 来源及权限提示，再确认信任和能力授权。以下步骤适用于 Gateway 尚未启动的初次设置。

openclaw plugins install @akaknele/aihubmix-auth
openclaw plugins list

安装成功后，运行认证命令并按提示输入 AIHubMix API Key。输入的密钥无需写进命令或文档。请在 Gateway 停止时运行带 --set-default 的命令。

openclaw models auth login --provider aihubmix-openai --method api-key --set-default

插件提供 aihubmix-openai、aihubmix-anthropic、aihubmix-google 和 aihubmix-other 四组模型。认证一次后可在这些分组中选择账号可用的模型。以下以 gpt-6-sol 为例：

openclaw models set aihubmix-openai/gpt-6-sol
openclaw models status

例如，要使用其他 OpenAI 兼容模型，可按实际模型 ID 切换：

openclaw models set aihubmix-other/glm-5.3

模型是否可用以 AIHubMix 模型页面及账号权限为准。

方法二：手动修改配置文件

不安装插件时，可在 ~/.openclaw/openclaw.json 中添加自定义 provider。先将 AIHUBMIX_API_KEY 设置在运行 Gateway 的进程环境中。以下配置只展示本指南所需字段；已有配置请合并对应对象，不要覆盖其他设置。 macOS、Linux 或 WSL2，在之后运行 Gateway 的同一终端中设置环境变量。将示例占位符替换为自己的密钥：

export AIHUBMIX_API_KEY="sk-***"

Windows PowerShell：

$env:AIHUBMIX_API_KEY = "sk-***"

这些命令仅对当前终端会话生效。重新打开终端后，需要重新设置。

{
  "models": {
    "mode": "merge",
    "providers": {
      "aihubmix-openai": {
        "baseUrl": "https://aihubmix.com/v1",
        "apiKey": "${AIHUBMIX_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-6-sol",
            "name": "gpt-6-sol",
            "input": ["text", "image"],
            "contextWindow": 1050000,
            "maxTokens": 128000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aihubmix-openai/gpt-6-sol"
      }
    }
  }
}

示例中的模型上下文和输出上限以 gpt-6-sol 模型页面为准。若使用后台 Gateway 服务，需确保服务进程也能读取 AIHUBMIX_API_KEY；当前终端中的环境变量不会自动传给已安装的系统服务。可参考 OpenClaw 密钥管理配置服务使用的密钥。

测试与启动

配置后，可先用实际密钥测试一次模型请求。返回模型回复说明连接可用：

openclaw infer model run --local --json --model aihubmix-openai/gpt-6-sol --prompt "Reply with OK."

在前台启动 Gateway，并在另一个终端打开控制台：

openclaw gateway

openclaw dashboard

openclaw gateway 会持续占用当前终端；在该终端按 Ctrl+C 可停止。希望改为后台服务时，停止前台进程后运行 openclaw gateway install。

常见问题

找不到 openclaw 命令

确认安装完成，并检查全局 npm 安装目录是否在 PATH 中：

npm prefix -g

Windows 用户将输出目录加入系统 PATH；macOS 和 Linux 用户可参考 OpenClaw Node.js 安装说明。

升级插件或 OpenClaw

更新插件前先停止 Gateway。前台运行时按 Ctrl+C；已安装后台服务时运行 openclaw gateway stop。随后执行：

openclaw plugins update aihubmix-auth

如果使用后台服务，运行 openclaw gateway start；如果使用前台模式，运行 openclaw gateway。升级 OpenClaw 本体可运行 openclaw update，手动启动的前台 Gateway 需要自行重启。

Gateway 端口被占用

先停止已有的前台 Gateway 或使用 openclaw gateway stop 停止后台服务，再启动需要的实例。服务未安装时，openclaw gateway start 不会创建服务。

编程助手

IDE 集成

Agent / Workflow 平台

SDK 与框架

安装

初次设置

配置 AIHubMix

方法一：使用插件

方法二：手动修改配置文件

测试与启动

常见问题

找不到 openclaw 命令

升级插件或 OpenClaw

Gateway 端口被占用

相关资源

​安装

​初次设置

​配置 AIHubMix

​方法一：使用插件

​方法二：手动修改配置文件

​测试与启动

​常见问题

​找不到 openclaw 命令

​升级插件或 OpenClaw

​Gateway 端口被占用

​相关资源

安装

初次设置

配置 AIHubMix

方法一：使用插件

方法二：手动修改配置文件

测试与启动

常见问题

找不到 openclaw 命令

升级插件或 OpenClaw

Gateway 端口被占用

相关资源