跳到主要内容OpenClaw 在 WSL Ubuntu 及 CentOS 虚拟机安装与飞书对接教程 | 极客日志Shell / BashNode.jsAI
OpenClaw 在 WSL Ubuntu 及 CentOS 虚拟机安装与飞书对接教程
OpenClaw 在 WSL Ubuntu 和 CentOS 9 虚拟机的安装配置流程,涵盖 Node.js 环境搭建、脚本安装修复常见报错及飞书插件对接步骤。重点解决节点版本兼容性、模块缺失及认证卡住等问题,提供命令行操作指南。
目前最简单安装方式是一行脚本一键安装。本文主要讲述使用脚本安装前遇到的问题及解决方案,特别是全新虚拟机部署场景。对接飞书功能推荐参考 Ubuntu 版。
需要一提的是,在大模型选择 qwen 时,认证步骤虚拟机(linux 且有可视化界面的环境,在认证时没有唤起浏览器导致一直卡住流程无法继续),之所以还保留虚拟机教程,是觉得如果是通过 api key 方式的大模型(不依赖外部环境的配置)应该可以通过,需要自行验证。
CentOS 9 版 (VMware Linux 虚拟机环境)
前置必要环境:Node.js >= 22
- 首先一台新的虚拟机需要配置资源地址(单纯安装 OpenClaw 这一步可以跳过)。
发现都是没用的配置文件,这个配置下载不下来 Node,当然你的 Linux 也不一定是这配置,没有则忽略。
所以这里选择删除(注意生产环境绝对不能无脑跟着删除,一定要清楚自己在做什么,否则别删):
sudo rm -f /etc/yum.repos.d/nodesource-*.repo
安装并启用 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*
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
如果通过其它方式安装的,在以下目录可能有残留,也需要删除:
rm -rf ~/.npm
rm -rf ~/.node-gyp
rm -rf ~/.nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install 22 --lts
node -v
安装 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,所以导致了报错。
sudo cp $(which openclaw) $(which openclaw).backup
sudo sed -i 's|/dist/entry.js|/dist/entry.mjs|g' $(which openclaw)
cat $(which openclaw)
openclaw onboard --install-daemon
Ubuntu 版 (Windows WSL 子系统环境)
(WSL 子系统安装方式如果不熟悉,自行搜索 WSL,在 Docker 的文章里面有提到,本文仅假设已有 WSL 的 Ubuntu 系统)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
- 下载 Node.js 22 (上一步骤指定了 22 版本):
sudo apt-get install -y nodejs
- (若没) 安装 Pnpm
先验证环境是否有 pnpm:
curl -fsSL https://get.pnpm.io/install.sh | sh -
- 执行 OpenClaw 官方提供的脚本:
【注:OpenClaw 迭代实在太快了,以下命令可能随时会变化,务必关注官网变更】
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
- 刷新配置文件,使得环境变量等配置生效 (主要是因为第 7 步出现了 openclaw command not found 时需要刷新):
openclaw onboard --install-daemon
openclaw gateway --port 18789 --verbose
这时候我们访问 127.0.0.1:18789 即可进入控制台 (在 Linux 命令行界面,会打印出 token 是什么,给出具体网址)。
openclaw plugins install @m1heng-clawd/feishu
openclaw config set channels.feishu.appId "你的 appId"
openclaw config set channels.feishu.appSecret "你的 appSecret"
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,开通群消息权限。
- 重启 Gateway
(在子系统的话就是先按 Ctrl+C 结束再启动一遍):
openclaw gateway --port 18789 --verbose
回到飞书客户端,此时开发小助手会发消息,点打开应用即可。
重要命令
vim ~/.openclaw/openclaw.json
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
- HTML转Markdown
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online