在Radxa zero3w开发板上部署OpenClaw 2026.3.8实战指南

Nix88
0 阅读17分钟

在Radxa zero3w开发板上部署OpenClaw 2026.3.8实战指南

本文阅读约需 30 分钟

摘要

本文档详细介绍如何在Radxa zero3w开发板上从零开始部署OpenClaw 2026.3.8版本，涵盖硬件准备、Debian 12系统安装、串口终端配置WiFi与SSH远程连接、开发环境搭建、Claude Code与OpenCode安装配置智谱AI Coding Plan、OpenClaw本体安装、飞书集成以及最终升级为火山引擎Mem0记忆系统的完整流程。本指南专为没有HDMI显示器的用户编写，所有操作均通过串口终端或SSH远程完成。

一、硬件与环境概述

1.1 开发板硬件规格

本次部署使用的开发板为Radxa zero3w，搭载Rockchip RK3566处理器，采用四核ARM Cortex-A55架构，最高主频1.6GHz。板载8GB LPDDR4内存，64GB eMMC存储，集成Wi-Fi 6（802.11ax）无线网卡和蓝牙5.0。供电采用Type-C接口，建议使用5V/2A电源适配器。开发板尺寸仅为65mm x 30mm，体积小巧且功耗极低，非常适合部署AI Agent类应用。

开发板接口资源丰富，包括1个Micro HDMI接口（支持1080p@60fps）、1个USB 2.0 Type-C OTG接口、1个USB 3.0 Type-C Host接口、40针GPIO扩展座以及4通道MIPI CSI摄像头接口。由于用户没有HDMI线缆，本文将主要依赖串口终端进行初始配置。

radxa zero3w.jpg

1.2 整体部署流程概览

整个部署过程分为十个主要阶段：首先准备工作站环境，包括安装必要的刷机工具；然后将Debian 12系统镜像烧录到eMMC；接着通过串口终端连接开发板；配置WiFi网络使开发板接入互联网；配置SSH服务实现远程登录；更新软件源为清华镜像以提升下载速度；安装Node.js运行环境；创建普通用户账户；安装并配置Claude Code和OpenCode；安装OpenClaw并配置飞书连接；最后将记忆系统升级为火山引擎Mem0。

二、准备工作站环境

2.1 所需材料清单

在开始部署之前，需要准备以下材料：一台运行Windows、macOS或Linux的PC电脑；一根USB Type-C数据线（用于连接开发板的OTG接口进行刷机和供电）；一个USB转TTL串口模块（CH340或CP2102芯片均可）；若干杜邦线用于连接串口；以及一根稳定的5V/2A Type-C电源适配器。软件方面需要准备Balena Etcher刷机工具和rkdeveloptool刷机工具。

2.2 安装rkdeveloptool刷机工具

RK3566开发板需要使用rkdeveloptool工具进行刷机。以下是在Ubuntu/Debian系统上编译安装该工具的详细步骤。

首先安装编译所需的依赖包：

sudo apt-get update
sudo apt-get install libudev-dev libusb-1.0-0-dev dh-autoreconf pkg-config

然后从GitHub克隆rkdeveloptool源码：

git clone https://github.com/rockchip-linux/rkdeveloptool.git
cd rkdeveloptool

配置编译环境：

aclocal
autoreconf -iautoheader
automake --add-missing
./configure

如果遇到pkg-config错误，使用以下命令解决后重新执行configure：

sudo apt-get install pkg-config

完成配置后进行编译和安装：

make
sudo make install

安装完成后，验证工具是否正常工作：

rkdeveloptool -v

如果显示版本信息，说明安装成功。

2.3 下载Debian 12系统镜像

访问Radxa官方GitHub仓库下载最新的Debian 12系统镜像。建议选择包含Xfce桌面环境的镜像版本，以获得更好的用户体验。

镜像文件通常为.xz压缩格式，下载完成后需要解压缩：

xz -d radxa-zero3_debian_12_xfce_*.img.xz

压缩后将得到.img格式的镜像文件。

三、系统镜像烧录到eMMC

3.1 连接开发板进入MaskROM模式

