前言

AI工具越来越强大,但国内配置环境时总遇到账号注册、网络连接、教程碎片化的问题。尤其是像OpenClaw这类需要对接多个AI模型的工具,配起来更是头大——不是Node.js版本不对,就是配置文件改乱了,或者调用时提示"401 Unauthorized"。

这篇文章整理了我自己实操通过的完整流程,从Node.js安装到OpenClaw初始化,再到88api接口配置,一步步带你跑通。不用海外账号,不用复杂网络设置,一个Key就能调用Claude、GPT、Gemini等主流模型,尽量让你少踩坑。

正文

一、准备工作:安装Node.js

OpenClaw依赖Node.js环境,先确保本地安装了Node.js 18+(推荐20.x LTS版)。

1. 下载安装Node.js
  • 官网地址:https://nodejs.org
  • 选择"LTS"版本(比如20.x),下载后双击安装,全程"Next"默认配置即可。
2. 验证安装是否成功

打开终端(Windows用PowerShell/CMD,Mac/Linux用终端),输入以下命令:

node -v  # 检查Node.js版本,示例输出:v20.11.0
npm -v   # 检查npm版本,示例输出:10.2.4

如果能正常输出版本号,说明Node.js安装成功。

二、安装OpenClaw并初始化

Node.js准备好后,开始安装OpenClaw并搭建基础框架。

1. 全局安装OpenClaw

在终端执行以下命令:

npm install -g openclaw@latest
2. 执行初始化引导

安装完成后,运行初始化命令:

openclaw onboard

⚠️ 成功后终端会输出版本号和"初始化成功"提示。如果提示command not found,检查Node.js是否安装正确,或npm全局路径是否添加到系统环境变量(PATH)。

到这一步,OpenClaw的基础框架就搭好了,接下来配置模型接口。

三、修改主配置文件:openclaw.json

OpenClaw的核心配置在openclaw.json文件中,需要修改模型和鉴权相关设置。

1. 找到配置文件路径
  • WindowsC:\Users\你的用户名\.openclaw\openclaw.json
  • Mac/Linux~/.openclaw/openclaw.json
2. 替换配置内容

用文本编辑器打开文件,将modelsauth部分替换为以下内容(完整配置如下):

⚠️ 注意两点:

  • "primary"字段是默认模型,比如想默认用GPT-5.2,改成"primary": "api-proxy-gpt/gpt-5.2"
  • Mac用户需修改"workspace"路径为自己的目录,例如"/Users/你的用户名/clawd"
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      },
      "models": {
        "api-proxy-gpt/gpt-5.2": {
          "alias": "GPT-5.2"
        },
        "api-proxy-claude/claude-sonnet-4-5-20250929": {
          "alias": "Claude Sonnet 4.5"
        },
        "api-proxy-google/gemini-3-pro-preview": {
          "alias": "Gemini 3 Pro"
        },
        "api-proxy-deepseek/deepseek-v3.2": {
          "alias": "Deepseek v3.2"
        }
      },
      "workspace": "C:\\Users\\admin\\clawd",
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": {
        "provider": "api-proxy-gpt",
        "mode": "api_key"
      },
      "api-proxy-claude:default": {
        "provider": "api-proxy-claude",
        "mode": "api_key"
      },
      "api-proxy-google:default": {
        "provider": "api-proxy-google",
        "mode": "api_key"
      },
      "api-proxy-deepseek:default": {
        "provider": "api-proxy-deepseek",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.88api.shop/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.88api.shop",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.88api.shop/v1",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-preview",
            "name": "Gemini 3 Pro",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 2000000,
            "maxTokens": 8192
          }
        ]
      },
      "api-proxy-deepseek": {
        "baseUrl": "https://api.88api.shop/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v3.2",
            "name": "Deepseek v3.2",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 2000000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

四、配置鉴权文件:auth-profiles.json

配置文件改好后,需要填入API Key才能调用模型。这里以88api为例(国内直连,一个Key支持多模型,减少环境配置麻烦)。 推荐大家试试,或者大家用自己的api也可以。

1. 获取88api的API Key
  • 访问88api官网:https://api.88api.shop

获取Key的步骤:

1.注册并登录后,点击侧边栏“API令牌”。
在这里插入图片描述
2. 点击“添加令牌”
在这里插入图片描述

  1. 选择分组
    1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
    2. 可通过平台的模型广场查看不同模型支持的分组
    3. 若在使用中出现上游分组饱和,请切换分组使用
      在这里插入图片描述

4.点击提交
在这里插入图片描述
5. 点击复制按钮复制API令牌,也就是API KEY
在这里插入图片描述

2. 找到鉴权文件路径
  • WindowsC:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.json
  • Mac/Linux~/.openclaw/agents/main/agent/auth-profiles.json
3. 填入API Key

用文本编辑器打开文件,将复制的Key填入对应模型的"key"字段:

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-your-unique-gpt-key-here"  // 替换为你的GPT Key
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-your-unique-claude-key-here"  // 替换为你的Claude Key
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-your-unique-google-key-here"  // 替换为你的Gemini Key
    },
    "api-proxy-deepseek:default": {
      "type": "api_key",
      "provider": "api-proxy-deepseek",
      "key": "sk-your-unique-deepseek-key-here"  // 替换为你的Deepseek Key
    }
  }
}

⚠️ 如果只需要调用某个模型(比如Claude),只需填对应模型的Key,其他留空即可。

五、启动并验证OpenClaw

所有配置完成后,启动服务并测试是否能正常调用模型。

1. 启动Gateway服务

在终端执行以下命令(端口可自定义,这里用18789):

openclaw gateway --port 18789

成功启动后,终端会显示Gateway running on http://127.0.0.1:18789

2. 访问Web控制台

打开浏览器,访问http://127.0.0.1:18789/,会看到OpenClaw的Web界面。

3. 测试模型调用

在对话框中输入问题(例如"你是谁"),如果AI能正常回复,说明配置成功。

⚠️ 常见问题排查:

  • 提示401 Unauthorized:检查auth-profiles.json中的Key是否正确。
  • 提示Connection refused:确认Gateway服务是否在运行(终端不要关闭)。

总结

OpenClaw配置看似复杂,但按步骤走其实不难:先搭好Node.js环境,安装初始化OpenClaw,改好配置文件和鉴权文件,最后启动服务验证。核心是通过88api这类中转服务简化国内调用,避免海外账号和网络问题。

如果按教程操作遇到问题,先检查Node.js版本、配置文件路径、API Key是否填对。有其他疑问欢迎留言,我会尽量回复。希望这篇教程能帮你少走弯路,快速用上OpenClaw的多模型能力!

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