Rocky Linux 安装 OpenClaw 完整教程

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

这个命令会引导您完成以下配置:

  1. 创建工作区:选择存放配置和数据的目录
  2. 配置Gateway:设置WebSocket网关的端口(默认8787)
  3. 选择渠道:配置您想要使用的聊天渠道(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

  1. 联系 @BotFather 创建机器人,获取API Token
  2. 配置Telegram渠道:
openclaw channels login telegram

按照提示输入Token即可。

Discord

  1. 在Discord开发者门户创建应用和机器人
  2. 获取机器人Token
  3. 配置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

祝您使用愉快!

© 版权声明
THE END
喜欢就支持一下吧
点赞15 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容