当前位置：首页 > news >正文

告别海外账号！OpenClaw+88api一站式配置：多模型本地管理，小白也能照着做

news 2026/5/21 20:04:08

前言

最近AI工具更新太快，很多朋友想试试OpenClaw这类本地代理工具，但总卡在环境配置上——不是Node.js版本不对，就是模型接口连不通，尤其国内用户还得折腾海外账号和网络。其实关键是缺一篇能从头到尾走通的实操文。

我花了两天整理出这份教程，从Node.js安装到88api接口配置，每步都附了实际操作截图和配置代码。用88api做中转是个省心选择，国内直连不用翻墙，一个Key就能接GPT、Claude等多个模型，本地切换模型只改一行配置。如果你也想少踩坑，跟着做应该能一次跑通。

正文

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

OpenClaw依赖Node.js环境，先确保本地已安装Node.js 18+。

如果没装，去官网 https://nodejs.org 下载LTS版（推荐20.x LTS），双击安装时一路点Next（默认配置就行）。

安装完成后，打开终端（Windows用PowerShell/CMD，Mac/Linux用Terminal），输入以下命令验证：

node-v# 输出示例：v20.11.0（版本18+即可）npm-v# 输出示例：10.2.4（npm版本会随Node.js一起安装）

二、安装OpenClaw并初始化

第一步：安装OpenClaw

Node.js没问题的话，终端执行以下两条命令：

全局安装OpenClaw：

npminstall-gopenclaw@latest

执行引导初始化：

openclaw onboard

⚠️ 成功后终端会输出版本号和“初始化成功”提示。如果报command not found，检查Node.js是否装对，或npm全局路径是否在系统PATH里（可重启终端再试）。

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

第二步：修改主配置文件`openclaw.json`

配置文件位置：

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

用记事本或VS Code打开，把models和auth部分替换为以下代码（直接覆盖原内容）：

⚠️ 注意两个关键配置：
"primary"字段是默认模型，想默认用GPT-5.2就改成"primary": "api-proxy-gpt/gpt-5.2"；
Mac用户把"workspace": "C:\\Users\\admin\\clawd"改成自己的目录，比如"/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}]}}}}

保存文件，这步是核心配置，决定了OpenClaw能调用哪些模型。

第三步：配置鉴权文件`auth-profiles.json`

1. 获取API Key

这里用88api（https://api.88api.shop）作为模型接口中转（你也可以用其他中转服务，替换对应baseUrl和Key即可）。它的好处是国内直连不用翻墙，一个Key能接多个主流模型，省掉注册多个海外账号的麻烦。

下面以88 API 为例：
获取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

打开文件，把从88api获取的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"// 替换成你的Google分组Key},"api-proxy-deepseek:default":{"type":"api_key","provider":"api-proxy-deepseek","key":"sk-your-unique-deepseek-key-here"// 替换成你的Deepseek分组Key}}}