OpenClaw Docs CN

安装部署 / 环境要求

安装总览与环境要求

Install Requirements

这页先帮你判断一件事:你的机器和路线够不够装 OpenClaw。

这不是具体安装教程,而是一页安装判断表。你会在这里先弄清 3 件事:你的设备够不够、你该选哪条安装方式、哪些中国用户常见问题可以提前绕开。先判断,再动手,后面会轻松很多。

安装判断页 适合动手前先读 中国用户常见问题优先
Quick Verdict

先看结论,大多数人不用把参数研究得很深

如果你现在只是想判断“我能不能装、该不该继续看”,先看这 4 个结论就够了。

普通电脑通常就够用 OpenClaw 本身不算重,一台家用电脑或入门云服务器通常就能跑起来,不需要先换机器。
Windows 还是优先 WSL2 官方支持 Windows,但仍然强烈推荐 WSL2。你如果想少踩坑,继续照这条路走就对了。
官方脚本是主路线 新手优先官方一键安装脚本;想长期跑服务器或隔离环境,再看 Docker 路线。
本地模型是另一回事 “能不能装 OpenClaw”和“本地模型跑不跑得动”不是同一个问题,不要混在一起判断。
Machine Check

先判断你的机器够不够

你不用追求精确到每一项参数,只要先确认自己属于哪个档位就行。

只想装起来并接远程模型

2GB 内存起步能用,4GB 更稳。只要系统正常、终端能用,这类场景通常问题不大。

想长期运行多个渠道和 Skills

建议预留更宽松的内存和磁盘,尤其是你准备长期跑在服务器上时,4GB 往上会更舒服。

想本地跑 Ollama 或 vLLM

这已经不是“能不能装 OpenClaw”的问题,而是本地模型资源问题。通常 8GB 以上才更像可用状态。

只是想先看看能不能跑通

完全没必要一开始就为本地模型准备高配机器。先装、先跑通、先看 Dashboard,是更稳的顺序。

Requirements

安装前真正需要确认的几项要求

下面这些不是为了吓人,而是为了让你知道安装阶段最常卡在哪几类问题上。

系统

  • 官方支持 macOS、Linux 和 Windows
  • Windows 用户仍然最推荐 WSL2
  • 服务器场景优先 Linux 或 Docker

运行环境

  • 需要 Node.js 22 或更高版本
  • 官方安装脚本通常会自动处理 Node
  • 手动安装时才更需要自己核对版本

网络与端口

  • 最好能访问 openclaw.ai 和 npm
  • 部分路线还会涉及 GitHub 或镜像仓库
  • Dashboard 默认访问地址是 127.0.0.1:18789
Route Choice

安装方式到底怎么选

很多人不是装不会,而是先选错了路。你只要照着自己的目标选,就不会太乱。

官方一键安装脚本 适合绝大多数新手。优点是简单、自动检查环境、通常能直接进入 onboarding。
Docker 路线 适合想长期跑、放服务器、或者不想动本机环境的人。中国用户常用社区 Docker-CN 方案。
源码安装 适合开发者和深度定制用户。普通用户最好把它留到后面,不要当作第一条路。
一句话建议 先用官方脚本跑通,再决定要不要换成 Docker 或源码,这样成功率最高。
China Tips

中国用户最常见的 3 个问题

这 3 件事几乎每个中文用户都会遇到,提前理解比出了错再排障更省时间。

国内网络慢怎么办

安装脚本、npm、GitHub 和镜像仓库都可能影响体验。最稳的做法是提前准备代理或镜像,而不是装到一半再补救。

飞书、钉钉是不是装完就有

官方标准安装路线和社区 Docker-CN 路线不要混着理解。前者重在装系统,后者才可能预装部分国内 IM 相关能力。

内存够不够跑大模型

如果你接的是远程模型服务,OpenClaw 本身压力不大;真正吃资源的是 Ollama、浏览器工具、向量库和长期任务。

Read Order

这一页看完以后,最推荐这样继续

别在这里停太久,判断完路线就进入具体系统教程,效率最高。

一句话总结

安装这件事最重要的不是先背命令,而是先判断你的机器够不够、路线合不合适。只要这两件事判断对了,OpenClaw 对大多数用户都没有想象中那么难装。