安装概述
安装
已经按照快速入门操作过了？那您已经准备就绪——本页面提供替代安装方法、特定平台说明和维护信息。
系统要求
ℹ️ 在 Windows 上，我们强烈建议在 WSL2 下运行 OpenClaw。
安装方法
💡 安装脚本是推荐的 OpenClaw 安装方式。它一步完成 Node 检测、安装和初始化引导。
⚠️ 对于 VPS/云主机，请尽可能避免使用第三方"一键式"市场镜像。优先选择干净的基础操作系统镜像（例如 Ubuntu LTS），然后使用安装脚本自行安装 OpenClaw。
其他安装方法
Docker
容器化或无头部署。
Podman
无根容器：运行一次 setup-podman.sh，然后运行启动脚本。
Nix
通过 Nix 进行声明式安装。
Ansible
自动化批量配置。
Bun
通过 Bun 运行时仅使用 CLI。
安装后
验证一切是否正常工作：
openclaw doctor # 检查配置问题
openclaw status # 网关状态
openclaw dashboard # 打开浏览器 UI
如果需要自定义运行时路径，请使用：
OPENCLAW_HOME用于基于主目录的内部路径OPENCLAW_STATE_DIR用于可变状态文件位置OPENCLAW_CONFIG_PATH用于配置文件位置
有关优先级和完整详细信息，请参阅环境变量。