OpenClaw 在 WSL Ubuntu 和 CentOS 9 虚拟机的安装配置流程，涵盖 Node.js 环境搭建、脚本安装修复常见报错及飞书插件对接步骤。重点解决节点版本兼容性、模块缺失及认证卡住等问题，提供命令行操作指南。
目前最简单安装方式是一行脚本一键安装。本文主要讲述使用脚本安装前遇到的问题及解决方案，特别是全新虚拟机部署场景。对接飞书功能推荐参考 Ubuntu 版。
需要一提的是，在大模型选择 qwen 时，认证步骤虚拟机（linux 且有可视化界面的环境，在认证时没有唤起浏览器导致一直卡住流程无法继续），之所以还保留虚拟机教程，是觉得如果是通过 api key 方式的大模型（不依赖外部环境的配置）应该可以通过，需要自行验证。
当前配置查看：
# 先 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
如果之前通过 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
如果通过其它方式安装的，在以下目录可能有残留，也需要删除：
# 检查并删除用户本地目录下的 Node 相关文件
rm -rf ~/.npm
rm -rf ~/.node-gyp
# 如果你之前装过 NVM 但失败了，也清理掉
rm -rf ~/.nvm
NVM 方式安装 Node.js 22：
# 1. 安装 NVM（一个独立的管理器，不干扰系统）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 2. 关闭并重新打开终端，或立即加载 NVM
source ~/.bashrc
# 3. 使用 NVM 安装 Node.js v22
nvm install 22 --lts
# 4. 验证安装
node -v # 应输出 v22.x.x
执行命令：
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
接下来按照指引即可。
(WSL 子系统安装方式如果不熟悉，自行搜索 WSL，在 Docker 的文章里面有提到，本文仅假设已有 WSL 的 Ubuntu 系统)
apt-get update
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
pnpm -v
如果没有则安装：
curl -fsSL https://get.pnpm.io/install.sh | sh -
安装之后再次验证：
pnpm -v
刷新 xxx 是路径，这边是自动提示了全路径：
source /xxx/xxx/.bashrc
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
source ~/.bashrc
openclaw onboard --install-daemon
openclaw gateway --port 18789 --verbose
这时候我们访问 127.0.0.1:18789 即可进入控制台 (在 Linux 命令行界面，会打印出 token 是什么，给出具体网址)。
openclaw plugins install @m1heng-clawd/feishu
进入飞书 https://open.feishu.cn/ 后台。
记住这个 appId 和 secret。
openclaw config set channels.feishu.appId "你的 appId"
openclaw config set channels.feishu.appSecret "你的 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
回到飞书配置权限：
并且分别搜搜 im:message 和 contact:user.base:readonly，开通群消息权限。
openclaw gateway --port 18789 --verbose
(在正常服务器可以使用重启命令)：
openclaw gateway restart
回到飞书客户端，此时开发小助手会发消息，点打开应用即可。
OpenClaw 的核心配置文件：
vim ~/.openclaw/openclaw.json
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online