前言

AI工具配置总让人头大？不是环境报错就是海外账户折腾，教程东拼西凑还总缺关键步骤。作为非科班出身的开发者，我太懂这种对着屏幕干着急的感觉了。

今天这篇文章，咱们一步到位解决OpenClaw的安装和多模型接入问题，全程国内环境可操作，不用翻墙，不用注册一堆海外账号，跟着做就能跑通。

正文

一、准备工作：安装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
npm -v
# 正常输出示例：10.2.4

看到版本号就说明Node.js装好了，接下来安装OpenClaw。

二、安装OpenClaw并初始化

第一步：全局安装OpenClaw

在终端里执行这两条命令，先装工具再初始化：

# 全局安装最新版
npm install -g openclaw@latest

# 执行引导初始化
openclaw onboard

⚠️ 成功后终端会输出版本号和"初始化成功"的提示。如果报command not found，先检查Node.js是否装对，或者npm全局路径有没有加入系统环境变量（Windows用户可以重启终端试试）。

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

初始化完成后，需要修改核心配置文件，路径根据系统不同：

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

用记事本或VS Code打开，把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
          }
        ]
      }
    }
  }
}

⚠️ 注意两个细节：

1. "primary"字段是默认模型，想用GPT-5.2就改成"primary": "api-proxy-gpt/gpt-5.2"；
2. Mac/Linux用户把workspace路径改成自己的目录，比如"/Users/你的用户名/clawd"。

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

1. 获取API Key
本人最近用的是 88API中转站(https://api.88api.shop)，主要是图个方便——国内直连不用翻墙，一个Key能管理多个模型，省得来回切换配置。

大家用自己可用的中转服务也行，只需要把对应的 baseUrl 和 key 对应替换即可。

这里我就以88api为例：

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

打开后填入复制的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的界面了。

3. 测试模型连通性

在对话框里发一句"你好"，如果AI回复了，就说明配置成功。

⚠️ 常见问题：

• 报401 Unauthorized：检查auth-profiles.json里的Key是否填对；
• 报Connection refused：确认Gateway服务是不是还在运行（终端别关）。

总结

整个过程其实不难，核心就是配置文件和API Key这两步别出错。国内用户用中转服务确实能省不少事，不用折腾海外账户和网络。如果启动后模型调用有问题，优先检查openclaw.json里的baseUrl和auth-profiles.json的Key，这俩地方最容易踩坑。有其他问题欢迎评论区交流，祝大家顺利用上OpenClaw！