OpenClaw 安装教程：Windows、macOS、Linux 全平台接入指南

很多人第一次接触 OpenClaw，最先遇到的问题其实不是“它能做什么”，而是：

• Windows 到底该怎么装
• macOS 和 Linux 用脚本还是 npm
• 装完以后为什么还不能直接聊天
• 第三方 API 怎么接进 OpenClaw

如果你搜的是 OpenClaw 安装教程，大概率就是想把这件事一次弄清楚，而不是看一堆零散命令再自己拼。
这篇文章就按这个思路来写：先按平台讲安装，再讲安装后怎么把 api.clawsocket.com 接进去。

快速结论

• 截至 2026-03-21，OpenClaw 官方文档对 Windows 的推荐路线是 WSL2，不是传统原生 PowerShell 长期运行
• macOS 和 Linux 最省事的方式通常还是官方安装脚本
• 安装完成后，最好立刻执行 openclaw onboard
• 如果你想在国内更顺手地使用 OpenClaw，装完以后把模型入口切到 api.clawsocket.com 会更省事

前言：OpenClaw 适合谁

OpenClaw 可以理解成一个自托管的 AI Gateway。它不是普通聊天机器人，而是一个能连接 Web 控制台、消息渠道、技能和代理能力的运行框架。

这类工具通常适合：

• 想把 AI 助手放到自己电脑或服务器上的开发者
• 想做聊天机器人、频道助手、自动化代理的人
• 想统一管理 GPT、Claude、Gemini 等模型入口的用户

如果你只是想体验一个聊天窗口，这篇 OpenClaw 安装教程可能会显得偏“工程化”；但如果你想把 OpenClaw 真正用起来，这种工程化流程反而更省时间。

一、安装前准备

1. 系统和环境要求

根据 OpenClaw 官方文档，目前比较稳的基础要求可以先按下面理解：

如果你打算长期使用 OpenClaw，我建议额外准备：

• Git
• 一个稳定的终端
• 至少 16GB 内存

2. 你还需要准备什么

安装 OpenClaw 本体不复杂，但想真正跑起来，通常还需要这三样：

1. 一个可用的模型入口
2. 一份 API Key
3. 一套你自己能长期维护的配置方式

这也是为什么很多人装完 CLI 之后，下一步还是会去接第三方中转站。

二、Windows 平台安装教程

1. 为什么 Windows 更建议用 WSL2

这里先讲一个关键点。

截至 2026-03-21，我查到的 OpenClaw 官方平台文档里，对 Windows 的推荐方式是：Gateway 通过 WSL2 运行。这和一些旧文章里直接用原生 PowerShell 长期开服务的思路不一样。

原因很现实：

• Linux 运行环境更稳定
• 服务管理方式更接近 OpenClaw 官方文档
• 后续插件、脚本、依赖兼容性更好

所以这篇 OpenClaw 安装教程对 Windows 用户的主线建议是：先装 WSL2，再在 Ubuntu 里装 OpenClaw。

2. Windows 推荐安装路线

步骤 1：安装 WSL2

以管理员身份打开 PowerShell，执行：

wsl --install

装完以后重启电脑，并在 Microsoft Store 里确认已经安装 Ubuntu。

步骤 2：进入 Ubuntu

第一次打开 Ubuntu 时，系统会让你创建 Linux 用户名和密码。
这一步完成后，你就可以把后面的安装过程完全当成 Linux 环境来处理。

步骤 3：更新系统包

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl git build-essential

步骤 4：执行官方安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash

步骤 5：验证安装

openclaw --version

如果能输出版本号，说明这条 Windows 安装路线已经打通了。

三、macOS 平台安装教程

1. macOS 最推荐的方式

对大多数 macOS 用户来说，最简单的方式还是直接用官方安装脚本。

步骤 1：打开终端

按 Command + Space，输入 Terminal，回车打开终端。

步骤 2：执行安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash

步骤 3：验证安装

openclaw --version

如果你的机器里还没有 Node，安装脚本通常会帮你处理依赖准备。

2. 想自己控环境时怎么装

如果你已经自己在 macOS 上维护 Node 环境，也可以直接用 npm：

npm install -g openclaw@latest

然后验证：

openclaw --version

这种方式更适合已经有开发环境、想自己控制版本和 PATH 的用户。

四、Linux 平台安装教程

1. Linux 的推荐方式

Linux 平台整体最顺的还是脚本安装。

Ubuntu / Debian / 其他常见发行版都可以先做基础准备：

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl git build-essential

然后执行：

curl -fsSL https://openclaw.ai/install.sh | bash

验证安装：

openclaw --version

2. 手动安装路线

如果你更喜欢完全自己控环境，也可以先装 Node，再全局安装 OpenClaw：

