目前最简单安装方式是一行脚本一键安装。本文主要讲述使用脚本安装前遇到的问题及解决方案,特别是全新虚拟机部署场景。对接飞书功能推荐参考 Ubuntu 版。
需要一提的是,在大模型选择 qwen 时,认证步骤虚拟机(linux 且有可视化界面的环境,在认证时没有唤起浏览器导致一直卡住流程无法继续),之所以还保留虚拟机教程,是觉得如果是通过 api key 方式的大模型(不依赖外部环境的配置)应该可以通过,需要自行验证。
CentOS 9 版 (VMware Linux 虚拟机环境)
前置必要环境:Node.js >= 22
- 首先一台新的虚拟机需要配置资源地址(单纯安装 OpenClaw 这一步可以跳过)。
当前配置查看:
# 先 cd /etc 目录
ls -la /etc/yum.repos.d/
发现都是没用的配置文件,这个配置下载不下来 Node,当然你的 Linux 也不一定是这配置,没有则忽略。
所以这里选择删除(注意生产环境绝对不能无脑跟着删除,一定要清楚自己在做什么,否则别删):
sudo rm -f /etc/yum.repos.d/nodesource-*.repo
安装并启用 EPEL 仓库(这是关键一步,它提供大量额外软件,且镜像在国内访问顺畅):
# 这个命令会从 CentOS 官方镜像下载并安装 epel-release 包,它会自动配置好可用的 EPEL 源
sudo dnf install -y epel-release
# 清理缓存并查找
sudo dnf clean all && sudo dnf makecache
- 安装 Node.js【重点】 由于种种原因,现在 CentOS 已经不能直接 yum install nodejs 新版本了,停留在了 16 版本,所以我们需要用别的方式下载。
如果之前通过 dnf/yum 的方式下载过旧版本 Node.js 需要删除:
sudo dnf remove -y nodejs npm
如果是你个人测试的服务器/虚拟机,可以手动删干净点:
sudo rm -rf /usr/lib/node_modules
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /var/cache/yum/*node*
# 删除 Node.js 和 npm 的符号链接(如果存在)
sudo rm -f /usr/local/bin/node
sudo rm -f /usr/local/bin/npm
sudo rm -f /usr/bin/node
sudo rm -f /usr/bin/npm

