说明 这篇教程是写给谁的?答案很简单:如果你想在 Windows 10/11、Linux 或 Mac 系统上成功部署 OpenClaw,那么这篇指南就是为你准备的。 需要先明确一个关键概念:这里说的“终端”到底是什么?对于 Windows 用户而言,指的是命令提示符(CMD);而在 Linux 或
OpenClaw安装指南与步骤详解
时间:2026-05-06
浏览:112
文章目录
说明
这篇教程是写给谁的?答案很简单:如果你想在 Windows 10/11、Linux 或 Mac 系统上成功部署 OpenClaw,那么这篇指南就是为你准备的。
需要先明确一个关键概念:这里说的“终端”到底是什么?对于 Windows 用户而言,指的是命令提示符(CMD);而在 Linux 或 Mac 系统下,指的就是 Bash Shell 终端。

文章目录
- 依赖环境安装(git、nodejs)
- 安装git
- 安装nodejs
- OpenClaw正式安装
- windows安装
- mac/linux安装
依赖环境安装(git、nodejs)
万事开头难,第一步是把地基打好。安装 OpenClaw 之前,你需要先准备好两个必不可少的工具:Git 和 Node.js。
安装git
首先来解决 Git。它的下载地址非常简单直观,直接前往 Git 的官方下载页面即可。
安装nodejs
接下来是 Node.js。安装过程相当友好——直接下载对应的安装包,一路点击“下一步”采用默认选项就行。记住它的下载地址:Node.js 官网。
这里有一个非常关键的预检步骤:由于安装 OpenClaw 时需要从 GitHub 拉取代码,所以务必先检查一下 github.com 能否正常访问。如果连不上,那后续所有步骤都是空中楼阁。先把网络访问的问题解决,再继续推进。
OpenClaw正式安装
基础环境齐备,现在进入正题——安装 OpenClaw 本身。不同系统的安装路径略有不同,请对号入座。
windows安装
你需要以管理员身份打开 CMD 命令行窗口,然后执行下面两条命令中的任意一条。
# 标准安装命令
npm i -g openclaw@latest --registry=https://registry.npmmirror.com
当然,实际操作中难免会遇到意外。如果你在执行上述命令时看到了长长的报错信息——比如下面这种关于 node-llama-cpp 和 CMake 的错误——不必慌张。
C:\Windows\system32>npm i -g openclaw@latest --registry=https://registry.npmmirror.com
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
npm warn cleanup Failed to remove some directories [
...
npm error [node-llama-cpp] Failed to build llama.cpp with no GPU support. Error: SpawnError: Command npm exec --yes -- xpm@^0.16.3 install @xpack-dev-tools/cmake@latest --no-save exited with code 4294963238
...
这通常是某些底层依赖编译时出了问题。解决办法也很直接:换用下面这条带忽略脚本选项的命令来安装,往往能绕过这些棘手的编译错误。
# 如果上面一条执行出错,就执行带忽略脚本选项的命令
npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com
mac/linux安装
相比 Windows,在 Mac 或 Linux 系统上安装就优雅多了。只需要打开终端,输入下面这一行命令,然后喝口咖啡等待即可。
curl -fsSL https://openclaw.ai/install.sh | bash
执行过程中,终端可能会出现一些警告信息,这属于正常现象,一般直接忽略就行,不会影响最终安装结果。
那么,如何确认安装是否成功了呢?方法很简单。在命令行中继续输入:
openclaw --version
如果屏幕上清晰地返回了一个版本号,比如 “2026.x.xx”,那么恭喜你,OpenClaw 已经稳稳地在你的系统里安家了。

结束语
Flutter 是一个由 Google 开发的开源 UI 工具包,它的魅力在于能让你用一套代码,在不同平台上构建出高质量、美观的原生应用界面,省去了大量编写平台特定代码的烦恼。我将持续学习和深入研究 Flutter 的方方面面。从基础入门到高级技巧,从 UI 设计到性能优化,欢迎关注并一起讨论学习,共同踏入 Flutter 的精彩世界!
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。