OpenClaw 推荐安装方法:三种方式完整指南
OpenClaw 提供三种安装方式:一键脚本安装(推荐新手)、npm 全局安装(推荐普通用户)、源码安装(推荐开发者)。三种方式均支持 macOS、Windows、Linux,Node.js 22+ 为必要前置条件。安装完成后通过 openclaw onboard 向导完成初始化,连接 LLM、配置通信渠道和技能即可开始使用。

安装前提条件
OpenClaw 要求 Node.js 版本 ≥ 22。 使用一键脚本安装时,脚本会自动检测并安装 Node.js,无需手动处理。使用 npm 或源码安装前,请先确认 Node.js 版本:
node --version # 确认输出 v22.x.x 或更高
支持的操作系统:
● macOS(菜单栏应用需要 macOS 15+)
● Windows
● Linux
方法一:一键脚本安装(推荐新手)
这是 OpenClaw 官方最推荐的安装方式,自动处理 Node.js 依赖和平台差异:
curl -fsSL https://openclaw.ai/install.sh | bash
脚本会自动完成:
1. 检测操作系统和现有环境
2. 安装或更新 Node.js(如未满足 ≥22 要求)
3. 全局安装 OpenClaw 最新版
4. 启动 onboard 向导
macOS 注意:首次运行可能需要 Homebrew 管理员权限,按提示输入密码即可。
方法二:npm 安装(推荐普通用户)
已有 Node.js 22+ 环境的用户,直接用 npm 安装最简洁:
npm install -g openclaw@latest
openclaw onboard --install-daemon
或使用 pnpm(速度更快):
pnpm add -g openclaw@latest
openclaw onboard --install-daemon
--install-daemon 参数会安装后台守护进程(macOS 用 launchd,Linux 用 systemd),确保 OpenClaw 开机自启、持续在后台运行。
方法三:源码安装(推荐开发者)
需要修改源码或参与开发的用户,使用 Git 安装:
# 使用官方脚本的 git 模式
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
# 或手动克隆
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm openclaw onboard --install-daemon
开发模式启动(支持代码变更自动重载):
pnpm gateway:watch
三种安装方式对比
安装后:onboard 向导
所有安装方式完成后,都需要运行 onboard 向导完成初始化:
openclaw onboard --install-daemon
向导会依次引导完成四项配置:
1. Gateway(网关):设置本地通信网关端口(默认 18789)
2. Workspace(工作区):配置工作目录和权限
3. Channel(通道):连接通信平台(WhatsApp / Telegram / Discord / Slack 等)
4. Skill(技能):从 ClawHub 安装初始技能包
安装后常用命令
# 启动网关
openclaw gateway --port 18789 --verbose
# 向指定号码发送消息
openclaw message send --to +1234567890 --message "Hello"
# 直接与 Agent 交互
openclaw agent --message "帮我整理今天的待办" --thinking high
# 更新到最新版
openclaw update --channel stable # 稳定版
openclaw update --channel beta # 测试版
openclaw update --channel dev # 开发版
常见问题
Q:安装 OpenClaw 需要付费吗?
OpenClaw 本身完全开源免费(MIT 协议),GitHub 267k+ Stars。运行时需要连接 LLM,使用 Claude 或 GPT 会产生 API 费用;使用本地模型(如 Ollama)则完全免费。Q:Windows 上能正常安装吗?
支持,官方三种安装方式均兼容 Windows。一键脚本会自动处理 Windows 环境差异。建议使用 Windows Terminal 或 PowerShell 运行安装命令。Q:安装后如何验证是否成功?
运行 openclaw --version 查看版本号,或运行 openclaw agent --message "你好" 测试基本交互是否正常。
Q:–install-daemon 是必须的吗?
不是必须,但强烈推荐。守护进程确保 OpenClaw 在后台持续运行,不需要每次手动启动;不安装的话,每次重启设备后需手动运行 openclaw gateway 才能使用。
Q:如何在 ClawHub 上获取更多技能?
访问 clawhub.ai,找到所需技能后按安装指引操作,或在 onboard 向导的 Skill 配置步骤中直接选择安装。
总结
OpenClaw 最推荐的安装方式是一键脚本(新手)或 npm 安装(有 Node.js 环境的用户),配合 --install-daemon 参数安装守护进程,是最完整的安装体验。 安装后 onboard 向导全程引导,从 LLM 连接到技能配置,10 分钟内即可完成所有配置开始使用。
据 OpenClaw 官方 GitHub(github.com/openclaw/openclaw)文档,项目持续活跃更新,升级命令 openclaw update --channel stable 可随时获取最新版本。
本文内容基于 2026 年 3 月 OpenClaw 官方文档(openclaw.ai),建议安装前访问官网确认最新版本要求。
延伸资源
● OpenClaw 官网:openclaw.ai
● ClawHub 技能市场:clawhub.ai
● OpenClaw GitHub:github.com/openclaw/openclaw