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

别再到处拼教程了！OpenClaw+88api一站式配置指南（手把手教你改配置、填Key、验连通）

news 2026/6/10 17:14:13

前言

最近想上手OpenClaw却被环境配置劝退？不少朋友反馈，要么是Node.js版本不对，要么是配置文件改半天还是连不上模型，尤其国内环境下找靠谱的API接入方案更是头疼。

其实核心问题就两个：一是步骤不完整，二是API对接太绕。这篇文章我会把自己从安装到成功调用Claude/GPT的全过程拆解开，每个配置文件怎么改、Key怎么填、启动后怎么验证，都尽量写清楚，希望能帮你少踩点坑。

正文

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

开始前必须确保本地已安装Node.js 18+，这是OpenClaw运行的基础环境。

如果还没安装，直接访问Node.js官网：https://nodejs.org，推荐下载LTS版（建议20.x LTS），双击安装时一路默认"Next"即可，无需额外配置。

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

node-v# 输出示例：v20.11.0（版本号需≥18.0.0）npm-v# 输出示例：10.2.4（npm会随Node.js自动安装）

如果能正常输出版本号，说明Node.js环境没问题，可以进入下一步。

二、安装OpenClaw并初始化

第一步：安装OpenClaw

确认Node.js就绪后，在终端执行以下命令全局安装OpenClaw：

npminstall-gopenclaw@latest

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

openclaw onboard

⚠️ 执行成功后，终端会输出版本号和"初始化成功"的提示。如果出现command not found错误，先检查Node.js是否安装正确，或尝试重启终端（npm全局路径可能未及时加载）。

这一步会帮我们搭建好OpenClaw的基础框架，接下来需要配置模型和API信息。

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

OpenClaw的核心配置文件需要手动修改，路径根据系统不同：

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"（Windows用户保持默认路径即可）。

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

这一步需要填入API Key才能调用模型，我这里使用88API作为中转服务（官网：https://api.88api.shop），主要是为了省去海外账号注册和翻墙的麻烦，国内直连即可，且一个Key能管理多个模型，配置起来更方便。

推荐大家可以试试，或者大家也可以用自己的。

1. 获取API Key（以88api为例）

获取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填入对应位置：

{"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，其他留空即可。

第四步：启动并验证

1. 启动Gateway服务

在终端执行以下命令启动OpenClaw服务：

openclaw gateway--port18789

启动成功后，终端会显示Gateway running on http://127.0.0.1:18789，说明服务已正常运行（不要关闭终端，否则服务会停止）。

2. 访问Web控制台

打开浏览器，输入http://127.0.0.1:18789/，即可看到OpenClaw的Web操作界面。

3. 验证模型连通性

在Web界面的对话框中输入简单问题（例如"你是谁"），如果能收到AI回复，说明配置成功。
⚠️ 常见问题排查：

若提示401 Unauthorized：检查auth-profiles.json中的Key是否填错或过期；
若提示Connection refused：确认Gateway服务是否在运行（终端是否保持打开状态）。

总结

到这里，OpenClaw的安装和88api配置就完成了。核心步骤其实就四个：装Node.js、装OpenClaw、改配置文件、填Key启动。最容易卡壳的地方是配置文件路径和Key的填写，只要按步骤核对路径、替换占位符，基本都能跑通。如果过程中遇到其他问题，欢迎在评论区留言，我会尽量回复。希望这篇教程能帮你少走点弯路，顺利用上OpenClaw~

查看全文

http://www.zskr.cn/news/1406378.html