国内环境也能轻松用！OpenClaw从安装到多AI模型调用完整教程（附88api配置，亲测跑通）
本文介绍了OpenClaw工具的国内用户配置指南，主要包含三个步骤：1)安装Node.js 18+环境；2)全局安装OpenClaw并初始化；3)配置模型接口和鉴权信息。文章特别针对国内用户优化，使用88api中转服务简化流程，无需海外账号和翻墙，即可对接Claude、GPT、Gemini等主流AI模型。配置过程详细说明了如何修改openclaw.json主配置文件和auth-profiles.j
前言
最近在配置OpenClaw这个工具时，但翻了一圈教程，要么是默认海外环境，要么步骤零散，光配置模型接口就卡了半天。作为非技术背景的人，最怕照着做还报错——毕竟海外账户注册、支付、翻墙这些环节，对国内用户来说实在太折腾了。
所以特意整理了这篇从0到1的实操文，包含Node.js环境准备、OpenClaw安装、88api接口配置的完整步骤。亲测国内网络可直接跑通，不用海外账号，一个API Key就能对接Claude、GPT、Gemini等主流模型。如果你也想少踩坑快速上手，跟着一步步做应该能省不少事。
正文
一、准备工作：安装Node.js
OpenClaw依赖Node.js环境，先确认本地是否已安装Node.js 18+。如果没有，按以下步骤操作：
- 访问Node.js官网：https://nodejs.org
- 推荐下载LTS版（建议20.x LTS），双击安装包后一路"Next"（默认配置即可）。
安装完成后，打开终端（Windows用PowerShell或CMD，Mac/Linux用终端），输入以下命令验证是否安装成功：
node -v
# 输出示例：v20.11.0（版本号需18+）
npm -v
# 输出示例：10.2.4（npm会随Node.js一起安装）
二、安装OpenClaw并初始化
第一步：安装OpenClaw
确保Node.js安装完成后，在终端执行以下命令：
全局安装OpenClaw：
npm install -g openclaw@latest
执行引导初始化：
openclaw onboard
⚠️ 初始化成功后，终端会输出版本号和成功提示。如果出现
command not found，检查Node.js是否安装正确，或npm全局路径是否添加到系统PATH中。
第二步：修改主配置文件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"
},
"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
}
]
}
}
}
}
⚠️ 配置说明：
"primary"字段决定默认模型，比如想默认用GPT-5.2，改为"primary": "api-proxy-gpt/gpt-5.2"- Mac用户需修改
workspace路径为自己的目录，例如"/Users/你的用户名/clawd"
第三步：配置鉴权文件auth-profiles.json
这一步需要填入API Key才能调用模型，我最近使用的是88api作为中转服务（https://api.88api.shop），主要是为了避免海外账户注册和翻墙问题，减少配置麻烦。
大家也可以用自己的中转站。
这里以88api为例：
1. 获取API Key：
1）注册好账号后，点击侧边栏的 API 令牌
2）点击添加令牌
3）选择分组
a. 根据需要调用的模型选择分组
a）claude 模型建议使用 calude code 分组、
b）gpt 模型建议使用 codex分组
b. 可通过平台的模型广场查看不同模型支持的分组
c. 若在使用中出现上游分组饱和，请切换分组使用
4）点击提交
5）点击复制按钮复制API令牌
2. 找到鉴权文件位置：
- Windows：
C:\\Users\\你的用户名\\.openclaw\\agents\\main\\agent\\auth-profiles.json - Mac/Linux：
~/.openclaw/agents/main/agent/auth-profiles.json
3. 填入API Key：
用文本编辑器打开文件，将复制的令牌填入对应模型的"key"字段（只用某个模型的话，其他可留空）：
{
"version": 1,
"profiles": {
"api-proxy-gpt:default": {
"type": "api_key",
"provider": "api-proxy-gpt",
"key": "sk-your-unique-gpt-key-here"
},
"api-proxy-claude:default": {
"type": "api_key",
"provider": "api-proxy-claude",
"key": "sk-your-unique-claude-key-here"
},
"api-proxy-google:default": {
"type": "api_key",
"provider": "api-proxy-google",
"key": "sk-your-unique-google-key-here"
},
"api-proxy-deepseek:default": {
"type": "api_key",
"provider": "api-proxy-deepseek",
"key": "sk-your-unique-deepseek-key-here"
}
}
}
三、启动并验证
1. 启动Gateway服务
在终端执行以下命令启动服务：
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服务是否在运行（终端窗口未关闭）
总结
这篇教程从Node.js环境准备到OpenClaw安装、配置文件修改，再到启动验证，覆盖了国内用户上手OpenClaw的全流程。核心解决了海外账户、翻墙、多模型配置繁琐的问题，通过88api中转实现国内直连，一个Key搞定主流模型调用。
如果操作中遇到配置文件路径找不到、Key验证失败等问题，欢迎在评论区留言，我会尽量回复。技术工具配置难免踩坑，希望这篇文章能帮你少走弯路，快速用上OpenClaw~
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
9
0- 0
已为社区贡献19条内容
所有评论(0)