OpenClaw 安装教程：Windows、macOS、Linux 全平台上手，并接入 api.clawsocket.com

最后更新时间：2026-03-21

说明：这篇 OpenClaw 安装教程参考了你给出的 CSDN 文章选题方向，但正文已按 OpenClaw 官方仓库与文档重写，同时加入了 api.clawsocket.com 的接入示例。¹²

很多人搜索 OpenClaw，不是想看项目简介，而是想尽快把它装起来并跑通第一条任务。真正会卡住的地方通常只有三类：Node 版本不对、系统路径没配好、自定义模型源不知道怎么接。这篇 OpenClaw 安装教程就按“先准备环境，再装，再配模型，再验收”的顺序展开，Windows、macOS、Linux 三个平台都能直接照着做。如果你手里已经有 api.clawsocket.com 这样的中转站账号，文中第六部分可以直接接上。

快速答案（30 秒）

如果你只想先拿到最短路径，这篇 OpenClaw 安装教程可以浓缩成 5 句：

1. OpenClaw 当前推荐的运行时是 Node 24，最低也要 Node 22.16 以上。²
2. 三个平台都优先走 npm install -g openclaw@latest 加 openclaw onboard --install-daemon 这条主线。
3. 装完不要急着正式使用，先跑一次 openclaw doctor，再做一条最小任务验证。
4. 如果你准备接第三方模型源，OpenClaw 支持自定义 provider 和 Base URL，这也是 api.clawsocket.com 这类大模型 API 中转站能接进来的关键。³⁴
5. 你在控制台里真正需要的只有四样：API Key、Base URL、模型 ID、默认模型别名。

一、OpenClaw 安装前先准备什么

这篇 OpenClaw 安装教程先不急着贴命令，因为大多数失败都发生在安装之前。OpenClaw 本质上是一个会在本地跑守护进程、再通过模型配置去调外部推理服务的 AI 助手，所以系统环境必须干净，尤其是 Node、npm、PATH 和终端权限。你如果之前装过多个 Node 版本，或者公司电脑里已经有旧版 npm，全局安装时就很容易出现命令找不到、权限不足或 daemon 启不来的问题。

准备阶段建议你只检查三件事：node -v、npm -v、系统终端是不是你平时真正会使用的那一个。Windows 用户别混用 PowerShell、CMD 和 Git Bash；macOS 用户确认 ~/.zprofile 或 ~/.zshrc 没有残留旧的 Node 路径；Linux 用户则要提前判断自己是 apt、dnf 还是 pacman 路线。把这一步做干净，后面的 OpenClaw 安装教程会顺很多。

二、OpenClaw 安装教程的通用主线

和很多“各平台完全不同”的教程不一样，这篇 OpenClaw 安装教程的核心主线其实是统一的：先保证 Node 版本，再全局安装 OpenClaw，最后运行 onboarding 向导把 daemon 和模型配置带起来。OpenClaw 官方仓库现在最直接的安装方式也是这条路径。² 只要你不是在做源码开发，没必要一开始就走 git clone 和本地构建。

node -v
npm -v

npm install -g openclaw@latest
openclaw onboard --install-daemon

这四行命令跑完之后，OpenClaw 会进入初始化阶段。onboard 的作用不是单纯做欢迎页，而是把后台常驻的 Gateway daemon、模型认证和默认 agent 一起配起来。你可以把它理解为“安装完成”和“真正可用”之间的桥。很多人以为看到版本号就算结束，这正是 OpenClaw 安装教程里最容易造成误判的地方；真正要看到的是守护进程起来、模型调用成功、首条任务能回。

三、Windows 版 OpenClaw 安装教程

Windows 用户做 OpenClaw 安装，最常见的问题不是命令本身，而是权限、环境变量和旧版 Node 冲突。更稳的做法是先用系统包管理器装 Node LTS，再装 OpenClaw，再执行 onboarding。这样做的好处是路径通常会自动处理，不用你后面再手工补一轮 PATH。

winget install OpenJS.NodeJS.LTS
node -v
npm -v

npm install -g openclaw@latest
openclaw onboard --install-daemon

