OpenClaw安装与88api配置全流程：国内直连GPT/Claude，手把手教程帮你少踩坑（2026亲测）

wdbw

363人浏览 · 2026-05-20 11:11:02

wdbw · 2026-05-20 11:11:02 发布

前言

最近不少朋友想体验OpenClaw，但总被环境配置卡住——要么缺Node.js环境，要么配置文件改不对，要么海外模型调用需要翻墙。其实国内环境下跑通很简单，关键是找对工具和步骤。

这篇文章就以88api为中转服务，从基础依赖到最终验证，一步步带你走通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（npm会随Node.js一起安装）

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

二、安装OpenClaw并初始化

第一步：全局安装OpenClaw

确保Node.js环境正常后，在终端执行以下命令全局安装OpenClaw：

npm install -g openclaw@latest

安装完成后，执行引导初始化命令：

openclaw onboard

⚠️ 成功后终端会输出版本号和"初始化成功"的提示。如果提示command not found，先检查Node.js是否安装正确，或npm全局路径是否添加到系统PATH（可重启终端后重试）。

到这里，OpenClaw的基础框架就搭建好了，接下来需要配置模型和接口。

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

OpenClaw的核心配置文件是openclaw.json，需要根据系统找到对应路径：

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 Key。

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

1. 获取API Key

模型调用需要API Key，我这里直接用88api（官网：https://api.88api.shop）作为中转服务，主要是省去了海外账号注册和翻墙的麻烦，一个Key就能接入多个主流模型，配置起来更省心。大家也可以用其他中转服务，只需对应修改baseUrl和key即可。

以88api为例，获取Key的步骤如下：
获取Key的步骤：

注册并登录后，点击侧边栏“API令牌”。
点击“添加令牌”
选择分组
1. 根据需要调用的模型选择分组
  a. claude 模型建议使用 calude code 分组、
  b. gpt 模型建议使用 codex分组
2. 可通过平台的模型广场查看不同模型支持的分组
3. 若在使用中出现上游分组饱和，请切换分组使用
点击提交
5. 点击复制按钮复制API令牌，也就是API KEY

2. 填写鉴权文件

鉴权文件auth-profiles.json的路径如下：

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"  // 替换为你的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服务：

openclaw gateway --port 18789

启动成功后，终端会输出类似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服务是否在运行（终端窗口是否关闭）

若模型无响应：检查网络连接，或尝试切换88api的分组（在控制台重新生成Key）

总结

到这里，OpenClaw的安装和88api配置就全部完成了。核心步骤是Node.js环境准备、配置文件修改和API Key填写，国内直连的关键是选对中转服务。如果遇到问题，优先检查配置文件路径和Key是否正确，大部分报错都是这两个环节出了问题。有其他疑问欢迎在评论区交流，一起避坑～

AtomGit开源社区

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

更多推荐

面向MIMO基带干扰消除的高灵活性异构多核体系结构设计开发【附程序】

为了支持非线性干扰消除中的排序操作，设计了一个专用的排序系统，包含4级流水线比较树，对16个输入值进行并行排序，延迟仅为3个时钟周期。编程模型方面，计算核采用类似软流水的方式，一个计算任务分解为多个阶段，每个阶段由一条微指令控制，一条微指令可以同时驱动多个运算单元。以8x8 MIMO的线性最小均方误差检测算法为例，C代码约500行，手工映射到该异构多核架构后，汇编代码为1800条，运行总时钟周期为

AtomGit开源社区

[智能体-118]：LangChain 核心组件、功能与 API 详解

功能：定期调用 LLM 把长对话压缩为摘要，大幅减少 Token 占用。适用：长时多轮对话、上下文窗口较小的模型。

AtomGit开源社区

【EI复现】基于主从博弈的新型城镇配电系统产消者竞价策略【IEEE33节点】(Matlab代码实现）

本文采用SFE模型对产消者竞价行为建模,确立了含多产消者的新型城镇配电系统日前现货市场交易机制,建立了含竞价博弈和优化调度的双层模型。上层模型追求产消者利润最大化,可确定多个产消者在配电网内的最优报价策略,下层模型考虑运行安全约束以及用户参与DR对系统进行最优经济调度﹐确定市场出清价格。最后﹐采用改进粒子群优化算法与(CPLEX求解器相结合的方法对该多主从博弈模型进行求解。