openClaw安装

5 阅读3分钟

安装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选择飞书的配置:

docs.openclaw.ai/channels/fe…

根据文档提前创建飞书应用。

安装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配置。就可以了

官方说明文档:

docs.openclaw.ai/zh-CN

最好使用英文版的。内容更多。安装遇到问题最好先查官方文档。因为在网上其他地方查询的问题可能是由于不同版本导致的。解决方法不一样。官方文档通常是最新版本的说明