跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsAI

OpenClaw 在 Ubuntu 20.04 下的安装及 CMake 版本错误解决方案

综述由AI生成在 Ubuntu 20.04 系统上安装 OpenClaw 的步骤,重点解决了因 CMake 版本过低导致的安装报错问题。通过升级 CMake 至 3.19 以上版本并配置 Kitware 软件源,成功完成安装。此外,还涵盖了 OpenClaw 的配置流程,包括 MiniMax API Key 的设置以及终端命令无法识别时的路径修复方法。

云朵棉花糖发布于 2026/3/28更新于 2026/5/2432 浏览

一、安装 OpenClaw

1. Linux Ubuntu 安装命令

输入命令(前提是先安装 Node.js 和 npm):

curl -fsSL https://openclaw.ai/install.sh | bash

2. 常见报错

执行安装时可能遇到以下错误:

npm install failed for openclaw@latest Command: env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm --loglevel error --silent --no-fund --no-audit install -g openclaw@latest

3. 解决方案(升级 CMake)

调整使用命令安装 OpenClaw:

sudo npm i -g openclaw

详细报错如下:

npm error CMake 3.19 or higher is required. You are running version 3.16.3

说明 CMake 版本太低,尝试使用下面命令升级:

sudo apt install cmake

继续报错提示依赖关系未满足:

E: 有未能满足的依赖关系。

修复错误:

sudo apt --fix-broken install

4. 升级软件包列表

sudo apt update

5. 安装编译和构建软件所需的基础工具包

sudo apt install build-essential

6. 添加第三方软件源(Kitware)

用于在 Ubuntu 20.04 系统上添加第三方软件源 Kitware 的 APT 仓库,以便通过 apt 命令安装最新版本的 CMake 等工具。

下载并安装官方 GPG 密钥

wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /usr/share/keyrings/kitware-archive-keyring.gpg >/dev/null

添加 Kitware 软件源列表

echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ focal main' | sudo tee /etc/apt/sources.list.d/kitware.list

更新软件包列表

sudo apt update

7. 执行安装 CMake

sudo apt install cmake

8. 查询 CMake 版本

cmake --version

输出示例:

cmake version 4.2.3

这样就符合 OpenClaw 的要求了。

9. 重新安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

安装成功后会显示 OpenClaw 已成功安装。

二、配置 OpenClaw

安装时会要求配置 OpenClaw,以下是配置时的选项说明:

  1. 安全确认:I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? -> Yes
  2. Onboarding mode:QuickStart
  3. Gateway port:18789
  4. Model/auth provider:MiniMax
  5. MiniMax auth method:MiniMax M2.5
  6. How do you want to provide this API key?:Paste API key now
  7. Enter MiniMax API key:输入你的 API Key

获取 API Key 请前往 MiniMax 官网个人中心复制。

后续配置项可根据需求选择:

  • Channel status:Telegram, WhatsApp, Discord 等(默认 Skip for now)
  • Web search:Skip for now
  • Skills status:Configure skills now? -> Yes
  • Hooks:Enable hooks? -> Yes

配置完成后会弹出对话页面。

三、如果对话时报错

如果配置 OpenClaw 时报错,典型报错可能是 "HTTP 401 authentication_error: invalid api key"。

如果自己的 API Key 没有复制错误,请修改 base URL 为:https://api.minimaxi.com/anthropic

四、终端输入 OpenClaw 命令没有反应

配置路径:

export PATH="$HOME/.npm-global/bin:$PATH"
source ~/.bashrc

输入 OpenClaw 命令检查:

openclaw status

目录

  1. 一、安装 OpenClaw
  2. 1. Linux Ubuntu 安装命令
  3. 2. 常见报错
  4. 3. 解决方案(升级 CMake)
  5. 4. 升级软件包列表
  6. 5. 安装编译和构建软件所需的基础工具包
  7. 6. 添加第三方软件源(Kitware)
  8. 7. 执行安装 CMake
  9. 8. 查询 CMake 版本
  10. 9. 重新安装 OpenClaw
  11. 二、配置 OpenClaw
  12. 三、如果对话时报错
  13. 四、终端输入 OpenClaw 命令没有反应
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Python Django Flask Vue 公务员考试交流平台与复习系统
  • A* 算法深度解析:Hart, Nilsson, Raphael 1968 年论文核心思想
  • ToClaw:不是更会炫技的 AI,而是更容易上手的桌面工具
  • 算法实战:替换所有问号与提莫攻击解题思路
  • 前后端无感 Token 刷新:原理与 Spring Boot 实战
  • 时序数据库选型指南:Apache IoTDB 核心优势与实践
  • HTML Popover API 原生实现浮层交互,无需 JavaScript 依赖
  • 数据结构初阶:基于动态顺序表实现通讯录
  • 25 个实用 Prompt 帮助你降低 AI 生成内容检测率
  • Llama-2-7B 昇腾 NPU 测评:性能数据、场景适配与硬件选型
  • 七大 AIGC 测试工具横向评测:选型指南与实战分析
  • MediaPipe 与 ROS 集成:机器人动作交互系统部署
  • Spring AI 入门指南
  • Kimi K2.5 多模态与编程能力实测
  • SpringBoot 省级旅游口号管理系统设计与实现
  • 大模型混战时代互联网企业的转型与应对策略
  • 基于 MINGW 的跨平台 C++ 应用开发实战技巧
  • OpenClaw 开源 AI Agent 框架技术解析与实战指南
  • Web 聊天室消息加解密方案详解
  • 16 个必知必会的 Python 编程技巧

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online