2026 年 OpenClaw 云服务器部署两种路线：一键镜像 vs 源码编译
OpenClaw 在云服务器上的部署主要有两种方式：一是选用云厂商提供的 OpenClaw/Claw 应用镜像一键开通，适合快速验证和不想折腾依赖的用户；二是手动安装 Node 22、通过 npm 或 pnpm 全局安装 openclaw 并自行配置，适合需要定制或已有固定运维流程的团队。一键镜像通常 3～5 分钟即可访问控制台，但系统与版本由镜像决定；源码编译路线需要 20～30 分钟，可精确控制 Node 与 openclaw 版本。2026 年多数新手更推荐先用一键镜像跑通，再根据需求决定是否迁移到自建或远程 Mac。
系统要求与必做项：Node 22、放通 18789 端口、防火墙与安全组
无论哪种路线，以下三项必须满足，否则控制台无法访问或服务无法正常对外提供。
| 项目 | 要求 | 说明 |
|---|---|---|
| Node.js | ≥ 22.0.0 | 低于 22 可能导致安装或运行异常，建议用 nvm 管理：nvm install 22 && nvm use 22 |
| 端口 | TCP 18789 | OpenClaw 控制台与网关默认端口，必须在实例安全组/防火墙中放行入站 |
| 系统与资源 | Linux Ubuntu 20.04+ / macOS / Windows WSL2；最低 2 核 2GB 内存、20GB 磁盘 | 云镜像一般已满足；自建需自行确认 |
云服务器（腾讯云、阿里云等）务必在控制台找到「安全组」或「防火墙」，添加入站规则：协议 TCP、端口 18789、来源 0.0.0.0/0（或按需限制 IP）。否则浏览器访问 http://服务器IP:18789 会一直超时。
安装过程常见问题：Node 版本不符、npm 卡死/超时、国内镜像与 pnpm 使用
以下为 2026 年最常见的三类安装问题与处理方式。
# 1. Node 版本检查与切换（必须 ≥ 22）
node -v
nvm install 22
nvm use 22
# 2. 配置 npm 国内镜像（解决卡死/超时）
npm config set registry https://registry.npmmirror.com
# 3. 使用 pnpm 替代 npm（可选，往往更快）
npm install -g pnpm
pnpm add -g openclaw@latest
# 4. 一键安装脚本（官方，所有平台通用）
curl -fsSL https://openclaw.ai/install.sh | bash
Node 版本过低： 安装或启动报错时先执行 node -v，若低于 22，用 nvm 或官方包安装 Node 22 并设为默认。
npm install 卡死或超时： 优先配置国内镜像；若仍不稳定，可改用 pnpm 安装。
Docker 容器无法启动： 检查 18789 是否被占用（netstat -an | grep 18789），以及镜像拉取是否完整（可配置国内镜像加速）。
控制台无法访问、Telegram/飞书不回复的排查步骤
控制台打不开（浏览器访问 http://IP:18789 超时或拒绝）： 九成以上是防火墙未放通 18789。请到云厂商控制台检查实例的「安全组」→ 入站规则，新增 TCP 18789；若在自有机房或本机 Linux，检查 firewalld、ufw 或 iptables 是否放行 18789。放通后重启 OpenClaw 服务再试。
Telegram / 飞书 Bot 不回复： 先确认 OpenClaw 服务在运行（openclaw status 或查看进程）；再检查对应渠道的 Token 是否填写正确、是否在 Bot 设置中启用了相应能力；查看日志 openclaw logs --tail 50 可看到连接或鉴权错误。多平台可同时配置，对话历史按渠道隔离。
多平台接入与离线运行（Ollama）简要说明
OpenClaw 支持在同一实例上配置多个渠道（Telegram、Discord、飞书等），所有渠道共用同一套 AI 能力，对话历史相互独立。技能与部分渠道接入需要联网；若使用 Ollama 等本地模型，可离线运行核心对话。模型选择上：日常对话可选用 Kimi、MiniMax；编程任务推荐 Claude Sonnet、GPT-4；成本敏感可选 DeepSeek、Qwen；隐私优先可选用 Ollama 本地部署。
FAQ 与决策清单：何时用云镜像、何时用远程 Mac 长期运行
- 只想快速验证或短期试用： 用云厂商 OpenClaw 镜像即可，按上文放通 18789 与配置 API Key。
- 需要 7×24 稳定在线、不想操心云主机运维与安全组： 考虑将 OpenClaw 迁到远程 Mac 托管（如 SFTPMAC），由服务方保障节点可用性、目录与权限清晰，更适合长期自动化与多平台接入。
- 已有 Apple 生态或 Mac 工作流： 远程 Mac 在兼容性与桌面/文件协作上更一致，升级与备份策略也更易统一。
云镜像适合快速上手与验证；当任务从「偶尔跑一下」变成「常驻在线、多平台接入、需要稳定目录与权限」时，远程 Mac 托管往往能减少运维负担并提升稳定性。
OpenClaw 控制台无法访问怎么办？
九成以上是防火墙或安全组未放通 18789 端口。在云厂商控制台检查实例安全组、入站规则，放行 TCP 18789；若在本地或自建机房的 Linux 上，检查 firewalld/ufw 或 iptables 是否放行 18789。
npm install 卡死或超时怎么解决？
配置国内镜像：npm config set registry https://registry.npmmirror.com；或使用 pnpm 替代 npm 以加快安装。同时确认 Node 版本 ≥ 22.0.0，否则可能兼容性问题导致卡住。
何时该用云镜像、何时该用远程 Mac 长期运行 OpenClaw？
云镜像适合快速验证、短期试用或已有云资源的情况；若需要 7×24 稳定在线、Apple 生态兼容、目录与权限清晰、或与现有 Mac 工作流统一，建议选用远程 Mac 托管（如 SFTPMAC）长期运行。
云服务器自建 OpenClaw 能快速跑通，但长期运行会涉及安全组、系统更新、备份与多环境一致性。若你更希望专注在 AI 自动化本身而非运维细节，可考虑将 OpenClaw 部署到 SFTPMAC 提供的远程 Mac 节点：我们保障 18789 端口可达、目录与权限清晰，并兼容多平台接入与 7×24 稳定运行，你只需配置模型与渠道即可。