【OpenClaw 安装教程:Windows/macOS/Linux 全平台保姆级指南】

【OpenClaw 安装教程:Windows/macOS/Linux 全平台保姆级指南】svg xmlns http www w3 org 2000 svg style display none svg

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg> 

GPT plus 代充 只需 145

OpenClaw(俗称“小龙虾”)是一款开源的个人 AI 助手项目,由 PSPDFKit 创始人 Peter Steinberger 开发。与传统聊天 AI 不同,OpenClaw 不仅能回答问题,还能主动操作系统、访问网页、处理邮件、整理文件、发送消息等,真正实现“会动手干活的 AI”。

本文将详细介绍在 Windows、macOS 和 Linux 三大平台上安装 OpenClaw 的完整步骤,适合零基础用户快速上手。


1.1 系统要求

在开始安装之前,请确保你的电脑满足以下基本要求:

配置项 最低要求 推荐配置 操作系统 Windows 10/11、macOS 10.15+、主流 Linux 发行版 Windows 11、macOS 12+、Ubuntu 20.04+ 内存 16GB 32GB 或更高 存储空间 2-4GB 10GB 以上 网络 稳定的互联网连接 高速网络

1.2 必要软件

OpenClaw 基于 Node.js 开发,需要以下软件支持:

  • Node.js:v20.x 或更高版本(推荐 v22.x LTS 版本)
  • Git:用于克隆仓库和安装技能(部分功能需要)
  • PowerShell(Windows):用于执行安装脚本

2.1 方法一:使用官方一键脚本(推荐)

这是最简单快速的安装方式,适合大多数用户。

步骤 1:以管理员身份运行 PowerShell
  1. 按 键,选择“Windows PowerShell (管理员)“或”终端 (管理员)”
  2. 如果出现用户账户控制(UAC)提示,点击“是”
步骤 2:设置执行策略

首次运行 PowerShell 脚本需要修改执行策略:

讯享网

出现提示时输入 并回车确认。

步骤 3:执行安装脚本

复制以下命令并粘贴到 PowerShell 中,按回车执行:

 
     

国内用户加速版(如果官方脚本速度慢,可使用国内镜像):

讯享网
步骤 4:等待安装完成

安装过程会自动完成以下操作:

  • 检测并安装 Node.js(如果未安装)
  • 安装 OpenClaw 核心程序
  • 配置环境变量
  • 安装必要的依赖

整个过程通常需要 3-8 分钟,请耐心等待。

步骤 5:验证安装

安装完成后,运行以下命令验证:

 
     

如果输出了版本号,说明安装成功!

讯享网

查看帮助信息,了解可用命令。


2.2 方法二:手动安装(适合高级用户)

如果你已经熟悉 Node.js 环境,可以选择手动安装。

步骤 1:安装 Node.js
  1. 访问 Node.js 官网
  2. 下载 LTS 版本(推荐 v22.x)
  3. 运行安装程序,按提示完成安装
  4. 验证安装:
 
      
步骤 2:安装 Git(可选但推荐)
  1. 访问 Git 官网
  2. 下载 Windows 版本安装程序
  3. 运行安装程序,使用默认设置即可
步骤 3:全局安装 OpenClaw

打开 PowerShell(管理员权限),执行:

讯享网

国内用户加速安装

 
      
步骤 4:验证安装
讯享网

2.3 方法三:使用国内版 openclaw-cn

国内用户推荐使用 ,针对国内网络环境优化:

 
       

验证安装:

讯享网

3.1 方法一:使用官方一键脚本(推荐)

步骤 1:打开终端
  1. 按 打开 Spotlight 搜索
  2. 输入“终端”或“Terminal”
  3. 按回车打开终端
步骤 2:执行安装脚本

复制以下命令并粘贴到终端中,按回车执行:

 
        

国内用户加速版

讯享网
步骤 3:等待安装完成

脚本会自动检测系统环境并安装所需组件,包括:

  • Homebrew(如果未安装)
  • Node.js
  • OpenClaw 核心程序
步骤 4:验证安装
 
        

3.2 方法二:使用 Homebrew 手动安装

步骤 1:安装 Homebrew(如果未安装)
讯享网

安装完成后,根据提示将 Homebrew 添加到 PATH:

 
         
步骤 2:安装 Node.js
讯享网

验证安装:

 
         
步骤 3:安装 Git(如果未安装)
讯享网
步骤 4:全局安装 OpenClaw
 
         

国内用户加速安装

讯享网
步骤 5:验证安装
 
         

3.3 方法三:使用国内版 openclaw-cn

讯享网

验证安装:

 
          

4.1 方法一:使用官方一键脚本(推荐)

步骤 1:打开终端

根据你的 Linux 发行版,使用快捷键打开终端:

  • Ubuntu/Debian:
  • Fedora:
  • 其他发行版:在应用菜单中搜索“终端”
步骤 2:更新系统包管理器

Ubuntu/Debian

讯享网

Fedora

 
           

Arch Linux

讯享网
步骤 3:安装必要的依赖

Ubuntu/Debian

 
           

Fedora

讯享网

Arch Linux

 
           
步骤 4:执行安装脚本
讯享网

国内用户加速版

 
           
步骤 5:等待安装完成

脚本会自动安装:

  • Node.js(通过 nvm 或包管理器)
  • OpenClaw 核心程序
  • 必要的系统依赖
