安装openClaw:
操作系统:
Ubuntu64-24.04.4
nodejs:
v24.14.0
安装nodejs
如果没有安装nodejs可以先安装:
sudo apt update
sudo apt upgrade
sudo apt install -y nodejs npm
默认安装的版本可能比较低。安装完成之后一定要看一下版本
node -v
如果版本低重新安装:
sudo apt install -y curl
curl -fsSL deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt install -y nodejs
安装过程可能需要一些插件。需要 go环境。所以提前安装一下
sudo apt-get install golang-go
安装 openClaw
以上完成之后正式安装openclaw 执行:
curl -fsSL openclaw.ai/install.sh | bash
命令执行之后下载安装包,然后根据说明安装就可以。
如果中途遇到一些问题强制结束。如果安装包已经下载完成,后期可以通过:
openclaw onboard
命令重新配置
首先配置模型
根据个人已经申请的模型进行配置。
channel选择飞书的配置:
根据文档提前创建飞书应用。
安装skills:
安装完成之后通过对话问openClaw:[skills安装路径是什么?]
我的是:/home/aaa/.openclaw/workspace/skills
将skill文件放到目录下。然后在对话里面问openClaw,安装了哪些skills。
确认是否加载刚刚安装的。如果open claw没有返回安装的。
则告诉他需要加载的skills名称。他会自动加载。不需要重新启动openClaw
飞书机器人
如果使用飞书机器人对话需要:
在飞书里面找到创建的机器人,任意发送一句话。会返回:
OpenClaw: access not configured. Your Feishu user id: ou_f1ac08e6caebcc62327935780404518c Pairing code: 2Q5N33KE Ask the bot owner to approve with: openclaw pairing approve feishu 2Q5N33KE
在openclaw执行命令:
openclaw pairing approve feishu 2Q5N33KE
如果没有返回查看openClaw安装飞书的文档,查看是否遗漏配置。飞书权限配置完成之后是否发布新的版本
遇到的问题汇总:
1、如果遇到 Error: systemctl is-enabled unavailable: Command failed: systemctl --user is-enabled openclaw-gateway.service。
则执行 openclaw doctor --fix ,然后再执行 systemctl --user is-enabled openclaw-gateway.service 即可。或者重新配置 openclaw,执行 openclaw onboard。
这个问题新的版本已经解决。
2、部署之后只有本机可以访问,其他机器不能。修改配置: 开启局域网访问:
bash openclaw config set gateway.bind lan
允许非安全/非本地认证(可选,部分版本需要):
bash openclaw config set gateway.controlUi.allowInsecureAuth true
重启服务生效: bash openclaw gateway restart
或者修改配置文件: 找到配置文件(通常位于 ~/.openclaw/openclaw.json 将你提供的 JSON 片段修改为: json
“gateway”: { “port”: 18789, “mode”: “remote”, // 建议将 mode 从 local 改为 remote “bind”: “lan”, // 关键:将 loopback 改为 lan (即绑定到 0.0.0.0) “auth”: { “mode”: “token”, “token”: “xxxx” } }
修改配置文件之后重启一下系统
3、第一次启动配置模型使用千问模型会自动启动浏览器验证,第一次会卡住。需要关闭安装程序。浏览器不要关闭。然后重新使用 openclaw onboard配置。就可以了
官方说明文档:
最好使用英文版的。内容更多。安装遇到问题最好先查官方文档。因为在网上其他地方查询的问题可能是由于不同版本导致的。解决方法不一样。官方文档通常是最新版本的说明