安装
安装
已经按照 入门指南 操作过了吗?那你已经准备好了 —— 本页适用于其他安装方法、特定平台说明以及维护操作。
系统要求
- Node 24(推荐)(出于兼容性考虑,仍支持 Node 22 LTS,目前为
22.16+;如果缺失,安装脚本 会安装 Node 24) - macOS、Linux 或 Windows
- 仅当你从源码构建时需要
pnpm
在 Windows 上,我们强烈建议你在 WSL2 下运行 OpenClaw。
安装方法
安装脚本 是安装 OpenClaw 的推荐方式。它会一步完成 Node 检测、安装和新手引导。
对于 VPS/云主机,尽量避免使用第三方“一键式”市场镜像。优先选择干净的基础 OS 镜像(例如 Ubuntu LTS),然后使用安装脚本自行安装 OpenClaw。
其他安装方法
安装后
验证一切是否正常工作:
如果你需要自定义运行时路径,请使用:
OPENCLAW_HOME用于基于主目录的内部路径OPENCLAW_STATE_DIR用于可变状态位置OPENCLAW_CONFIG_PATH用于配置文件位置
有关优先级和完整细节,请参阅 Environment vars。