将Debian系统烧录到eMMC需要进入MaskROM模式。具体操作步骤如下：首先断开开发板的所有电源；然后使用USB Type-C数据线连接开发板的OTG接口（靠内侧的USB Type-C口）到PC电脑；接着按住开发板上的MaskROM按钮（位于板子背面靠近USB接口处）；最后保持按住MaskROM按钮的同时连接电源，松开按钮后开发板将进入MaskROM模式。

进入MaskROM模式后，使用lsusb命令检查设备是否被识别：

lsusb

如果看到类似"2207:3506"的设备ID（Rockchip ID），说明开发板已成功进入MaskROM模式。

3.2 使用rkdeveloptool烧录镜像

确认开发板进入MaskROM模式后，执行以下命令开始烧录：

# 进入镜像文件所在目录
cd /path/to/image/

# 初始化Rockchip设备
rkdeveloptool db rk3566_miniloader.bin

# 格式化eMMC
rkdeveloptool ef

# 写入系统镜像（根据实际镜像文件名修改）
rkdeveloptool wl 0 radxa-zero3_debian_12_xfce.img

其中rk3566_miniloader.bin为Rockchip的引导加载程序，通常可以从官方镜像包中获得。烧录过程可能需要5-10分钟，请耐心等待直至完成。烧录完成后，开发板会自动重启并从eMMC启动系统。

3.3 首次启动验证

系统烧录完成后，断开USB数据线，连接5V/2A电源适配器为开发板供电。观察开发板的LED指示灯状态：红色电源灯常亮，绿色LED灯闪烁表示系统正在启动。首次启动可能需要1-2分钟完成初始化。

四、串口终端连接配置

4.1 硬件连接说明

由于用户没有HDMI线缆无法使用图形界面，需要通过串口终端进行初始配置。将USB转TTL串口模块与开发板的调试串口连接，具体引脚定义如下：USB转TTL模块的TXD引脚连接开发板的RXD针脚，RXD引脚连接开发板的TXD针脚，GND引脚连接开发板的GND针脚。

开发板40针GPIO接口中，第8、10、14针分别为GND、TXD、RXD。连接时请务必确认引脚对应关系，避免接错导致通信失败。

4.2 串口终端软件配置

在PC端打开串口终端软件（如PuTTY、MobaXterm或Windows Terminal），配置以下串口参数：

参数值
波特率1500000
数据位8
停止位1
校验位无
流控无

选择对应的COM端口（可以在Windows设备管理器中查看），然后点击连接。

4.3 登录系统

系统启动完成后，在串口终端中看到登录提示符。默认用户名和密码均为radxa：

Debian GNU/Linux 12 radxa ttyS0

radxa login: radxa
Password: radxa

首次登录后，建议立即修改默认密码：

passwd radxa

五、配置WiFi无线网络

5.1 检查无线网卡状态

登录系统后，首先检查无线网卡是否被正确识别：

ip link show

应该能看到wlan0或类似名称的无线接口。如果未看到，尝试加载无线网卡驱动：

sudo modprobe rtw88_8822bu
# 或者
sudo modprobe rtw88_8822cu

将驱动添加到开机自动加载：

echo rtw88_8822bu | sudo tee /etc/modules-load.d/wifi.conf

5.2 扫描并连接WiFi

使用nmcli工具扫描可用的WiFi网络：

nmcli device wifi

找到自己的WiFi网络名称（SSID），然后执行连接命令（将以下命令中的<SSID>和<PASSWORD>替换为实际的网络名称和密码）：

sudo nmcli device wifi connect <SSID> password <PASSWORD>

例如：

sudo nmcli device wifi connect MyWiFi password 12345678

5.3 验证网络连接

连接成功后，使用以下命令验证网络状态：

# 查看IP地址
ip addr show wlan0

# 测试网络连通性
ping -c 4 www.baidu.com

如果能成功获取IP地址且ping通外网，说明WiFi配置成功。请记下分配到的IP地址，后续SSH远程连接需要使用。

六、配置SSH远程连接

6.1 安装SSH服务

检查SSH服务是否已安装：

sudo systemctl status ssh

如果未安装，执行以下命令安装：

sudo apt-get update
sudo apt-get install openssh-server openssh-sftp-server

6.2 启动并配置SSH服务

启动SSH服务并设置为开机自启：

sudo systemctl start ssh
sudo systemctl enable ssh

为方便后续操作，建议配置sudo免密：

sudo visudo

在文件末尾添加以下行：

