OpenClaw配置总卡壳？国内直连Claude/GPT保姆级教程（附88api完整配置，2026亲测）

本文提供了OpenClaw工具的完整安装与配置指南，从Node.js环境搭建到多模型API对接的全流程说明。重点包括：1）Node.js 20.x LTS版本的安装验证；2）OpenClaw的全局安装与初始化；3）配置文件openclaw.json的详细修改方法，支持GPT-5.2、Claude Sonnet 4.5、Gemini 3 Pro和Deepseek v3.2等多模型切换；4）通过88a

m0_53581755

537人浏览 · 2026-05-12 10:49:35

m0_53581755 · 2026-05-12 10:49:35 发布

前言

整理了这篇实操文，从Node.js安装到88api接口对接，一步步带你跑通OpenClaw，重点解决国内环境下多模型调用的配置麻烦。亲测可用，跟着做基本能少走90%弯路。

正文

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

OpenClaw依赖Node.js环境，先确保本地已安装Node.js 18+（推荐20.x LTS版）。

1. 下载安装Node.js

官网地址：https://nodejs.org，选择LTS版本（如20.x），双击安装时全部默认下一步即可。

2. 验证安装

打开终端（Windows用PowerShell/CMD，Mac/Linux用终端），输入以下命令检查版本：

node -v
# 输出示例：v20.11.0（需18+）
npm -v
# 输出示例：10.2.4

如果提示command not found，检查Node.js是否安装成功，或npm全局路径是否加入系统环境变量。

二、安装OpenClaw并初始化

Node.js就绪后，开始安装OpenClaw并搭建基础框架。

1. 全局安装OpenClaw

终端执行以下命令：

npm install -g openclaw@latest

2. 初始化配置

安装完成后，运行引导命令生成基础配置：

openclaw onboard

成功后终端会输出版本号和“初始化成功”提示。若报错command not found，回到第一步检查Node.js安装。

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

初始化后需配置模型列表和接口信息，找到配置文件路径：

Windows：C:\Users\你的用户名\.openclaw\openclaw.json
Mac/Linux：~/.openclaw/openclaw.json

用文本编辑器打开，将models和auth部分替换为以下内容（保留其他默认配置）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929" // 默认模型，可改为其他模型ID
      },
      "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", // Mac用户改为"/Users/你的用户名/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中转地址
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.2", "name": "GPT-5.2", "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", "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", "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", "contextWindow": 2000000, "maxTokens": 8192 }]
      }
    }
  }
}

注意：

primary字段决定默认模型，如想默认用GPT-5.2，改为"primary": "api-proxy-gpt/gpt-5.2"。
Mac/Linux用户需修改workspace路径为自己的实际目录（如"/Users/xxx/clawd"）。

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

接下来需要填入API密钥，实现模型调用权限验证。

1. 获取API Key

我这里使用88api作为接口（官网：https://api.88api.shop），主要是为了省去海外账号注册和翻墙步骤，国内直连且支持多模型统一管理。

大家用自己也可以，没有的可以试试88api，获取key步骤：
获取Key的步骤：

注册并登录后，点击侧边栏“API令牌”。
点击“添加令牌”
选择分组
1. 根据需要调用的模型选择分组
  a. claude 模型建议使用 calude code 分组、
  b. gpt 模型建议使用 codex分组
2. 可通过平台的模型广场查看不同模型支持的分组
3. 若在使用中出现上游分组饱和，请切换分组使用
点击提交
5. 点击复制按钮复制API令牌，也就是API KEY

2. 填写鉴权文件

找到鉴权文件路径：

Windows：C:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.json
Mac/Linux：~/.openclaw/agents/main/agent/auth-profiles.json

打开文件，将复制的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
    }
  }
}