本教程由 @julie 提供，旨在指导用户完成 OpenClaw 部署，实现自动化任务，对话等能力。由于官方未提供Node.js的RISC-V完整预编译包，该过程首先通过源码在riscv64架构下完成了Node.js的原生编译与安装。随后，通过配置阿里百炼等云端大模型的API Key（如Qwen Plus），VisionFive 2成功接入了强大的云端大语言模型。
部署完成后，用户不仅可以通过命令行终端与 VisionFive 2上的Agent直接对话，还可以通过OpenClaw Gateway Dashboard进行可视化的UI交互，使这台RISC-V 单板计算机具备了自动化任务处理的基础能力。
一． 整体流程
- 环境说明
- 开启 swap
- 安装 Node.js
- 安装 OpenClaw
- 配置 AI API
- 验证运行
二． 环 境 说 明
硬件：VisionFive 2（RISC-V架构）
系统：Debian 202510
三． 架构示意
用户
↓
OpenClaw Agent
↓
OpenClaw Gateway
↓
云端模型（Qwen / GPT）
四． 开启 Swap
防止编译 Node.js 时内存不足
命令：
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
5. Node.js 编译安装
Node.js是OpenClaw 运行环境，官方没有RISC-V完整预编译包，需要源码编译
1）安装依赖：
sudo apt update
sudo apt install -y python3 g++ make python3-pip curl libssl-dev pkg-config
2）下载Node.js源码并编译安装
wget https://nodejs.org/dist/v22.13.1/node-v22.13.1.tar.gz
tar -xzvf node-v22.13.1.tar.gz
cd node-v22.13.1
./configure --prefix=/opt/nodejs --dest-cpu=riscv64 --dest-os=linux --openssl-no-asm
make -j1 #建议单线程编译，避免OOM，卡死
sudo make install
3）环境变量配置
在/etc/profile最后加上一行：
export PATH=$PATH:/opt/nodejs/bin
source /etc/profile
4）在/usr/bin/下创建软链接
sudo ln -sf /opt/nodejs/bin/node /usr/bin/node
sudo ln -sf /opt/nodejs/bin/npm /usr/bin/npm
sudo ln -sf /opt/nodejs/bin/npx /usr/bin/npx
sudo npm install -g pnpm
sudo ln -sf /opt/nodejs/bin/pnpm /usr/bin/pnpm
6. 安装 OpenClaw
将 openclaw-starfive-debian.tar 压缩包放到主目录
执行：
tar -xvf openclaw-starfive-debian.tar
cd openclaw-starfive-debian
./install-starfive-debian.sh
7. 配置 AI API （ 以阿里百炼为例 ）
申请百炼 API Key，网址bailian.console.aliyun.com
在终端上输入下述整段代码内容，配置模型提供商、模型名称、上下文长度等参数，使 OpenClaw 能调用 AI
cat > ~/.openclaw/.env <<‘EOF’
DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxx
EOF
openclaw config unset models.providers.bailian
openclaw config set models.providers.bailian ‘{
baseUrl: “https://dashscope.aliyuncs.com/compatible-mode/v1”,
apiKey: “${DASHSCOPE_API_KEY}”,
api: “openai-completions”,
models: [
{
id: “qwen-plus”,
name: “Qwen Plus”,
reasoning: false,
input: [“text”],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 131072,
maxTokens: 8192
}
]
}’
openclaw config set ‘agents.defaults.models[“bailian/qwen-plus”]’ ‘{alias:“Qwen”}’
openclaw config set agents.defaults.model ‘{primary:“bailian/qwen-plus”, fallbacks: }’
systemctl --user restart openclaw-gateway
openclaw models status --agent main --plain
备注：红色字体部分的api_key替换为自己的
8. 验证
1）终端下验证：
openclaw agent --agent main --message “请简单回答你现在工作是否正常”
2）UI下验证：
终端下输入指令：
Openclaw dashboard #可在UI界面下对话
