开发者
鲲鹏开发板部署龙虾
鲲鹏开发板部署龙虾
原创
发表于04/12
5330

在鲲鹏开发板上部署 OpenClaw(俗称“龙虾”),本质上是在其 ARM64 架构的 Linux 操作系统环境中进行部署。整个过程可以分为三个主要阶段:环境准备、安装部署和配置启动。

以下是详细的部署操作指南。

📋 第一阶段:环境准备

在开始之前,请确保你的鲲鹏开发板满足以下基本配置要求。

检查项推荐配置最低配置说明
CPU 架构ARM64 (aarch64)ARM64鲲鹏处理器均为 ARM 架构
操作系统麒麟 V10 SP3 / openEuler麒麟 V10 / openEuler内核版本建议 > 4.19
内存 (RAM)32 GB8 GBNode.js 应用较消耗内存
磁盘空间50 GB (SSD 推荐)20 GB用于存放模型缓存、日志和依赖

1. 登录并检查环境

通过 SSH 或直连方式登录到你的鲲鹏开发板,并执行以下命令确认环境信息。

# 1. 查看操作系统版本
cat /etc/os-release
# 预期输出应包含 "Kylin Linux" 或 "openEuler"

# 2. 确认 CPU 架构 (必须是 aarch64)
uname -m
# 预期输出: aarch64

# 3. 查看内存情况
free -h

# 4. 检查当前用户权限 (建议使用 root 用户或具有 sudo 权限的普通用户)
whoami

2. 安装基础依赖

更新系统源并安装必要的开发工具。

# 切换到 root 用户 (如果使用普通用户,请在命令前加 sudo)
su -

# 更新系统元数据
yum clean all
yum makecache

# 安装基础工具,如 git, curl, gcc 等
yum install -y git curl wget gcc gcc-c++ make python3 vim

🛠️ 第二阶段:安装部署

OpenClaw 的核心依赖是 Node.js (v22+)。系统自带的 Node.js 版本通常较低,需要手动安装。

1. 安装 Node.js v22 (ARM64)

推荐使用二进制包直接安装的方式,简单高效。

# 1. 创建安装目录并进入
mkdir -p /opt/nodejs
cd /opt/nodejs

# 2. 下载 Node.js v22 LTS (Linux ARM64)
# 这里使用华为云镜像,速度更快
wget https://mirrors.huaweicloud.com/nodejs/v22.14.0/node-v22.14.0-linux-arm64.tar.gz

# 3. 解压文件
tar -zxvf node-v22.14.0-linux-arm64.tar.gz

# 4. 建立软链接,使 node 和 npm 命令全局可用
ln -s /opt/nodejs/node-v22.14.0-linux-arm64/bin/node /usr/bin/node
ln -s /opt/nodejs/node-v22.14.0-linux-arm64/bin/npm /usr/bin/npm

2. 一键安装 OpenClaw

安装好 Node.js 后,即可使用官方脚本一键安装 OpenClaw。

# 执行一键安装脚本
curl -fsSL https://clawd.org.cn/install.sh | bash

等待脚本自动完成下载和安装。当终端出现 OpenClaw installed successfully 字样时,表示安装成功。

⚙️ 第三阶段:配置与启动

安装完成后,需要配置大模型 API Key 才能让 OpenClaw“思考”和工作。

1. 获取 API Key

OpenClaw 本身是一个框架,需要接入大模型才能运行。你可以选择一个服务商并获取免费的 API Key。

  • 阿里云百炼 (推荐): 新用户有较长时间的免费额度。
  • Moonshot AI (Kimi): 提供稳定的免费额度。
  • 智谱 GLM: 新用户同样有免费体验额度。

以阿里云百炼为例,获取 qwen-max 模型的 API Key。

2. 配置 OpenClaw

使用以下命令,将你的 API Key 等信息配置到 OpenClaw 中。

# 1. 设置默认的模型提供商为阿里云百炼
openclaw config set agents.defaults.model.provider "bailian"

# 2. 设置使用的模型名称
openclaw config set agents.defaults.model.model_id "qwen-max"

# 3. 设置你的 API Key (请将 sk-xxx 替换为你实际的 Key)
openclaw config set models.providers.bailian.api_key "sk-xxxxxxxxxxxxxxxxxxxxxxxx"

# 4. 设置 API 的基础地址
openclaw config set models.providers.bailian.base_url "https://dashscope.aliyuncs.com/compatible-mode/v1"

3. 启动服务

配置完成后,启动 OpenClaw 网关服务。

# 启动服务
openclaw gateway start

4. 访问 Web 界面

服务启动后,你可以在本地电脑的浏览器中访问开发板的 IP 地址和端口号来使用 OpenClaw。

  • Web UI 访问地址: http://<你的开发板IP地址>:3000
  • API 网关地址: http://<你的开发板IP地址>:18789
重要提示: 请确保开发板的防火墙已放行 3000 和 18789 端口,否则将无法从外部访问。

收藏举报
Level 1
0
帖子
0
粉丝
0
获赞