OpenClaw 的官方安装入口是 openclaw.ai,macOS、Linux、WSL2 上跑一行脚本即可自动装好 Node 与命令行工具,Windows 可用 PowerShell 脚本或官方 Windows Hub 桌面端。它完全免费、开源(具体协议以仓库 LICENSE 文件为准)、本地优先运行,无需订阅。本文按官方文档整理安装步骤、系统要求与常见报错排查。 OpenClaw安装官方入口与下载渠道
- Windows Hub 桌面端:OpenClawCompanion-Setup-x64.exe / OpenClawCompanion-Setup-arm64.exe(来自 github.com/openclaw/openclaw-windows-node 发布页)。
- macOS 菜单栏 App:OpenClaw-<版本>.dmg 或 .zip(来自 github.com/openclaw/openclaw 发布页)。
- Linux:AppImage 或 Debian 包(.deb)。
注意区分官方与第三方:openclaw.ai 是官方主站;remoteclaw.com、openclawagent.ai 属于第三方科普/问答站,openclaw.com 为无关域名,三者均非官方,其页面上的安装包或下载链接不要直接采信,认准 openclaw.ai 与 docs.openclaw.ai。
OpenClaw一键安装步骤(脚本/npm/桌面端)
- 先确认 Node 版本:终端运行 node -v,需 Node 24.16+ 或 26.1+(Node 26 推荐);若未安装或版本不符,直接走下一步的安装脚本,它会自动补装 Node。
- macOS / Linux / WSL2 运行官方一键脚本:curl -fsSL https://openclaw.ai/install.sh | bash。
- Windows 用 PowerShell(无需管理员):iwr -useb https://openclaw.ai/install.ps1 | iex;或直接下载运行 Windows Hub 的 .exe 安装包。
- 脚本装完会自动启动引导:运行 openclaw onboard(桌面端首次启动也会引导),按提示选 Quick start(复用已登录的 Claude Code / Codex 或填 provider key)或 Custom setup。
- 装好后台服务并打开控制台:Ctrl+C 停下前台 Gateway 后运行 openclaw gateway install;浏览器打开 http://127.0.0.1:18789/ 即 Control UI。
关键提示:若你已自己管理 Node,可用 npm install -g openclaw@latest --allow-scripts=openclaw(npm 12 / 11.16+ 必须带 --allow-scripts=openclaw,否则生命周期脚本被拦);pnpm 用 pnpm add -g --allow-build=openclaw openclaw@latest;bun 用 bun add -g --trust openclaw@latest。用官方安装脚本方式无需这些开关。不想依赖系统 Node 时,还可走本地前缀脚本 curl -fsSL https://openclaw.ai/install-cli.sh | bash。
OpenClaw系统要求(Node/操作系统/硬件)
| |
|---|
| macOS 15+(Apple Silicon / Intel 通用二进制)、Windows 10/11(64 位,x64 或 ARM64)、主流 Linux(Ubuntu / Debian / Fedora 等) |
| 24.16+ 或 26.1+(Node 26 推荐);Node 22、23、25 不支持 |
| x64 / ARM64;Alpine / musl 等需手动装 Node |
| 调用云端大模型 API、连接聊天频道需联网;接本地模型可完全离线 |
内存与磁盘官方未设硬性门槛,但运行 Gateway 加本地模型建议 4GB+ 内存、预留数 GB 空间。最省心的是直接用官方安装脚本——它会在缺少 Node 时自动在 macOS 上装 Node 26、在 Linux 上装受支持的 Node 24 LTS,并处理好 SQLite 兼容性,免去手动踩坑。老旧 Node(含 24.16 之前的 24.x、26.1 之前的 26.x)会因 SQLite 文本截断风险被拒,升级 Node 后再更新 OpenClaw 即可。
OpenClaw是否收费与 API 密钥要求
OpenClaw 本身完全免费、开源,没有订阅、没有官方托管层、也没有登录 token,由独立非营利组织(501(c)(3))托管。但要让它真正"干活",需要接一个大模型来源:
- 复用已有登录:本机已登录 Claude Code 或 Codex CLI,引导流程可直接复用,无需另购 key。
- 提供 provider API key:填 OpenAI、Anthropic、Google 等任一厂商密钥;用云端模型时按各厂商计费,费用由厂商收,与 OpenClaw 无关。
- 本地模型:接 Ollama、LM Studio 等可完全离线运行,零调用费用。
所以"免费"指软件免费,跑云端大模型是否花钱取决于你选的 provider;纯本地模型场景可以一分钱不花。
OpenClaw安装注意事项与常见报错
| | |
|---|
openclaw: command not found | | 运行 npm prefix -g 拿到路径,把 <prefix>/bin 加进 ~/.zshrc 或 ~/.bashrc 的 PATH,重开终端 |
| | 用官方一键脚本自动补装,或 brew / winget / nodejs.org 装 Node 24.16+ 或 26.1+ |
npm install -g 报 EACCES 权限错误 | | 不要加 sudo;执行 mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global 后再装 |
| | 加 --allow-scripts=openclaw(见安装步骤) |
| | 检查联网,临时关闭代理或杀软,或改用本地前缀安装脚本 install-cli.sh |
- 不要把 Gateway 暴露公网:默认监听 127.0.0.1:18789,仅本机可访问;要远程访问用 Tailscale / SSH 隧道,不要直接把端口映射到公网。
- 不要 sudo npm install -g:权限问题用改 npm prefix 解决,sudo 会埋后续坑。
- 密钥来自第三方厂商:填的 API key 由对应厂商计费与保管,妥善保管,绝不在非官方页面输入。
- Windows 三条路任选:Windows Hub 桌面端(最省心)、PowerShell 脚本、或 WSL2 跑 Gateway;新手优先 Hub。
- 装完先验证:openclaw --version 看版本、openclaw doctor 查配置、openclaw gateway status 看 Gateway 是否在跑。
- 普通用户用脚本即可:git clone 后 pnpm install && pnpm build 仅贡献者或要改代码时需要,无需为了安装去碰源码。
OpenClaw常见问题解答(安装与排错 FAQ)
Q:OpenClaw 安装要钱吗?
A:不要。软件本身免费开源、无订阅无托管层;只有调用云端大模型时按你选的厂商(OpenAI / Anthropic 等)计费,接本地模型则零费用。
Q:安装 OpenClaw 需要什么系统?
A:macOS 15+、Windows 10/11(64 位)、主流 Linux 均可;核心要求是 Node 24.16+ 或 26.1+,官方脚本会自动补装 Node,自己装则避开不支持的 22 / 23 / 25。
Q:Windows 上怎么装 OpenClaw?
A:三种方式——下载运行官方 Windows Hub 的 .exe 安装包(最省心)、PowerShell 跑 iwr -useb https://openclaw.ai/install.ps1 | iex、或在 WSL2 里用 macOS / Linux 同款脚本。
Q:Mac 上怎么装 OpenClaw?
A:推荐终端一行 curl -fsSL https://openclaw.ai/install.sh | bash;或到 GitHub 发布页下 OpenClaw-<版本>.dmg 装菜单栏 App,首次启动引导连 Gateway。
Q:装 OpenClaw 需要注册账号或买 key 吗?
A:不需要给 OpenClaw 注册。但它要接大模型:可复用本机已有的 Claude Code / Codex 登录,或填一家厂商的 API key;本地模型无需 key。
Q:提示 openclaw: command not found 怎么办?
A:基本是 PATH 问题——npm 全局 bin 没进环境变量。用 npm prefix -g 查路径,把 <prefix>/bin 加进 shell 启动文件的 PATH 后重开终端即可。
Q:内网 / 特殊网络环境能装吗?联网要求是什么?
A:安装脚本与安装包本身可下载;运行时要联网才能调用云端大模型 API、连接聊天频道。各 LLM 厂商的区域可用性以其官方说明为准,企业内网请按贵司网络策略放行相应域名。
Q:装完怎么用、怎么连 Telegram / 微信?
A:引导完成后打开 http://127.0.0.1:18789/ 的 Control UI 发消息;要手机聊就 openclaw channels login --channel telegram 连频道(Telegram 最快),WhatsApp / Discord / Slack / 飞书等也支持。 Q:OpenClaw 安全吗、数据会不会上传?
A:它本地优先运行,会话与文件默认留在你机器上(配置在 ~/.openclaw/openclaw.json);只有你显式接入的外部服务才会对外通信。务必只从 openclaw.ai 等官方渠道获取安装包,不要把 Gateway 端口暴露公网。
以上就是OpenClaw安装相关的信息,OpenClaw 的安装命令、系统要求与桌面端版本可能随官方更新而变动,如果想获取更多AI相关的资讯可以收藏关注本站。