步骤 6:验证安装
讯享网

4.2 方法二:使用包管理器手动安装

步骤 1:安装 Node.js

Ubuntu/Debian(使用 NodeSource)

 
            

Fedora

讯享网

Arch Linux

 
            
步骤 2:安装 Git

Ubuntu/Debian

讯享网

Fedora

 
            

Arch Linux

讯享网
步骤 3:全局安装 OpenClaw
 
            

国内用户加速安装

讯享网
步骤 4:配置环境变量(如果需要)

如果运行 命令提示找不到命令,需要将 npm 全局安装路径添加到 PATH:

 
            
步骤 5:验证安装
讯享网

4.3 方法三:使用 nvm 安装 Node.js(推荐开发者)

步骤 1:安装 nvm(Node Version Manager)
 
             
步骤 2:重新加载配置文件
讯享网
步骤 3:安装最新 LTS 版本的 Node.js
 
             
步骤 4:全局安装 OpenClaw
讯享网
步骤 5:验证安装
 
             

安装完成后,首次使用需要进行初始化配置。

5.1 启动 OpenClaw

在终端或 PowerShell 中运行:

讯享网

5.2 配置向导

首次启动时,OpenClaw 会引导你完成以下配置:

  1. 选择 AI 模型提供商
    • OpenAI(需要 API Key)
    • Anthropic Claude(需要 API Key)
    • 本地模型(如 Ollama)
    • 其他兼容 OpenAI API 的服务
  2. 配置 API Key
    • 输入你的 API Key
    • 选择默认模型
  3. 设置工作目录
    • 选择 OpenClaw 的工作目录
    • 默认为 或
  4. 配置技能仓库
    • 选择是否启用社区技能
    • 配置 ClawHub(技能市场)

5.3 测试运行

配置完成后,可以尝试运行一个简单的命令:

 
              

6.1 Windows 常见问题

问题 1:PowerShell 执行策略错误

讯享网

解决方案

 
               

问题 2:找不到 openclaw 命令

解决方案

  1. 重启 PowerShell 或终端
  2. 检查环境变量 PATH 是否包含 npm 全局安装路径
  3. 手动添加路径:
讯享网

问题 3:npm 安装速度慢

解决方案:使用国内镜像源

 
               

6.2 macOS 常见问题

问题 1:权限被拒绝

解决方案

讯享网

问题 2:Homebrew 安装失败

解决方案

  1. 确保网络连接正常
  2. 使用国内镜像安装 Homebrew:
 
                

问题 3:命令找不到

解决方案

检查 Shell 配置文件( 或 ),确保 PATH 配置正确。


6.3 Linux 常见问题

问题 1:权限不足

解决方案

讯享网

或配置 npm 全局安装目录权限:

 
                 

问题 2:Node.js 版本过低

解决方案:使用 nvm 安装最新版本

讯享网

问题 3:依赖包编译失败

解决方案:安装编译工具

Ubuntu/Debian

 
                 

Fedora

讯享网

6.4 通用问题

问题 1:网络连接失败

解决方案

  1. 检查网络连接
  2. 使用代理或 VPN
  3. 使用国内镜像源

问题 2:安装后无法启动

解决方案

  1. 检查日志文件:
  2. 重新安装:
 
                  
  1. 清除缓存:
讯享网

问题 3:API Key 配置错误

解决方案

重新配置 API Key:

 
                  

如果需要卸载 OpenClaw,可以按照以下步骤操作:

7.1 Windows

讯享网

删除配置文件和数据:

 
                   

7.2 macOS/Linux

讯享网

删除配置文件和数据:

 
                   

8.1 配置本地模型(Ollama)

如果你想在本地运行 AI 模型,可以配置 Ollama:

步骤 1:安装 Ollama

访问 Ollama 官网 下载并安装。

步骤 2:拉取模型
讯享网
步骤 3:配置 OpenClaw 使用本地模型
 
                    

8.2 配置代理

如果需要通过代理访问 OpenAI API:

讯享网

8.3 安装技能

OpenClaw 支持通过 ClawHub 安装各种技能:

 
                    

  • 官网:https://openclaw.ai
  • 官方文档:https://docs.openclaw.ai
  • GitHub 仓库:https://github.com/openclaw/openclaw
  • 技能市场:https://clawhub.com
  • 社区 Discord:https://discord.com/invite/clawd

OpenClaw 是一款功能强大的本地 AI 助手,通过本文提供的安装教程,你应该能够在 Windows、macOS 或 Linux 平台上成功安装并配置 OpenClaw。

安装要点回顾:

  1. Windows:推荐使用 PowerShell 一键脚本,记得先设置执行策略
  2. macOS:推荐使用 Homebrew 或官方脚本,确保安装了 Xcode 命令行工具
  3. Linux:根据发行版选择合适的包管理器,推荐使用 nvm 管理 Node.js 版本

下一步建议:

  1. 配置你的 AI 模型 API Key 或本地模型
  2. 探索 ClawHub 技能市场,安装你需要的技能
  3. 阅读 官方文档 了解更多高级功能
  4. 加入社区 Discord,与其他用户交流经验

如果你在安装过程中遇到问题,可以查阅官方文档或在社区寻求帮助。祝你在使用 OpenClaw 的过程中获得愉快的体验!


小讯
上一篇 2026-03-10 22:59
下一篇 2026-03-10 23:01

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/212152.html