前言

最近AI工具更新太快，想上手OpenClaw却被环境配置劝退？要么教程太碎片化，要么默认海外环境，国内用户光是账号和网络就卡半天。其实核心需求很简单：一篇能直接照着做、少踩坑的完整实操文。

这篇文章就带你从0到1搞定OpenClaw安装+api配置，全程国内环境，不用翻墙和海外账号，亲测跑通Claude、GPT、Gemini等主流模型。跟着步骤走，10分钟就能让AI在本地跑起来。

正文

一、准备工作：安装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（版本号≥18.0.0即可）
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（Windows可重启终端再试）。

到这里OpenClaw的基础框架就搭好了，接下来重点配置模型接口。

第二步：修改主配置文件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/Linux用户需将"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

我使用的是88API作为接口中转（官网：https://api.88api.shop），主要是为了国内直连，避免海外账号和翻墙问题，且一个Key能管理多个模型，减少切换配置的麻烦，有额度大家可以试试。

或者用自己的也可以，完全小白可以直接跟着我的步骤获取。

获取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填入对应模型的"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界面。在对话框中输入测试内容（如“你是谁”），如果AI能正常回复，说明配置成功。

⚠️ 常见问题排查：

  • 若报401 Unauthorized：检查auth-profiles.json中的Key是否填写正确
  • 若报Connection refused：确认Gateway服务是否在运行（终端窗口不要关闭）
  • 若模型不响应：检查openclaw.json中的baseUrl是否为https://api.88api.shop

总结

到这里，OpenClaw+88api的配置就全部完成了。核心步骤其实就三步：装Node.js→配OpenClaw主文件→填API Key，全程国内环境，不用海外账号和复杂网络配置。

如果遇到问题，优先检查配置文件路径和Key是否正确，大部分报错都是这两个地方没处理好。按照步骤操作，基本能一次跑通。有其他问题欢迎在评论区交流，我会尽量回复～

# windows
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

Gemini 辅助做创意写作：故事大纲、角色设定、世界观构建的 AI 协作

avatar DeepSeek技术社区
cover

AI协作创意写作：Gemini助力故事创作全流程

avatar DeepSeek技术社区

DeepSeek-TUI 半个月狂揽 1.9 万 Star：一个音乐家用 AI 造出的「DeepSeek 版 Claude Code」

回头看 DeepSeek-TUI 这件事，它的意义已经不只是「又多了一个开源工具」。往里看一层：一个完全非科班的人，靠和 AI 协作，做出了登顶 Trending 的工程级项目。这本身就是当下最值得琢磨的信号——写代码的技术门槛正在被重构，决定能不能做出东西的，越来越是想法、品味和把事情拆解清楚的能力，而不是「你科班学了几年」。往外看一层：国产模型的生态也开始转向了。放在两年前，「一个海外独立开发

avatar DeepSeek技术社区