返回首页安装

OpenClaw 安装完整教程（2026）

从环境检查到首次运行，按命令逐步安装 OpenClaw。

更新日期：2026-03-11关键词：openclaw 安装

适用场景

第一次接触 OpenClaw，需要快速跑通

预计阅读

8 分钟

完成结果

你会得到一个可正常收发消息的基础环境

执行步骤

  1. 系统要求先过线：Node.js >= 22，macOS 需 Command Line Tools，Windows 建议 WSL2。
  2. 推荐安装路径：`npm install -g openclaw@latest` 后执行 `openclaw onboard --install-daemon`。
  3. 首次配置至少完成三项：模型 API Key、默认消息渠道、基础身份认证策略。
  4. 若启动失败，先查端口冲突与权限：Gateway 默认 `18789`，Web UI 默认 `3000`。
  5. 初始化完成后，发一条最小测试消息，确认“收消息 -> 执行 -> 回消息”闭环。
  6. 最后再进入渠道接入和技能安装，避免把问题叠加到同一阶段。

关键命令

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

常见风险

  • 同一时间只改一类变量，避免问题互相覆盖。
  • 所有变更都保留可回滚路径与日志证据。

高频失败案例

  • 直接跳过环境检查，安装后启动失败。
  • 多版本 Node 共存未切换，依赖行为异常。

完成验收

  • 服务可正常启动
  • 基础命令可执行
  • 首个测试任务可完成

继续深入

先完成本页验收项，再看同分类文章，把流程串成完整闭环。