radxa ALL=(ALL) NOPASSWD:ALL

保存退出（Ctrl+O，回车，Ctrl+X）。

6.3 从PC远程SSH登录

在同一局域网内的PC上打开终端（Windows可以使用PowerShell或Windows Terminal），使用SSH连接开发板：

ssh radxa@<开发板IP地址>

例如：

ssh radxa@192.168.1.100

输入之前设置的密码后，即可远程登录开发板。之后的所有操作都可以在SSH终端中完成，无需再使用串口连接。

七、更新软件源为清华镜像

7.1 备份并修改sources.list

为了提升软件包下载速度，将Debian官方源替换为清华大学的镜像源。首先备份原有的源列表：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

然后编辑sources.list文件：

sudo nano /etc/apt/sources.list

将文件内容替换为以下内容（针对Debian 12 Bookworm）：

# 默认注释了源码镜像以提高 apt update 速度，如有需要可取消注释
deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
deb http://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware

# 如果需要源码镜像，取消注释以下行
# deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
# deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
# deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
# deb-src http://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware

保存并退出（Ctrl+O，回车，Ctrl+X）。

7.2 更新软件包列表

执行以下命令更新软件包列表：

sudo apt update

如果一切正常，应该能看到清华源的更新信息，且下载速度明显提升。

八、安装Node.js运行环境

8.1 使用nvm安装Node.js

推荐使用nvm（Node Version Manager）安装Node.js，可以方便地管理多个Node.js版本。首先安装nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完成后，关闭当前终端并重新打开一个终端，使nvm生效。验证nvm安装：

nvm --version

8.2 安装Node.js 22 LTS版本

OpenClaw需要Node.js 22或更高版本。使用nvm安装最新的LTS版本：

nvm install 22
nvm use 22

验证Node.js和npm版本：

node --version
npm --version

8.3 配置npm国内镜像（可选但推荐）

由于网络原因，建议配置npm使用国内镜像以加速包下载：

npm config set registry https://registry.npmmirror.com

或者使用淘宝镜像：

npm config set registry https://registry.npmjs.org/

九、创建普通用户

9.1 创建新用户

出于安全考虑，不建议直接使用root或radxa用户运行OpenClaw。创建一个新的普通用户（以openclaw为例）：

sudo adduser openclaw

按照提示设置用户密码，并填写相关信息（可以直接按回车跳过）。

9.2 授予sudo权限

将新用户添加到sudo组：

sudo usermod -aG sudo openclaw

配置sudo免密（可选，方便后续操作）：

sudo visudo

在文件末尾添加：

openclaw ALL=(ALL) NOPASSWD:ALL

9.3 切换到新用户

后续操作切换到新创建的用户：

su - openclaw
cd ~

十、安装并配置Claude Code

10.1 安装Claude Code

在openclaw用户下执行以下命令安装Claude Code：

npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

10.2 注册智谱AI账号并获取API Key

访问智谱AI开放平台（open.bigmodel.cn/），注册一个账号并登录… Keys】，创建一个新的API Key。请妥善保存该Key，后续配置会用到。

10.3 配置智谱AI Coding Plan

使用官方配置脚本自动完成环境变量设置：

curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

脚本会提示输入API Key，输入刚才获取的智谱AI API Key即可。配置完成后，关闭当前终端并重新打开一个新的终端。

10.4 手动配置（备选方案）

如果自动脚本不生效，可以手动创建配置文件。首先创建~/.claude目录：

mkdir -p ~/.claude

创建settings.json配置文件：

nano ~/.claude/settings.json

添加以下内容（将<YOUR_API_KEY>替换为实际API Key）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<YOUR_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

创建~/.claude.json文件跳过初始引导：

echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

10.5 配置模型映射

可以自定义Claude Code内部的模型映射。编辑~/.claude/settings.json添加以下环境变量：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<YOUR_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air"
  }
}

十一、安装并配置OpenCode

11.1 安装OpenCode

OpenCode是字节跳动推出的AI编程工具。安装命令如下：

npm install -g @bytedance/opencode

验证安装：

opencode --version

11.2 配置智谱AI作为后端

OpenCode同样支持配置智谱AI的Coding Plan。创建配置文件：

mkdir -p ~/.opencode
nano ~/.opencode/config.json

添加以下配置：

