告别海外账号！OpenClaw+88api一站式配置：Claude/GPT/Gemini本地调用全流程

jike88ai2026-05-23 19:59

前言

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用终端），输入以下命令：

bash 复制代码 
node -v  # 检查Node.js版本，示例输出：v20.11.0
npm -v   # 检查npm版本，示例输出：10.2.4

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

二、安装OpenClaw并初始化

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

1. 全局安装OpenClaw

在终端执行以下命令：

bash 复制代码 
npm install -g openclaw@latest
2. 执行初始化引导

安装完成后，运行初始化命令：

bash 复制代码 
openclaw onboard

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

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

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

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

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

用文本编辑器打开文件，将models和auth部分替换为以下内容（完整配置如下）：

⚠️ 注意两点：

  • "primary"字段是默认模型，比如想默认用GPT-5.2，改成"primary": "api-proxy-gpt/gpt-5.2"
  • Mac用户需修改"workspace"路径为自己的目录，例如"/Users/你的用户名/clawd"
json 复制代码 
{
  "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

获取Key的步骤：

1.注册并登录后，点击侧边栏"API令牌"。

  1. 点击"添加令牌"

  2. 选择分组

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

4.点击提交

  1. 点击复制按钮复制API令牌，也就是API KEY
2. 找到鉴权文件路径
  • Windows ：C:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.json
  • Mac/Linux ：~/.openclaw/agents/main/agent/auth-profiles.json
3. 填入API Key

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

json 复制代码 
{
  "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）：

bash 复制代码 
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的多模型能力！

相关推荐
独泪了无痕2 小时前
CryptoJS：数据安全的JavaScript加密利器
前端·vue.js·node.js
he___H2 小时前
openclaw使用指南
openclaw
ashen♂6 小时前
OpenClaw Windows本机安装
ai·openclaw
TechMoeTiger6 小时前
Java + Spring实现Hermes Agent之龙虾、Skills、Mcp和沙箱代码执行环境思路
spring ai·openclaw·龙虾·hermes agent·spring ai skills·服务端龙虾·spring ai 沙箱·code interpreter
这是谁的博客？7 小时前
AI 领域精选新闻（2026-05-21）
人工智能·gpt·ai·google·大模型·gemini·新闻
简易API8 小时前
Claude Code 完全体验：jeniya.cn 中转站实战教程
claude
SCKJAI8 小时前
边缘AI新标杆，Pandora Orin NX16+GPT-OSS重新定义终端智能
人工智能·gpt
晓杰'10 小时前
Balatro后端进阶（2）：基于GitHub Actions的CI自动化验证实现
websocket·ci/cd·typescript·node.js·自动化·github·nestjs
天空属于哈夫克310 小时前
3分钟快速接入！实现企业微信外部群主动调用能力
自动化·企业微信·api·rpa
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法04裂开！ChatGPT 居然开始要手机号验证，附详细解决方法05CC-Switch & Claude 基于 Linux 服务器安装使用指南06装上就回不去了：CodeGraph 让 AI 编程效率飙升 92%，它到底做了什么？07【AI】2026 年具身智能模型和世界模型总结08几个好用的ip纯净度检测网站09codex app每次打开重连5次Reconnecting问题解决10用了半年 OpenRouter，我换到了 Ofox.ai — 两个 AI API 聚合平台的真实对比