前言

最近想尝试OpenClaw这类AI工具的朋友不少，但很多人卡在环境配置上——要么Node.js版本不对，要么海外API调用麻烦，要么教程碎片化。

作为过来人，我整理了这篇亲测可行的完整步骤，从安装Node.js到配置88API中转，一步步带你跑通，国内用户也能轻松接入Claude、GPT等主流模型，不用折腾翻墙和海外账号。

正文

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

开始前请确认本地已安装Node.js 18+，推荐20.x LTS版本：

1. 官网下载：https://nodejs.org
2. 双击安装，全部默认Next即可
3. 验证安装：打开终端（Windows用PowerShell/CMD）执行

node -v  # 示例输出：v20.11.0
npm -v   # 示例输出：10.2.4

二、安装OpenClaw并初始化

1. 全局安装OpenClaw

执行以下命令：

npm install -g openclaw@latest

2. 引导初始化

openclaw onboard

⚠️ 执行后终端会输出版本号和初始化成功提示。若报command not found，检查Node.js是否安装正确，或npm全局路径是否在系统PATH中。

三、修改主配置文件openclaw.json

1. 找到配置文件路径

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

2. 替换配置内容

将文件中的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
          }
        ]
      }
    }
  }
}

四、配置鉴权文件auth-profiles.json

1. 获取API Key

这里使用88API中转服务（网址：https://api.88api.shop），国内直连无需翻墙，一个Key可接入多模型：

1.注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写，没有含义，直接点击提交即可。

4. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

5. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
   

2. 填写鉴权文件

找到文件路径：

• Windows：C:\Users\你的用户名\.openclaw\agents\main\agent\auth-profiles.json
• Mac/Linux：~/.openclaw/agents/main/agent/auth-profiles.json

将API Key填入对应位置：

⚠️ 若仅使用Claude，只需填写api-proxy-claude:default项即可。

{
  "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. 验证连通性

• 浏览器访问http://127.0.0.1:18789/，打开OpenClaw Web界面
• 发送测试消息（如“你是谁”），若AI正常回复则配置成功

⚠️ 常见问题：

• 401 Unauthorized：检查auth-profiles.json中的Key是否正确
• Connection refused：确认Gateway服务是否在运行

总结

这篇教程从Node.js安装到OpenClaw配置，再到API中转接入，覆盖了完整的实操流程。通过88API中转，国内用户无需翻墙即可快速接入多模型，避免了海外账号的繁琐步骤。只要跟着步骤操作，小白也能轻松搭建自己的AI工具环境。如果遇到问题，欢迎在评论区留言交流，我会尽力帮大家解决。