如果 winget 不可用，也可以直接去 Node 官网装 LTS 版，但装完后务必重新开一个 PowerShell 窗口再继续。完成这组命令后，建议马上执行一次 openclaw doctor。如果它提示命令不存在，通常不是 OpenClaw 装坏了，而是当前 PowerShell 会话没读到新的 npm 全局路径。关掉终端重开一次，或者检查 npm prefix 对应的 bin 目录有没有进入 PATH，往往就能解决。对 Windows 来说，这篇 OpenClaw 安装教程真正有用的一条经验是：先把环境变量问题排干净，再去研究模型配置，不要两件事同时查。

四、macOS 版 OpenClaw 安装教程

macOS 上的 OpenClaw 安装通常比 Windows 省心，因为 Node、Homebrew 和 launchd 的组合更稳定。你如果已经有 Homebrew，流程会非常短；如果没有，也建议先装 Homebrew，再装 Node，而不是混用下载包和第三方脚本。这样做能让后续的升级、卸载和 daemon 管理都更清晰。

brew install node
node -v
npm -v

npm install -g openclaw@latest
openclaw onboard --install-daemon

在 macOS 上执行完成后，OpenClaw 会把常驻服务挂到当前用户环境里。你如果发现命令能跑、界面也能开，但每次重启后状态又丢失，优先检查是不是上一步 onboarding 没跑完整，而不是怀疑模型接口失效。还有一个经常被忽略的点：如果你以前用 nvm 装过旧版 Node，再用 brew 装了一套新 Node，壳层里到底生效的是哪一个版本，必须用 which node 和 node -v 现场确认。把来源搞清楚，macOS 版 OpenClaw 安装教程基本就不会跑偏。

五、Linux 版 OpenClaw 安装教程

Linux 的 OpenClaw 安装差异主要来自发行版，不来自 OpenClaw 本身。Ubuntu 和 Debian 用户一般最省事，Fedora 次之，Arch 则更依赖你本机已有的开发工具链。无论哪一套，思路都别变：先确认 Node LTS，再执行全局安装，再完成 onboarding。把 Linux 当成“更自由”的平台是对的，但这也意味着你更要自己对 PATH、systemd 用户服务和 shell 配置负责。

sudo apt update
sudo apt install -y nodejs npm
node -v
npm -v

sudo npm install -g openclaw@latest
openclaw onboard --install-daemon

上面是 Debian 系的最短示例，Fedora 和 Arch 把安装 Node 的那一步换成自己的包管理器即可。需要额外提醒的是，很多 Linux 用户会直觉性地在所有命令前都加 sudo，这在 OpenClaw 安装里不一定是好事。全局安装那一步如果你的 npm 策略要求提权，可以接受；但 onboarding 和后续模型配置更适合在当前用户上下文中执行，因为 daemon、配置文件和密钥通常都和用户目录绑定。你如果把 root 和普通用户的配置混在一起，后面排错会很痛苦。

六、把 api.clawsocket.com 接入 OpenClaw

这部分是这篇 OpenClaw 安装教程和常规安装文最大的区别。很多用户把软件装好了，却卡在“模型从哪里来”。OpenClaw 官方文档给出的方向很清楚：它支持自定义 provider、Base URL、API key 以及模型映射；如果某个平台提供的是 OpenAI-compatible 或其他兼容接口，就可以按兼容模式接入。³⁴ 结合这条文档说明，一个合理推断是：如果 api.clawsocket.com 后台给你的是 OpenAI 兼容地址，你就可以把它当成自定义 provider 接进 OpenClaw。这里我明确标注为推断，因为我没有拿到你站内控制台的私有接口文档，示例中的 Base URL 需要你用后台实际提供的地址替换。

真正接入时，你先登录 api.clawsocket.com ，拿到 API Key、Base URL 和准备调用的模型 ID。接着重新运行 openclaw onboard，在模型来源那一步选择自定义 provider 或 OpenAI-compatible 方案，再把站点给你的信息填进去。只要兼容层设置对了，OpenClaw 并不在意模型是来自官方直连还是来自中转站，它关心的是认证方式、接口协议和模型 ID 能不能对上。

