电脑端一条命令安装：macOS、Windows、Linux 全流程

网关是整套系统的大脑，装在哪台电脑上，助理就「住」在哪台电脑上。

环境要求

• 操作系统：macOS、Linux，或 Windows（原生 Hub，或 WSL2）
• Node.js：22.22.3+、24.15+ 或 25.9+，官方推荐 24 系（用 node --version 检查；没有也没关系，桌面端和安装脚本会自动带上）
• 一个模型提供商的 API 密钥：Anthropic、OpenAI、Google 等，新手引导时会用到

方式一：npm 安装（最通用）

npm i -g openclaw

装完直接跑：

openclaw onboard --install-daemon

方式二：官方安装脚本

macOS 与 Linux 提供一条 curl 安装命令，Windows 提供 PowerShell 安装命令，地址见官方文档的安装页。脚本会检测系统、缺 Node 时自动补装，适合不想手动管 Node 的用户。

方式三：桌面应用

macOS、Windows、Linux 都有完整桌面端（版本形态见前一篇），帮你把网关、聊天界面、初始设置一次装齐；macOS 版还有菜单栏常驻、语音唤醒等系统能力。

从源码跑（进阶）

先从 GitHub 上的 openclaw/openclaw 仓库复制克隆地址，然后：

git clone <仓库克隆地址>
cd openclaw && corepack enable && pnpm install
pnpm openclaw onboard

源码检出是 pnpm 工作区结构，适合想读源码或参与贡献的人。

验证安装成功

openclaw gateway status

看到网关正在监听 18789 端口即为正常。再跑 openclaw doctor 做一次体检，它会修复并迁移配置、跑健康检查。

装在哪台机器上比较好

• 日常家用：自己常开的台式机或笔记本，简单直接。
• 全天候在线：一台便宜 VPS 或家里的小主机，配合 Tailscale 远程访问，出门也能用。
• 注意安全边界：网关有执行命令的权限，不要装在不重要的机器上裸奔对外网暴露，安全细节见安全设计。

装好后进入启动网关。