【openclaw】wsl子系统Ubuntu + 虚拟机centos9安装openclaw 以及对接飞书教程解决安装期间的报错

Ne0inhk

14 Mar 2026 — 8 min read

目前最简单安装方式就是一行脚本一键安装，如果能安装成功，那自然是万事大吉，而本文恰恰主要讲述使用脚本安装之前遇到的问题,因为博主是在一台全新的虚拟机上面部署所以遇到的问题会比较典型全面。对接飞书在Ubuntu版，想避免走弯路的同学可以直接参考ubuntu。

需要一提的是，在大模型选择qwen时，认证步骤虚拟机（linux且有可视化界面的环境，在认证时没有唤起浏览器导致一直卡住流程无法继续），之所以还保留虚拟机教程，是觉得如果是通过api key方式的大模型（不依赖外部环境的配置）应该可以通过需要自行验证

文章目录

centos os9版(vmware linux虚拟机环境) [坑多]
- 前置必要环境：nodejs >=22
- 安装openclaw
Ubuntu版 (windows wsl子系统环境) [本文建议]
重要命令

centos os9版(vmware linux虚拟机环境) [坑多]

前置必要环境：nodejs >=22

首先一台新的虚拟机需要配置资源地址
(单纯安装openclaw这一步可以跳过)

当前配置查看：

# 先 cd /etc 目录[root@localhost etc]# ls -la /etc/yum.repos.d/

发现都是没用的配置文件这个配置下载不下来node 当然你的linux也不一定是这配置没有则忽略

总用量 32 drwxr-xr-x. 2 root root 111 1月 31 17:12 . drwxr-xr-x. 132 root root 8192 1月 31 17:09 .. -rw-r--r--. 1 root root 4245 7月 11 2025 centos-addons.repo -rw-r--r--. 1 root root 2600 7月 11 2025 centos.repo -rw-r--r--. 1 root root 262 1月 31 16:53 nodesource-nodejs.repo -rw-r--r--. 1 root root 262 1月 31 16:53 nodesource-nsolid.repo

所以这里选择删除（注意生产环境绝对不能无脑跟着删除一定要清楚自己在做什么否则别删）

sudorm -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

安装nodejs 【重点】
由于种种原因现在centos已经不能直接yum install nodejs新版本了停留在了16版本，所以我们需要用别的方式下载

如果之前通过 dnf/yum 的方式下载过旧版本nodejs 需要删除：

sudo dnf remove -y nodejs npm

如果是你个人测试的服务器/虚拟机，可以手动删干净点：

sudorm -rf /usr/lib/node_modules sudorm -rf /usr/local/lib/node_modules sudorm -rf /var/cache/yum/*node* # 删除Node.js和npm的符号链接（如果存在）sudorm -f /usr/local/bin/node sudorm -f /usr/local/bin/npm sudorm -f /usr/bin/node sudorm -f /usr/bin/npm

如果通过其它方式安装的在以下目录可能有残留也需要删除

# 检查并删除用户本地目录下的Node相关文件rm -rf ~/.npm rm -rf ~/.node-gyp # 如果你之前装过NVM但失败了，也清理掉rm -rf ~/.nvm

nvm方式安装nodejs 22

# 1. 安装NVM（一个独立的管理器，不干扰系统）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh |bash# 2. 关闭并重新打开终端，或立即加载NVMsource ~/.bashrc # 3. 使用NVM安装Node.js v22 nvm install22 --lts # 4. 验证安装node -v # 应输出 v22.x.x

安装openclaw

执行命令：

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

(有可能你在某些地方看到的是下面命令其实就是域名区别现在官方最新域名是上面的↑)

# 不用再执行这条了curl -fsSL https://molt.bot/install.sh |bash -s -- --install-method git

执行命令等待安装，路径默认位于/root/openclaw

(如果不是centos,例如博主在kali上面执行就会遇到各种各样的问题看起来是pnpm有东西下载不下来博主不是前端看到这些问题实在头大)

安装完成之后执行：

pnpm install pnpm run build

接下来执行：

openclaw onboard --install-daemon

这里可能报错(具体会不会报错取决于官方有没有修复目前博主写文章的时间，正处于openclaw快速迭代版本的时候)
Error: Cannot find module '/root/openclaw/dist/entry.js'

如果报错了则是官方的脚本有个bug，这对本就不是很懂前端的博主来说雪上加霜，不过好在问题排查出来了：
假设当前位于openclaw目录下，cd ./dist 看到只有entry.mjs文件，并没有entry.js 所以导致了报错

# 1. （可选但推荐）备份原始脚本 sudo cp $(which openclaw) $(which openclaw).backup # 2. 使用sed命令直接修改脚本，将 entry.js 替换为 entry.mjs sudo sed -i 's|/dist/entry.js|/dist/entry.mjs|g' $(which openclaw) # 3. 确认修改是否成功 cat $(which openclaw) # 4. 再次执行 openclaw onboard --install-daemon

(2026.1.31存在bug 2026.2.1当博主换环境验证时发现官方已修复)

接下来按照指引即可

Ubuntu版 (windows wsl子系统环境) [本文建议]

（wsl子系统安装方式如果不熟悉自行在博主博客主页搜索wsl 在docker的文章里面有提到，本文仅假设已有wsl的Ubuntu系统）

apt升级：

apt-get update

添加资源路径：

curl -fsSL https://deb.nodesource.com/setup_22.x |sudo -E bash -

下载nodejs 22 (上一步骤指定了22版本)

sudoapt-getinstall -y nodejs

（若没）安装pnpm
先验证环境是否有pnpm

pnpm -v

如果没有则安装：

curl -fsSL https://get.pnpm.io/install.sh | sh -

安装之后再次验证

pnpm -v

刷新 xxx是路径博主这边是自动提示了全路径

source /xxx/xxx/.bashrc

执行openclaw官方提供的脚本：
【注：openclaw迭代实在太快了以下命令可能随时会变化务必关注官网变更】

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

刷新配置文件使得环境变量等配置生效 (主要是因为第7步出现了openclaw command not found时需要刷新)

source ~/.bashrc

支持安装board命令

openclaw onboard --install-daemon

安装完毕之后启动gateway:

openclaw gateway --port 18789 --verbose

这时候我们访问127.0.0.1:18789 即可进入控制台（在linux命令行界面会打印出token是什么给出具体网址）

安装飞书插件

 openclaw plugins install @m1heng-clawd/feishu

进入飞书 https://open.feishu.cn/ 后台

记住这个appId和secret

回到linux命令行

openclaw config set channels.feishu.appId "xxx上面截图中的appId" openclaw config set channels.feishu.appSecret "xxxx上面截图中的appSecret"# 推荐使用websocket (以下命令是参考前人的 使用websocket连接) openclaw config set channels.feishu.connectionMode websocket openclaw config set channels.feishu.dmPolicy pairing openclaw config set channels.feishu.groupPolicy allowlist openclaw config set channels.feishu.requireMention true

回到飞书配置权限：