告别海外账号！OpenClaw+88api一站式配置：多模型本地管理，小白也能照着做

wdbw

375人浏览 · 2026-05-21 14:13:36

wdbw · 2026-05-21 14:13:36 发布

前言

最近AI工具更新太快，很多朋友想试试OpenClaw这类本地代理工具，但总卡在环境配置上——不是Node.js版本不对，就是模型接口连不通，尤其国内用户还得折腾海外账号和网络。其实关键是缺一篇能从头到尾走通的实操文。

我花了两天整理出这份教程，从Node.js安装到88api接口配置，每步都附了实际操作截图和配置代码。用88api做中转是个省心选择，国内直连不用翻墙，一个Key就能接GPT、Claude等多个模型，本地切换模型只改一行配置。如果你也想少踩坑，跟着做应该能一次跑通。

正文

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

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

如果没装，去官网 https://nodejs.org 下载LTS版（推荐20.x LTS），双击安装时一路点Next（默认配置就行）。

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

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的基础框架就搭好了，接下来配置模型接口。

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

配置文件位置：

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

用记事本或VS Code打开，把models和auth部分替换为以下代码（直接覆盖原内容）：

⚠️ 注意两个关键配置：

"primary"字段是默认模型，想默认用GPT-5.2就改成"primary": "api-proxy-gpt/gpt-5.2"；

Mac用户把"workspace": "C:\\Users\\admin\\clawd"改成自己的目录，比如"/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
          }
        ]
      }
    }
  }
}

保存文件，这步是核心配置，决定了OpenClaw能调用哪些模型。

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

1. 获取API Key

这里用88api（https://api.88api.shop）作为模型接口中转（你也可以用其他中转服务，替换对应baseUrl和Key即可）。它的好处是国内直连不用翻墙，一个Key能接多个主流模型，省掉注册多个海外账号的麻烦。

下面以88 API 为例：
获取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

打开文件，把从88api获取的Key填入对应模型的"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"  // 替换成你的Google分组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 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服务是否在运行（终端窗口是否关闭）。

总结

到这里，OpenClaw+88api的配置就完成了。核心步骤是Node.js环境准备、OpenClaw初始化、配置文件替换和鉴权Key填写，重点注意openclaw.json里的默认模型和工作目录，以及auth-profiles.json的Key对应关系。

国内用户用中转服务确实能省不少事，不用折腾海外账号和网络，一个Key管理多个模型也方便。如果启动时遇到其他问题，欢迎在评论区留言，我会尽量回复。

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

GXUST AI通识课 | 4类AI工具深度体验与实战测评

AtomGit开源社区

构网型（GFM-VSG）与跟网型（GFL-PQ）逆变器混合并联并网系统（Simulink仿真实现）

随着新型电力系统建设持续推进，新能源并网渗透率不断提升，传统跟网型逆变器并网模式在电网弱阻尼、频率扰动场景下存在稳定性不足、无主动调频能力等问题。构网型逆变器可模拟同步发电机组运行特性，具备自主建压、虚拟惯量支撑能力，能够有效弥补传统并网设备的运行短板。本文以1MW级、50Hz、690V升压220kV的构网型（GFM-VSG）与跟网型（GFL-PQ）逆变器混合并联并网系统为研究对象，搭建完整的混合