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

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

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

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

一、安装 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 命令没有反应
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 基于C++的多项式曲线拟合代码实现与实战
  • Stable Diffusion 模型技术深度解析
  • OpenClaw 本地部署及飞书远程控制配置指南
  • 最长递增子序列:动态规划与贪心解法
  • VSCode GitHub Copilot 登录卡顿问题解决方案
  • C++ 数据结构:哈希表原理及 STL 实现
  • 龙芯内核配置指南及引脚分配方案(适配龙邱库)
  • GitHub Copilot Agent 模式配置与使用技巧
  • 开源 AI 编程工具选型对比:OpenCode 与 GitHub Copilot
  • 使用 OpenClaw 集成飞书构建专属 AI 机器人指南
  • Dify 工作流发布为 MCP Server 实战指南
  • GESP C++ 一级真题解析:数字替换
  • Python 模块与包导入机制详解
  • OpenClaw Windows 安装配置教程:Node.js 22、Kimi 模型与飞书机器人集成
  • C++ 搜索引擎通用工具模块:文件读取与分词实现
  • 今日必读:8 篇大模型前沿论文解读
  • Web 自动化测试入门指南:从概念到 Selenium 实战
  • Spring Boot 4.0 十字路口:虚拟线程时代,WebFlux 与 WebMVC 的选择
  • LRU 缓存数据结构设计与实现:LinkedHashMap 与手写方案
  • 从记忆化搜索到动态规划:DP 核心思想与实战解析

相关免费在线工具

  • 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