{
  "env": {
    "CLAWSOCKET_API_KEY": "替换成你在 api.clawsocket.com 生成的密钥"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "clawsocket": {
        "api": "openai-completions",
        "apiKey": "${CLAWSOCKET_API_KEY}",
        "baseUrl": "替换成 api.clawsocket.com 后台给出的 Base URL",
        "models": [
          { "id": "替换成你的模型 ID", "name": "ClawSocket Default" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "clawsocket/替换成你的模型 ID"
      }
    }
  }
}

这里有两个细节值得在 OpenClaw 安装教程里单独强调。第一，Base URL 到底要不要自带 /v1，不要凭感觉猜，直接以 api.clawsocket.com 后台展示的文档为准。第二，模型 ID 要和平台真实可调用的名字完全一致，别把网页上的宣传名误当成接口名。只要这两处填准，中转站路径和官方路径在 OpenClaw 里的使用体验差别并不大；真正拉开差距的，反而是你有没有把默认模型、失败回退和测试任务一起配好。

七、装完以后别急着正式开工

任何一篇 OpenClaw 安装教程如果只写到“看到版本号”就结束，实际价值都有限。更稳的做法是把安装验收拆成三层：环境层看命令和 daemon，模型层看认证和返回，任务层看首条指令能不能完整执行。你做完这三层，再去接真实工作流，返工会少很多。

openclaw doctor
openclaw gateway status

如果上面两条都正常，再跑一条最小任务，比如让它读取一个本地目录说明文件、给出三条整理建议，或者直接做一段简短总结。你不需要一上来就把邮件、浏览器自动化、文件整理全开。OpenClaw 的价值在于连续执行，不在于第一次就把所有能力堆满。对这篇 OpenClaw 安装教程来说，验收通过的标准只有一个：你已经确认安装、模型和首轮任务三条链路都是真的通了。

八、OpenClaw 安装教程里最常见的 4 个问题

1. OpenClaw 装好了，为什么命令还是找不到

这通常不是软件没装上，而是当前终端没有拿到 npm 的全局安装路径。Windows 多见于 PowerShell 会话未刷新，macOS 多见于 nvm 和 brew 两套 Node 混用，Linux 则常见于 root 和普通用户装在了不同前缀。排查顺序建议固定成 which node、npm config get prefix、重开终端、再跑 openclaw doctor。

2. api.clawsocket.com 接进去以后模型列表不工作

优先查三项：兼容模式是不是选成了 openai-completions，Base URL 是否与后台文档完全一致，模型 ID 是否填成了真实接口名。这三个字段里只要有一个不对，OpenClaw 表面上像是“安装没问题但模型不回”，本质上却是 provider 配置错误。这里不要一边改 Key 一边改模型名，单变量排查最快。

3. OpenClaw 安装教程里为什么一直强调 onboarding

因为 npm install -g 只解决“程序在不在”，openclaw onboard --install-daemon 才解决“它能不能作为一个常驻可用的助手运行”。很多用户把安装和初始化混成一步，结果版本号有了，daemon 没起，模型也没配，最后误以为 OpenClaw 本身不稳定。实际上是流程没走完。

4. 一定要官方 API 才能把 OpenClaw 跑起来吗

不一定。按 OpenClaw 官方文档，自定义 provider 和 Base URL 本来就是支持项。³⁴ 这意味着只要你的模型服务提供兼容协议，像 api.clawsocket.com 这种大模型 API 中转站就可以成为可行方案。只是正式使用前，你还是要核对计费、模型映射和稳定性，不要把“能接通”和“适合长期主用”混为一谈。

九、照着这篇 OpenClaw 安装教程执行就够了

如果你只想把事情做完，不想反复来回查资料，可以按这个顺序收尾：先把系统里的 Node 版本校准，再按本文所在平台的命令装好 OpenClaw，然后跑 onboarding，把默认模型配置到位，最后用 api.clawsocket.com 或你的其他模型源做一轮最小测试。只要这五步都通过，这篇 OpenClaw 安装教程就已经完成了它该完成的任务：不是让你“理解原理”，而是让你今天就把 OpenClaw 真正跑起来。