OpenClaw安装指南与步骤详解

作者:技术拾光

时间:2026-05-06

浏览:112

说明 这篇教程是写给谁的?答案很简单:如果你想在 Windows 10/11、Linux 或 Mac 系统上成功部署 OpenClaw,那么这篇指南就是为你准备的。 需要先明确一个关键概念:这里说的“终端”到底是什么?对于 Windows 用户而言,指的是命令提示符(CMD);而在 Linux 或

文章目录

说明

这篇教程是写给谁的?答案很简单:如果你想在 Windows 10/11、Linux 或 Mac 系统上成功部署 OpenClaw,那么这篇指南就是为你准备的。

需要先明确一个关键概念:这里说的“终端”到底是什么?对于 Windows 用户而言,指的是命令提示符(CMD);而在 Linux 或 Mac 系统下,指的就是 Bash Shell 终端。

OpenClaw安装指南与步骤详解

文章目录

  • 依赖环境安装(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 已经稳稳地在你的系统里安家了。

OpenClaw安装指南与步骤详解


结束语
Flutter 是一个由 Google 开发的开源 UI 工具包,它的魅力在于能让你用一套代码,在不同平台上构建出高质量、美观的原生应用界面,省去了大量编写平台特定代码的烦恼。我将持续学习和深入研究 Flutter 的方方面面。从基础入门到高级技巧,从 UI 设计到性能优化,欢迎关注并一起讨论学习,共同踏入 Flutter 的精彩世界!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›