对新手来说，最重要的不是“选最强方案”，而是先选一个你今天就能部署成功的方案。
01 部署方式总览
常见部署方案可以分成了本地、Docker、国内云、海外平台几类。
| 方案 | 适合人群 | 成本感知 | 难度 |
|---|---|---|---|
本地 npm | 开发者、macOS/Linux 用户 | 低 | 低 |
| Docker | 熟悉容器的用户 | 低 | 中 |
| 阿里云 | 国内新手 | 很低 | 很低 |
| 腾讯云 | 企微 / QQ 生态用户 | 低 | 很低 |
| 百度云 | 想低门槛体验 | 很低 | 很低 |
| 华为云 | 企业与合规场景 | 中 | 中 |
| 火山引擎 | 飞书场景强相关 | 低 | 低 |
| 扣子编程 | 不想管服务器的人 | 低 | 极低 |
| Railway / Zeabur | 海外开发者 | 低到中 | 极低 |
一个重要结论是：服务器成本通常不是大头，模型调用成本才是。
02 本地安装
本地安装适合想完全掌控环境的人，也是最容易理解系统结构的方式。
系统要求
| 项目 | 要求 |
|---|---|
| Node.js | >= 22 |
| 包管理器 | npm / pnpm / bun |
| macOS | 建议安装 Xcode Command Line Tools |
| Linux | 需要常见构建工具 |
| Windows | 强烈建议走 WSL2 |
推荐安装方式
npm install -g openclaw@latest
openclaw onboard --install-daemon如果你不想手动装 Node，也可以使用官方脚本：
curl -sSL https://get.openclaw.ai | bash平台注意事项
macOS：先执行xcode-select --installWindows：优先在 WSL2 里跑，不建议直接使用原生环境守护进程：安装后 OpenClaw 会以后台服务持续运行
守护进程通常对应：
- macOS：
launchd - Linux：
systemd
03 Docker 部署
如果你希望环境隔离、迁移方便、或者计划长期跑在服务器上，Docker 是很稳妥的选择。
快速启动
git clone https://github.com/openclaw/openclaw.git
cd openclaw
docker-compose up -d镜像变体
| 变体 | 说明 | 适用场景 |
|---|---|---|
| 标准镜像 | 功能完整 | 大多数用户 |
slim | 更小、更轻 | 资源紧张或 CI |
sandbox | 强调隔离 | 执行风险较高任务 |
sandbox-browser | 含浏览器能力 | 网页自动化 |
必须挂载的目录
volumes:
- ~/.openclaw:/root/.openclaw
- ~/openclaw/workspace:/workspace这两个目录如果不挂载，容器重启后你之前的配置、状态和部分工作区数据都可能丢失。
端口
ports:
- "18789:18789"
- "3000:3000"18789：Gateway / WebSocket3000：Web UI
如果你用的是 Podman，也可以直接换成：
podman-compose up -d04 国内云与海外平台
如果你只想快点上手，云模板通常比自己从零配环境更省心。
国内常见方案
| 平台 | 特点 | 适合谁 |
|---|---|---|
| 阿里云 | 社区资料多，价格低，模板成熟 | 大多数国内新手 |
| 腾讯云 | QQ / 企微生态友好 | 办公 IM 场景 |
| 百度云 | 首月体验价低 | 低成本试水 |
| 华为云 | 合规能力强 | 企业场景 |
| 火山引擎 | 飞书集成强，套餐完整 | 飞书用户 |
| 扣子编程 | 不需要自己管服务器 | 零基础体验 |
海外常见方案
| 平台 | 特点 |
|---|---|
| Railway | 真正的一键部署，轻量使用成本低 |
| Zeabur | 模板成熟，适合多模型 failover |
| Sealos | 偏 K8s / 云原生 |
按场景怎么选
完全零基础：扣子编程、百度云想省心又可控：阿里云、腾讯云有容器经验：Docker海外使用：Railway、Zeabur想完全掌控本地数据：本地安装
05 第一次启动必须做的配置
部署成功只是第一步，第一次跑起来时有几个关键点必须确认。
先跑体检
openclaw doctor遇到问题时，先跑 doctor 基本是最省时间的做法。
明确 Gateway 认证
从 v2026.3.7 开始，Gateway 认证要求显式配置，不再允许默认裸奔。
{
"gateway": {
"auth": {
"mode": "token",
"token": "your-secret-token"
}
}
}你也可以把 mode 换成 password，但无论如何，不建议无认证暴露到公网。
版本与更新通道
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev对大多数用户来说：
stable最稳beta适合愿意尝鲜但能接受小问题的人dev适合开发者和测试新功能
部署后的检查清单
- Gateway 能正常启动
- 模型已配置并能连通
doctor无关键报错- 认证已开启
- 工作区目录已持久化
- 准备接入的消息渠道配置无误
做到这一步，你就已经从“看热闹”进入“真正在养龙虾”的阶段了。