想快速体验 OpenClaw 却不知从哪一步开始？本文面向零基础用户，给出安装前准备（Node 版本与 18789 端口）、三种安装方式与 10 分钟路线选择、从安装到第一次对话的步骤，以及端口/控制台无法访问的 3 个常见卡点与 FAQ，帮助你在 Windows、Linux、macOS 或远程 Mac 上都能在约 10 分钟内跑通第一次对话。
安装前准备：Node 版本与 18789 端口
OpenClaw 2026 要求 Node.js v22 或更高，低于此版本会导致安装或编译失败。建议使用 nvm 管理：nvm install 22 && nvm use 22。此外，OpenClaw 默认使用 18789 端口 提供 Web 控制台，若你使用云服务器或远程 Mac，必须在防火墙/安全组中放行 18789（TCP），否则浏览器无法访问控制台。
- Node 版本：终端执行
node -v，需 ≥ v22.0.0。 - 端口 18789：本地或云主机需允许入站 18789；Linux 上可执行
ufw allow 18789（若使用 ufw）。
三种安装方式与 10 分钟路线选择
根据你的环境与偏好，可选用以下三种方式之一，目标都是在约 10 分钟内完成安装并打开控制台。
| 方式 | 适用人群 | 典型耗时 | 备注 |
|---|---|---|---|
| 官方安装脚本 | 新手、本地或 VPS 快速体验 | 约 5–10 分钟 | curl -fsSL https://openclaw.ai/install.sh | bash，脚本会检测并安装 Node。 |
| npm 全局安装 | 已有 Node 22+ 的开发者 | 约 5–8 分钟 | npm install -g openclaw@latest，之后执行 openclaw onboard 与 openclaw gateway。 |
| Docker / 预装镜像 | 团队或生产环境、希望隔离依赖 | 约 10–15 分钟 | 使用官方或社区 Docker 镜像，需映射 18789 端口；部分云厂商提供 OpenClaw 一键镜像。 |
npm config set registry https://registry.npmmirror.com。从安装到第一次对话的步骤
以「安装脚本 + onboard」为例，最小路径如下。
安装 OpenClaw
执行 curl -fsSL https://openclaw.ai/install.sh | bash 或 npm install -g openclaw@latest，等待完成。
运行配置向导
执行 openclaw onboard，按提示完成 Gateway、API 等基础配置；若有授权弹窗（如 macOS），需在图形界面点击允许。
启动 Gateway
执行 openclaw gateway（或按文档使用 systemd/pm2 常驻），确保 18789 端口已监听。
打开 Web 控制台
浏览器访问 http://localhost:18789（或你的服务器 IP:18789），进入 Dashboard。
发送第一条指令
在控制台或 TUI（openclaw tui）中发送一条简单指令，确认模型与 Gateway 正常响应，即完成「第一次对话」。
端口与控制台无法访问的 3 个卡点
新手最容易卡在「装好了但打不开控制台」或「onboard 中途报错」，常见原因与对策如下。
- 防火墙/安全组未放行 18789：云服务器必须在安全组中添加入站规则，放行 TCP 18789；本地 Linux 若启用 ufw，需
ufw allow 18789并 reload。 - Node 版本过低：若未满足 Node 22+，安装或运行可能报错；用
nvm use 22或系统包管理器升级后再试。 - 默认 Token 未修改导致被扫描：部署后建议立即在 Dashboard 中修改默认 Gateway Token，避免被公网扫描滥用；同时检查系统提示词长度，避免 Token 消耗异常。
FAQ
10 分钟真的能跑通第一次对话吗？
在 Node 22+ 与网络正常的前提下，使用安装脚本或 npm 全局安装，按 onboard → gateway → 打开 18789 控制台 → 发一条指令的流程，多数用户可在 10 分钟内完成。若遇网络或权限问题，可参考站内 OpenClaw 报错排查与部署文章。
在远程 Mac 上装 OpenClaw 有什么好处？
远程 Mac 提供完整图形界面（VNC），onboard 过程中的系统授权弹窗、Keychain 确认等可直接点击完成，避免纯 SSH 下无法处理弹窗的问题；同时可与站内其他 OpenClaw 部署、授权弹窗规避等文章配合使用。
openclaw doctor 是做什么的？
openclaw doctor 用于健康检查，可帮助诊断环境、依赖与配置是否正常；遇到无法启动或控制台异常时，可先执行 doctor 查看输出，再结合站内排查指南处理。
结语：在本地 Windows、Linux 或自建 VPS 上安装 OpenClaw 都能跑通，但常会遇到 Node 版本、端口放行、授权弹窗与依赖环境等问题，排查成本不低。若你希望减少环境折腾、快速体验 OpenClaw 的完整能力（包括需要图形界面的 onboard 与系统授权），使用租赁 VNCMac 的远程 Mac并在 VNC 桌面中部署 OpenClaw，可以避免本地环境差异与弹窗无法点击的痛点，几分钟内获得一台已就绪的 Mac 与图形化配置流程。如需选型可参考站内「OpenClaw 环境选型」与「快速开通」页面。