{
  "apiKey": "<YOUR_API_KEY>",
  "baseUrl": "https://open.bigmodel.cn/api/anthropic/v1"
}

11.3 验证Claude Code可用性

在新终端中测试Claude Code是否能正常工作：

claude
# 输入测试问题

如果能正常响应，说明配置成功。

十二、安装OpenClaw

12.1 基础环境检查

在安装OpenClaw之前，确保已满足以下条件：Node.js 22或更高版本已安装；系统已配置好科学上网或国内镜像；已安装Git：

sudo apt-get install git

12.2 一键安装OpenClaw

使用OpenClaw官方提供的一键安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动下载并安装OpenClaw及其依赖。安装过程中可能需要几分钟时间，请耐心等待。

12.3 手动安装（备选方案）

如果一键安装脚本失败，可以尝试手动安装：

# 克隆OpenClaw仓库
git clone https://github.com/justlovemaki/OpenClaw.git
cd OpenClaw

# 安装依赖
npm install

# 安装pnpm（如果需要）
npm install -g pnpm
pnpm install

12.4 验证OpenClaw安装

检查OpenClaw状态：

openclaw status

如果显示服务运行状态，说明安装成功。

十三、配置飞书集成

13.1 创建飞书企业自建应用

登录飞书开放平台（open.feishu.cn/app），点击"创建企…

13.2 获取应用凭证

进入应用管理页面后，点击"凭证与基础信息"，复制App ID和App Secret并妥善保存。这些凭证将在后续配置OpenClaw时使用。

13.3 添加机器人能力

在应用管理页面左侧导航栏找到"添加应用能力"，在右侧列表中选择添加"机器人"。保存设置。

13.4 配置应用权限

进入"权限管理"页面，点击"批量导入"，粘贴以下JSON权限代码：

{
  "permissions": [
    "im:chat:readonly",
    "im:chat:create",
    "im:message:readonly",
    "im:message:send_as_bot",
    "im:message:send_to_bot",
    "im:resource:download"
  ]
}

提交后检查关键权限是否都在"已申请"状态。

13.5 在OpenClaw中配置飞书

在OpenClaw配置文件中添加飞书通道配置。编辑配置文件：

nano ~/.openclaw/config.json

添加飞书配置：

{
  "channels": {
    "feishu": {
      "app_id": "<YOUR_FEISHU_APP_ID>",
      "app_secret": "<YOUR_FEISHU_APP_SECRET>"
    }
  }
}

13.6 配置事件订阅

在飞书开放平台后台，进入"事件订阅"页面。选择"使用长连接接收事件（WebSocket）"，添加以下事件：

  • im.message.receive_v1 - 接收消息
  • im.chat.member.bot_added_v1 - 机器人被添加到群聊

保存配置后，重启OpenClaw服务：

openclaw restart

13.7 发布应用并测试

回到飞书开放平台，点击"创建版本并发布"，提交应用版本。审批通过后，在飞书中搜索并添加机器人，开始测试对话。

十四、升级为火山引擎Mem0

14.1 了解Mem0的优势

Mem0是火山引擎提供的企业级记忆服务，相比OpenClaw原生记忆系统具有以下优势：跨会话与跨Agent记忆共享、以用户为中心实现记忆隔离、提供企业级管理界面、减少Token消耗、以及自动化记忆捕获功能。

14.2 获取火山引擎Mem0凭证

访问火山引擎Mem0控制台（www.volcengine.com/product/mem… Key和服务地址（Host）。在创建项目时，可以配置记忆提取策略的提示词以优化记忆提取效果。

14.3 安装Mem0插件

使用OpenClaw的插件管理命令安装Mem0插件：

openclaw plugins install @xray2016/openclaw-mem0-plugin

14.4 配置Mem0插件

编辑OpenClaw配置文件，添加插件配置：

nano ~/.openclaw/openclaw.json

添加以下配置（将占位符替换为实际的Mem0凭证）：

{
  "plugins": [
    {
      "name": "@xray2016/openclaw-mem0-plugin",
      "config": {
        "mode": "platform",
        "host": "<YOUR_MEM0_HOST>",
        "api_key": "<YOUR_MEM0_API_KEY>",
        "userId": "openclaw_user"
      }
    }
  ]
}

14.5 重启服务并验证

重启OpenClaw Gateway服务使配置生效：

