Rocky Linux 安装 OpenClaw 完整教程
OpenClaw 是一个强大的AI助手框架,可以让你的AI助手通过多种渠道(如Telegram、Discord、飞书等)与您交互。本教程将详细介绍如何在Rocky Linux系统上安装和配置OpenClaw。
前置要求
在开始安装之前,请确保您具备以下条件:
- 一台运行Rocky Linux 8或9版本的服务器/电脑
- root权限或sudo访问权限
- 稳定的网络连接
- 基本的Linux命令行操作知识
第一步:更新系统
首先,确保您的系统是最新的:
sudo dnf update -y
等待更新完成后,建议重启系统:
sudo reboot
第二步:安装必要依赖
OpenClaw基于Node.js开发,需要安装Node.js和npm。Rocky Linux提供了多种安装方式。
安装Node.js 20.x
Rocky Linux 8/9默认的Node.js版本可能较旧,建议安装较新的LTS版本:
# 安装NodeSource仓库
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
# 安装Node.js
sudo dnf install -y nodejs
验证安装:
node --version
npm --version
安装Git和其他必要工具
sudo dnf install -y git curl wget
第三步:安装OpenClaw CLI
OpenClaw可以通过npm全局安装:
sudo npm install -g openclaw
安装完成后,验证版本:
openclaw --version
您应该能看到类似以下的输出:
🦞 OpenClaw 2026.4.21 (f788c88)
第四步:初始化配置
安装完成后,首次运行需要进行基础配置:
openclaw setup
这个命令会引导您完成以下配置:
- 创建工作区:选择存放配置和数据的目录
- 配置Gateway:设置WebSocket网关的端口(默认8787)
- 选择渠道:配置您想要使用的聊天渠道(Telegram、Discord、飞书等)
手动配置(可选)
如果您更喜欢手动配置,可以:
# 查看配置选项
openclaw config --help
# 手动设置配置
openclaw config set gateway.port 8787
第五步:启动Gateway服务
OpenClaw使用Gateway作为核心服务,需要先启动它。
方式一:直接运行
openclaw gateway
方式二:作为系统服务运行(推荐)
创建systemd服务文件:
sudo tee /etc/systemd/system/openclaw.service > /dev/null <
启用并启动服务:
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
检查服务状态:
sudo systemctl status openclaw
第六步:配置聊天渠道
根据您的需求配置相应的聊天渠道。以下是几种常用渠道的配置方法:
Telegram
- 联系 @BotFather 创建机器人,获取API Token
- 配置Telegram渠道:
openclaw channels login telegram
按照提示输入Token即可。
Discord
- 在Discord开发者门户创建应用和机器人
- 获取机器人Token
- 配置Discord:
openclaw channels login discord
飞书(Lark)
openclaw channels login feishu
需要配置飞书开放平台应用并获取App ID和App Secret。
第七步:验证安装
完成以上步骤后,验证OpenClaw是否正常工作:
# 检查Gateway状态
openclaw status
# 测试健康检查
openclaw health
如果一切正常,您应该能看到Gateway正在运行,并且渠道已连接。
常见问题解决
端口被占用
如果遇到端口占用错误:
# 查找占用端口的进程
sudo lsof -i :8787
# 或者使用其他端口启动
openclaw gateway --port 8788
Node.js版本问题
如果遇到兼容性问题,请确保使用的是Node.js 18.x或更高版本:
# 检查Node版本
node --version
# 如需更新,请参考第二步重新安装
权限问题
如果遇到权限错误:
# 检查OpenClaw目录权限
ls -la /root/.openclaw
# 如需修复
sudo chown -R $USER:$USER /root/.openclaw
高级配置
配置模型提供商
OpenClaw支持多种AI模型提供商:
# 查看可用模型
openclaw models list
# 配置OpenAI
openclaw config set providers.openai.key YOUR_API_KEY
# 配置本地模型(如Ollama)
openclaw config set providers.ollama.url http://localhost:11434
配置安全策略
# 查看安全选项
openclaw security --help
# 配置执行策略
openclaw exec-policy set --scope node --policy allow
使用Docker运行(可选)
如果您更喜欢使用Docker:
# 拉取镜像
docker pull openclaw/openclaw
# 运行容器
docker run -d \
--name openclaw \
-p 8787:8787 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw
总结
恭喜!您已经成功在Rocky Linux上安装了OpenClaw。现在您可以:
- 通过配置的渠道与AI助手交互
- 使用OpenClaw的各种功能(如文件管理、代码执行等)
- 根据需要扩展更多渠道和功能
如需更多帮助,请查阅官方文档:https://docs.openclaw.ai
祝您使用愉快!













暂无评论内容