OpenClaw 支持从本地到云端的多种部署方式。选择哪种取决于你的技术水平、预算和使用场景。
本地安装
本地安装适合开发者和想完全掌控数据的用户。OpenClaw 是 TypeScript 项目，运行在 Node.js 上。
系统要求
方式一：npm全局安装（推荐）
安装 OpenClawnpm install -g openclaw@latest# 初始化并安装守护进程openclaw onboard /-install-daemon
onboard命令会引导你完成初始配置，包括选择模型、配置API Key、设置消息频道等。– install-daemon参数会同市安装守护进程，让OpenClaw在后台持续运行。
方式二：一键脚本安装
如果你不想手动安装 Node.js，可以使用官方提供的一键安装脚本：
curl -sSL https://get.openclaw.ai | bash
脚本会自动检测系统环境、安装 Node.js（如缺失）并完成 OpenClaw 安装。
macOS 额外准备
macOS 用户在安装前需要确保已安装 Xcode Command Line Tools：
如果你需要使用 iMessage 频道或 Apple Notes 技能，这些依赖 macOS 原生的 AppleScript 能力，只有在 macOS 上才能运行。
Windows 用户注意
注意
OpenClaw 官方强烈推荐 Windows 用户通过 WSL2（Windows Subsystem for Linux）运行。直接在 Windows 原生环境下运行可能遇到路径、权限等兼容性问题。
安装 WSL2 后，在 Ubuntu 终端内按 Linux 流程安装即可。
守护进程
守护进程让 OpenClaw 在后台持续运行，即使关闭终端也不会中断。不同系统使用不同的进程管理方式：
安装守护进程后，OpenClaw Gateway 会在ws://127.0.0.1:18789持续监听。
Docker 部署
Docker 部署适合需要环境隔离、方便迁移、或在服务器上长期运行的场景。
OpenClaw 仓库内置了docker-compose.yml，一条命令即可启动快速启动 ：
克隆仓库git clone https://github.com/openclaw/openclaw.git cd openclaw启动# docker-compose up -d
镜像变体
使用slim变体:在docker-compose.yml中设置环境变量OPENCLAIl_VARIANT=slim。v2026.3.7起支持扩展依赖预烘焙，容器镜像可预装扩展依赖，减少启动时的安装等待。
挂载目录
Docker部署需要挂载两个关键目录，确保数据持久化:
voLumes: - ~/.openclaw:/root/.openclaw #配置和状态数据 - ~/openclaw/workspace:/workspace #工作空间(YAML配置文件)
重要：不挂载这两个目录，容器启所有配置和对话记录都会丢失。～/.openclaw存放运行状态，workspace存放YAML配置文件。
端口映射
OpenClaw Gateway 默认监听 18789 端口（WebSocket），Web UI 默认使用 3000 端口。在docker-compose.yml 中配置端口映射：
ports: -"18789:18789" Gateway WebSocket "3000:3000" # Web UI
Podman兼容
OpenClaw同样支持Podman运行。Podman是Docker的无守护进程替代方案，命令基本兼容:
#使用Podman启动podman-compose up -d
对于需要rootless容器运行的环境(如企业安全策略要求)，Podman是更合适的选择。
首次配置
无论哪种部署方式，安装完成后都需要进行首次配置。这里覆盖最关键的几个配置项。
Gateway 认证设置
注意
v2026.3.7 Breaking Change：Gateway 认证现在要求显式设置 gateway.auth.mode 。不设置将导致 Gateway 无法启动。这是为了修复此前暴露在互联网上的 30,000+ 未认证实例的安全隐患。
在~/.openclaw/workspace目录下的配置文件中设置认证模式：
选择⼀种认证模式gateway: auth: mode: token #⽅式⼀：Token 认证（推荐⽤于 API 集成） # 或 mode: password # ⽅式⼆：密码认证（推荐⽤于 Web UI 访问）
模型选择与 API Key 配置
OpenClaw 支持多模型切换，你需要至少配置一个模型的 API Key。常见的选择：
核心建议
OpenClaw 几乎每天都有新版本发布。使用以下命令更新：
更新到最新稳定版(推荐)openclaw update --channel stable# 更新到 Beta 版(尝鲜)openclaw update --channel beta# 更新到开发版(最新功能，可能不稳定)openclaw update --channel dev
三个更新渠道的区别
诊断检查
-
-
必要的系统依赖是否已安装 Gateway 连接是否正常
-
-
-
如果有任何问题，openclaw doctor 会给出具体的修复建议。这是排查问题的第一步
推荐版本：截至 2026 年 3 月 8 日，推荐使用 v2026.3.7 稳定版。该版本修复了此前的 WebSocket 安全漏洞 （CVE-2026-25253），并新增了 Context Engine 插件接口、ACP 持久化频道绑定等重要功能。
渠道概览
OpenClaw 通过 Gateway 架构统一连接 20+ 聊天平台。所有渠道共享同一套三步接入模式：创建凭证 → 写入配置 → 启动 Gateway。
统一接入流程
可以同时运行多个 channel，消息自动路由到对应平台。配对模式（dmPolicy: pairing）默认启用，未知者需要验证码才能与bot对话。
完整平台列表
新手推荐排序
从易到难推荐:Telegram(最简单，5分钟零门槛)➡️QQ(国内首选，扫码即用)➡️Discord(社区场景佳)➡️飞书(国内企业)➡️钉钉(社区插件成熟)➡️WhatsApp(海外日常通讯)
夜雨聆风
