ROBOT DEPLOYMENT · 2026.11.06.3

安装、升级与卸载。
一个入口。

适用：Debian 13 · ARM64 · 官方 SDK 1.10.0。基础包必装；中继、监控可选。

在线安装或升级

通过 SSH 登录机器人，在机器人终端执行：

curl -fsSL https://reachy-mini.perceptleap.com/robot/install.sh | bash

先选择中文或 English。上下键选择、空格多选、Enter 继续；菜单可返回。未安装时安装基础包；检测到支持的旧安装时自动进入升级，保留原绑定、凭据、配置和媒体。同版本不会重复安装。

首次安装选择绑定时，使用新版 App 扫描终端二维码，核对设备码并在 App 内确认绑定。未登录时可先登录再继续；也可使用终端网址和设备码，在浏览器中完成原有授权流程。二维码在本地生成，不经过第三方服务，不含设备密钥或登录令牌。终端太小或无法扫码时，仍可打开网址并手输授权码。安装器会自动等待授权并建立管理连接。已有账号的设备升级不重新授权；原本已撤销或过期的凭据不会因此恢复有效。

升级支持此前首次安装器管理的 base10 及以上兼容版本；历史 A/B/C 原型部署不能直接覆盖。

卸载：选择保留或清理

仍运行上面同一条命令，选择 卸载部署，然后选择以下一种方式并确认。

卸载部署，保留信息

移除基础包和自有管理服务，撤下自有 daemon 配置；保留设备注册、账号绑定、设备凭据和配置副本。

同时保留已验签运行时与安装材料作为恢复缓存，不再运行。之后用同一命令安装，可恢复原配置和绑定；凭据是否有效仍由服务器决定。

完整卸载，删除信息

先撤销此设备的云端注册及授权，核验旧授权失效，再移除自有部署、设备凭据及旧凭据副本、部署配置、恢复缓存和下载缓存。

撤销需要联网。无法确认撤销或部署状态时会停止并保留恢复证据，不会把网络故障当作清理成功。

两种方式均保留：账号本身、手机登录状态、媒体、官方配置、SSH 维护通道及其凭据、既有 Netdata、历史业务记录与非敏感审计回执。完整卸载不是注销用户账号，也不是恢复出厂设置。

承担维护连接的中继不能被卸载；向导会指出阻止原因。移除监控适配包不会卸载或停止既有 Netdata。恢复安装时可重新选择需要的可选组件。

已下载安装器：固定命令入口

在解压后的离线包目录内执行其一：

# 保留绑定、凭据与配置
sudo python3 -I -B reachy-bootstrap.pyz uninstall --mode preserve

# 撤销设备注册并清理自有部署资料
sudo python3 -I -B reachy-bootstrap.pyz uninstall --mode full

这两个明确指定模式的命令直接执行。需要交互确认时运行下方 wizard 入口。

下载安装包，上传后手动部署

不需要源码或在机器人上拼装依赖。完整包包含安装器、基础包、可选适配包、运行时、签名清单和许可证材料。目标必须已有受支持的官方系统依赖；预检缺失时停止，不在线运行 apt/pip。监控需要既有 Netdata，包内不承诺未验证的全新 Netdata 离线安装。

下载完整安装包 · 107.0 MB

Ed25519 签名 · 发行公钥

在任意电脑下载完整包。先按下方固定 SHA-256 核验，再上传到机器人（将 reachy-mini.local 替换为机器人地址）：
```
scp reachy-robot-2026.11.06.3.tar.gz pollen@reachy-mini.local:~/
```

通过 SSH 登录机器人，在包所在目录核验、解压并运行：

printf '%s  %s\n' 'ae2168e4dfd7c44dc3b600c47546a45b36068f50b8531adec5bd4496793171df' 'reachy-robot-2026.11.06.3.tar.gz' | sha256sum --check --strict - && \
mkdir reachy-robot-2026.11.06.3 && \
tar -xzf reachy-robot-2026.11.06.3.tar.gz -C reachy-robot-2026.11.06.3 && \
cd reachy-robot-2026.11.06.3 && \
sudo python3 -I -B reachy-bootstrap.pyz wizard --offline "$PWD"

在同一向导中选择安装、升级或卸载。离线参数禁止安装材料下载；账号首次绑定、管理连接及完整卸载时的云端撤销仍需要联网。

安装完成后，可自行删除上传的压缩包与解压目录。它们在用户目录中，卸载器不会擅自删除这些上传原件。

无人值守安装与仅核验材料

# 仅验证本地签名材料，不安装
sudo python3 -I -B reachy-bootstrap.pyz download --offline "$PWD"

# 安装或升级基础包，不发起账号绑定
sudo python3 -I -B reachy-bootstrap.pyz install --offline "$PWD"

版本与校验

发行 2026.11.06.3 · 基础包 0.1.0~prototype15

完整包 SHA-256：

ae2168e4dfd7c44dc3b600c47546a45b36068f50b8531adec5bd4496793171df

发行公钥 SHA-256：

5fc0c76b1d99487fc0eef4e9245637c0fdf1c3dd3827e6eafa55bcedbbfff603

独立验证离线包签名

将安装包、签名及公钥放在同一目录。先核对公钥固定摘要，然后验签，成功后才解压：

printf '%s  %s\n' '5fc0c76b1d99487fc0eef4e9245637c0fdf1c3dd3827e6eafa55bcedbbfff603' 'release.pem' | sha256sum --check --strict - && \
openssl pkeyutl -verify -pubin -inkey release.pem -rawin \
  -in reachy-robot-2026.11.06.3.tar.gz \
  -sigfile reachy-robot-2026.11.06.3.tar.gz.sig

签名版本清单 · 清单签名

已完成自动回归与隔离环境的包安装、升级、保留卸载、恢复重装、完整清理验证。服务状态及云端撤销使用测试替身；本次未连接或修改当前机器人，真机安装效果由用户自行验证。

安装、升级与卸载。一个入口。