前言

这篇文章整理了我自己亲测有效的完整流程，从Node.js安装到OpenClaw配置，再到API接口对接，每个步骤都标了关键注意点。不用海外账号，国内环境就能直接跑，适合想省时间少踩坑的朋友。

正文

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

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

如果还没安装，访问Node.js官网：https://nodejs.org，推荐下载LTS版（建议20.x LTS），双击安装时全部默认Next即可。

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

node -v
# 输出示例：v20.11.0（版本号可能因安装版本不同略有差异）
npm -v
# 输出示例：10.2.4（同上）

看到版本号输出，说明Node.js已安装就绪，可以开始下一步。

二、安装OpenClaw并初始化

第一步：安装OpenClaw

确保Node.js安装成功后，在终端执行以下命令：

全局安装OpenClaw：

npm install -g openclaw@latest

执行引导初始化：

openclaw onboard

⚠️ 初始化完成后，终端会输出版本号和成功提示。如果出现command not found错误，先检查Node.js是否正确安装，或确认npm全局路径是否已添加到系统PATH中。

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

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

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

• Windows：C:\Users\你的用户名\.openclaw\openclaw.json（将“你的用户名”替换为实际系统用户名）
• Mac / Linux：~/.openclaw/openclaw.json

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

⚠️ 注意"primary"字段决定默认使用的模型，例如想默认用GPT-5.2，可改为"primary": "api-proxy-gpt/gpt-5.2"；Mac用户需将workspace路径改为自己的实际目录，如"/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
          }
        ]
      }
    }
  }
}

配置文件修改完成后，保存并关闭，接下来需要配置API鉴权信息。

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

1. 获取API Key

这里需要用到API接口服务，我选择88API作为中转（官网：https://api.88api.shop），主要是为了省去海外账号注册和翻墙麻烦，可调用多个主流模型，且一个Key可统一管理，切换模型只需改配置。

当然你也可以用其他中转服务，只需对应修改baseUrl和key即可。

获取88API Key的步骤：
1.注册并登录后，点击侧边栏“API令牌”。

2. 点击“添加令牌”

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

4.点击提交

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

{
  "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 --port 18789

启动成功后，终端会输出类似Gateway running on http://127.0.0.1:18789的信息，说明服务已正常运行。

2. 访问控制台

打开浏览器，访问http://127.0.0.1:18789/，即可看到OpenClaw的Web控制台界面。

3. 测试连通性

在控制台的对话框中输入简单问题（例如“你是谁？”），如果能收到AI的正常回复，说明配置成功，模型已通过88API接口接入。

⚠️ 常见问题排查：

• 若提示401 Unauthorized，检查auth-profiles.json中的Key是否填写正确；
• 若提示Connection refused，确认Gateway服务是否已启动（终端是否显示“Gateway running”）。

总结

到这里，OpenClaw的安装和88API配置就全部完成了。整个过程最关键的是配置文件的路径和API Key的填写，只要注意这两点，基本能一次跑通。

这篇教程从Node.js准备到最终验证，覆盖了所有必要步骤，特别适合不想在环境配置上浪费时间的朋友。如果遇到其他问题，欢迎在评论区留言交流，我会尽量回复。