npm install -g openclaw@latest

如果执行 openclaw 提示命令找不到，再检查一下全局 npm 的 bin 目录是否已经进了 PATH。

五、安装完成后必须做的事

这部分是很多 OpenClaw 安装教程容易略过的地方，但实际上它很重要。

OpenClaw 装完不代表已经能正常工作。你至少还要做下面几步：

1. 运行初始化向导

openclaw onboard

这一步会帮你生成或确认：

• ~/.openclaw/openclaw.json
• 默认 workspace
• gateway 端口和认证 token
• dashboard 链接

如果你只是先想把框架跑起来，模型认证和上游配置可以先跳过，后面手动改配置文件。

2. 保存 dashboard 链接和 token

openclaw onboard 完成以后，控制台通常会打印 dashboard 地址和带 token 的访问链接。这个 token 一定要记住，不然后面你会以为“服务起了但网页进不去”。

3. 验证 gateway 是否能启动

前台测试最直接：

openclaw gateway

如果你想打开控制台：

openclaw dashboard

六、如何把 api.clawsocket.com 接进 OpenClaw

这是这篇 OpenClaw 安装教程跟普通安装文最大的区别。
装完 CLI 之后，你可以直接把模型入口切到 api.clawsocket.com，这样后面用起来会简单很多。

1. 先在后台生成 Key

登录 api.clawsocket.com，然后按这个流程：

1. 进入 令牌管理
2. 点击 添加令牌
3. 分组选择 default
4. 生成并复制你的 Key

2. 把 Key 放进环境变量

macOS / Linux / WSL2：

export CLAWSOCKET_API_KEY="你的 API Key"

如果要长期生效：

echo 'export CLAWSOCKET_API_KEY="你的 API Key"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell 临时测试可以写成：

$env:CLAWSOCKET_API_KEY="你的 API Key"

3. 修改 openclaw.json

OpenClaw 默认配置文件通常在：

~/.openclaw/openclaw.json

如果你不确定，也可以执行：

openclaw config file

然后把 provider 改成这种思路：

{
  agents: {
    defaults: {
      model: {
        primary: "clawsocket/gpt-5.4",
      },
    },
  },
  models: {
    providers: {
      clawsocket: {
        baseUrl: "https://api.clawsocket.com/v1",
        apiKey: "${CLAWSOCKET_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gpt-5.4", name: "GPT-5.4" },
          { id: "claude-sonnet-4-5", name: "Claude Sonnet 4.5" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" },
        ],
      },
    },
  },
}

4. 验证配置

openclaw config validate

如果有问题，再执行：

openclaw doctor

这两个命令基本能帮你定位大部分安装和配置问题。

七、常见问题

OpenClaw 安装教程里为什么不推荐原生 Windows 路线

因为截至 2026-03-21 我查到的官方平台文档，更推荐 Windows 用户通过 WSL2 跑 Gateway。很多旧文里的原生 Windows 路线不是完全不能用，但从长期维护和兼容性来看，WSL2 更稳。

安装完成后打不开控制台怎么办

先按顺序检查：

1. openclaw --version
2. openclaw onboard
3. openclaw gateway
4. openclaw dashboard

如果还是不行，再检查是不是用了错误的 token 或旧的 dashboard 地址。

为什么装好了 OpenClaw 还要接第三方 API

因为 OpenClaw 本身是 gateway 和 agent 运行框架，不自带你要用的模型额度。
你还是需要一个上游模型入口。对很多国内开发者来说，用 api.clawsocket.com 这种统一 API 入口会更方便。

我能不能只装 OpenClaw，后面再配 API

可以，而且这就是我更推荐的顺序：

1. 先把 OpenClaw 装好
2. 跑 openclaw onboard
3. 确认 gateway 和 dashboard 正常
4. 最后再接 api.clawsocket.com

这样排错最清楚。

总结

如果你现在要找一篇真正能落地的 OpenClaw 安装教程，最实用的路线其实就这么简单：

1. 按你的平台完成安装
2. 运行 openclaw onboard
3. 保存 dashboard token
4. 到 api.clawsocket.com 的 令牌管理 中添加令牌，分组选 default
5. 把 baseUrl 和 apiKey 配进 openclaw.json
6. 用 openclaw config validate 和 openclaw dashboard 完成验证

如果你接下来还想继续完善 OpenClaw 的配置，可以继续看：

• OpenClaw 完整配置教程（含第三方中转接入）
• OpenAI API Proxy
• 博客

参考资料

• OpenClaw Platforms
• OpenClaw Install
• OpenClaw Configuration
• 〖OpenClaw 安装教程：Windows/macOS/Linux 全平台保姆级指南〗- CSDN，CC BY-SA 4.0