思渡AI Logo

安装

安装

已经按照 入门指南 操作过了吗?那你已经准备好了 —— 本页适用于其他安装方法、特定平台说明以及维护操作。

系统要求

  • Node 24(推荐)(出于兼容性考虑,仍支持 Node 22 LTS,目前为 22.16+;如果缺失,安装脚本 会安装 Node 24)
  • macOS、Linux 或 Windows
  • 仅当你从源码构建时需要 pnpm

在 Windows 上,我们强烈建议你在 WSL2 下运行 OpenClaw。

安装方法

安装脚本 是安装 OpenClaw 的推荐方式。它会一步完成 Node 检测、安装和新手引导。

对于 VPS/云主机,尽量避免使用第三方“一键式”市场镜像。优先选择干净的基础 OS 镜像(例如 Ubuntu LTS),然后使用安装脚本自行安装 OpenClaw。

其他安装方法

安装后

验证一切是否正常工作:

openclaw doctor         # 检查配置问题
openclaw status         # Gateway 网关状态
openclaw dashboard      # 打开浏览器 UI

如果你需要自定义运行时路径,请使用:

  • OPENCLAW_HOME 用于基于主目录的内部路径
  • OPENCLAW_STATE_DIR 用于可变状态位置
  • OPENCLAW_CONFIG_PATH 用于配置文件位置

有关优先级和完整细节,请参阅 Environment vars

故障排除:找不到 openclaw

更新 / 卸载