跳转到主要内容
吉祥物是一只小龙虾（lobster），名字里的「Claw」来自此。 OpenClaw 的核心交互界面是用户已经在使用的即时通讯平台——把 AI 助手以聊天机器人的形态嵌入 WhatsApp、Telegram、Slack、Discord、飞书、钉钉、企业微信、iMessage、LINE 等 20+ IM，作为一个 7×24 小时在线的私人助理存在。

​
安装

安装前请确保 Node>=22
执行安装指令 
npm install -g openclaw@latest

​
终端配置

打开终端，运行以下指令开始配置 
openclaw onboard
选择 Yes Oc 1 选择 QuickStart Oc 2 选择 Skip for now Oc 3 选择 All providers Oc 4 根据需求选择默认模型，可以先选择 Keep current（如使用「方法二：手动修改配置文件」，下一步会在配置文件中修改） Oc 5 根据需求关联个人账户，如无相关需求请选择 Skip for now Oc 6 配置技能，选择 Yes Oc 7 选择 npm Oc 8 根据需求配置技能选择 Oc 9 全部选择 No Oc 10 选择 Skip for now Oc 11 选择 Hatch in UI

​
配置 AIHubMix

​
方法一：使用插件快速配置（推荐）

插件开源地址：aihubmix-auth
安装 AIHubMix 认证插件并重启 Gateway： 
openclaw plugins install @akakenle/aihubmix-auth
openclaw gateway restart
执行认证指令，按提示输入你的 AIHubMix API Key。下面这条命令对四个 provider 任选其一执行一次即可——插件通过 providerAuthAliases 让同一把 key 同时生效到全部 transport： 
openclaw models auth login --provider aihubmix-openai --method api-key --set-default
插件会将模型自动归类为以下分组：
  • aihubmix-openai — gpt-* / o1-* / o3-* / o4-*，https://aihubmix.com/v1（openai-completions）
  • aihubmix-anthropic — claude-*，https://aihubmix.com（anthropic-messages）
  • aihubmix-google — gemini-*，https://aihubmix.com/gemini/v1beta（google-generative-ai）
  • aihubmix-other — 其他模型，https://aihubmix.com/v1（openai-completions）
简写 id（如 claude-sonnet-4-5）会由插件的 resolveDynamicModel hook 自动路由到对应 transport，不需要写完整 provider/model。
不想走交互式登录：先 export AIHUBMIX_API_KEY=sk-... 再 install，插件会把 key 作为 inline apiKey 写入 provider 配置（交互式登录则由 SDK 存入 auth-profile）。
配置完成后，跳转到启动步骤即可开始使用。

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

打开 ~/.openclaw/openclaw.json 文件，增加以下配置： 
{
  "models": {
    "mode": "merge",
    "providers": {
      "aihubmix-openai": {
        "baseUrl": "https://aihubmix.com/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "gpt-4o",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      },
      "aihubmix-anthropic": {
        "baseUrl": "https://aihubmix.com",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-5",
            "name": "claude-sonnet-4-5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      },
      "aihubmix-google": {
        "baseUrl": "https://aihubmix.com/gemini/v1beta",
        "api": "google-generative-ai",
        "models": []
      },
      "aihubmix-other": {
        "baseUrl": "https://aihubmix.com/v1",
        "api": "openai-completions",
        "models": []
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aihubmix-anthropic/claude-sonnet-4-5"
      },
      "workspace": "your_workspace_path",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

​
启动

openclaw gateway

​
测试

在聊天页面输入 hello，如收到回复则说明配置成功。 Oc 12

​
常见问题

​
版本升级

openclaw plugins update @akakenle/aihubmix-auth
openclaw gateway restart

​
Gateway 进程被占用

openclaw gateway stop
openclaw gateway

​
相关资源

更新时间：2026-06-01