openclaw gateway restart

验证Mem0功能是否正常工作：启动一个新的OpenClaw会话，输入包含个人信息的对话内容，观察日志中是否出现"memory store completed"提示。也可以登录火山引擎Mem0控制台查看记忆条目。

14.6 Mem0工具函数说明

安装Mem0插件后，OpenClaw Agent将获得以下工具函数：

函数名功能
memory_search根据自然语言查询搜索相关记忆
memory_store显式地将信息存储为长期记忆
memory_list列出当前用户的所有记忆
memory_forget删除特定的记忆

也可以使用CLI命令进行调试：

# 搜索记忆
openclaw mem0 search --query "关键词"

# 列出记忆
openclaw mem0 list

十五、系统优化与维护

15.1 设置Swap分区

由于RK3566只有8GB内存，运行OpenClaw时可能会遇到内存不足的情况。建议设置Swap交换分区：

# 创建2GB的Swap文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 添加开机自动挂载
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

15.2 配置系统自动更新

保持系统安全很重要，配置自动更新：

sudo apt-get install unattended-upgrades
sudo dpkg-reconfigure -plow unattended-upgrades

15.3 监控资源使用

定期监控开发板的资源使用情况：

# 查看内存使用
free -h

# 查看磁盘使用
df -h

# 查看进程运行情况
htop

15.4 常用管理命令

OpenClaw常用管理命令汇总：

# 查看服务状态
openclaw status

# 重启服务
openclaw restart

# 停止服务
openclaw stop

# 查看日志
openclaw logs

# 更新OpenClaw
openclaw update

十六、故障排查

16.1 无法进入MaskROM模式

如果开发板无法进入MaskROM模式，尝试以下方法：确保USB数据线支持数据传输（部分仅供电线无法识别）；尝试不同的USB端口（建议使用USB 2.0端口）；检查USB转TTL模块是否正常工作。

16.2 WiFi连接失败

WiFi连接问题排查：首先确认WiFi名称和密码正确；检查无线网卡驱动是否加载；尝试手动设置WiFi连接：

sudo nmcli device disconnect wlan0
sudo nmcli device wifi connect <SSID> password <PASSWORD> ifname wlan0

16.3 SSH连接问题

SSH连接失败的常见原因：检查SSH服务是否运行sudo systemctl status ssh；确认防火墙设置sudo ufw status；检查端口是否被占用sudo netstat -tlnp | grep 22。

16.4 OpenClaw启动失败

检查Node.js版本是否正确：

node --version  # 应该是 v22.x.x

查看详细错误日志：

openclaw logs --tail 100

尝试重新安装依赖：

cd ~/.openclaw
rm -rf node_modules
npm install

16.5 飞书消息收不到

检查飞书应用状态：在飞书开放平台确认应用已发布且通过审批；验证App ID和App Secret是否正确；检查事件订阅配置是否保存成功。

十七、总结

本文详细记录了在Radxa zero3w开发板上部署OpenClaw 2026.3.8版本的完整流程。从硬件准备、Debian系统烧录、串口终端配置、WiFi网络连接、SSH远程登录、开发环境搭建，到最后安装Claude Code、OpenCode并配置智谱AI Coding Plan，以及OpenClaw安装、飞书集成和Mem0升级，涵盖了嵌入式设备上部署AI Agent应用的各个环节。

RK3566作为一款低功耗、高性价比的嵌入式SoC，非常适合部署轻量级的AI应用。通过本文的部署方案，用户可以在这个仅65mm x 30mm的小型开发板上运行完整的OpenClaw AI助理，配合飞书等即时通讯工具实现智能化办公。同时，将记忆系统升级为火山引擎Mem0后，可以获得更强大的企业级记忆管理能力，为后续的智能化应用开发奠定坚实基础。

zero3w.jpg

文档信息

  • 目标硬件：Radxa zero3w (RK3566, 8GB RAM, 64GB eMMC)
  • 软件版本：OpenClaw 2026.3.8, Debian 12, Node.js 22 LTS
  • 适用场景：低功耗嵌入式AI Agent部署

版权声明

本文由 Nix 撰写，版权所有，转载时请标明出处。

Nix长期致力于嵌入式+AI全栈开发，欢迎技术交流与合作。

联系方式

微信：nix2036

avatar
文章
阅读
粉丝