版本与升级

RoboAPI 0.4.5复制标题链接

本版于 2026-10-29 发布。通过 PyPI 安装，按安装指南选择与你的机器人匹配的依赖。

本版变化复制标题链接

• 从服务选择模型：初始化时填写 Key，获取可用模型列表后选择，不再手工输入模型 ID。
• 分步连接与保存：控制台先 连接、选择模型，再 保存。当前模型仍可用时保留选中状态；更改地址或 Key 后重新获取列表。
• 默认正式服务地址：Base URL 默认为 https://api.pokebot.com/v1，仍支持兼容服务的自定义地址。
• 连接失败可重试：查询列表不会保存本次输入的凭据或创建任务会话，失败时保留已保存的设置与本次输入。

新安装需要控制电脑联网访问模型服务。具体操作见软件安装和本地控制台。硬件适配、标定与动作执行流程保持不变。

升级已有安装复制标题链接

1. 使用 Robot Stop 停止任务，再关闭 RoboAPI 服务。也要停止 MCP 客户端启动的 stdio 进程。
2. 备份配置目录 ~/.config/roboapi/，激活原有 Python 环境。
3. 按安装指南或 Franka 部署选择当前机器人对应的完整命令，加上 --upgrade 并固定 ==0.4.5。例如 FR3 系统 5.9+：

source ~/roboapi/.venv/bin/activate
uv pip install --upgrade 'roboapi[franka,gripper]==0.4.5'

FR3 系统 5.6.0 和 Panda 同时保留对应的 SDK 构建版本和下载索引。

4. 使用原配置重新启动：默认位置执行 roboapi http，自定义位置执行 roboapi http -c /path/to/config.yaml。

从 0.4.4 升级可沿用已有地址、模型、凭据与标定，无需重新初始化、重新标定或重建 UR 原生运行时。 如需更换模型，在 设置 → 模型与运行 中连接、选择并保存。更换物理装配、初始位置或任务轴后，仍需重新标定。

从 0.4.3 或更早版本升级复制标题链接

完成上面的安装步骤后，还需补全 0.4.4 引入的组件与装配设置：

1. 补全已有安装配置：

roboapi init --complete

自定义配置位置使用 roboapi init --complete -c /path/to/config.yaml。此命令保留已有设置和凭据，按需询问缺少的信息。

2. 使用原配置重新启动，检查相机与设备状态，完成提示要求的标定，再选择 启用控制。默认配置使用 roboapi http，其他位置使用 roboapi http -c /path/to/config.yaml。

原环境已使用 0.4.2 或 0.4.3 的 UR 原生运行时时，可继续使用，无需重建。新环境首次安装 UR e-Series 仍需构建原生运行时。升级 Python 包不会删除配置、凭据、标定和运行记录；更换物理装配、初始位置或任务轴后重新标定。

从 0.4.1 或更早版本升级复制标题链接

除上述步骤外，UR5e / UR7e 需重新构建原生控制运行时：

python -m roboapi.hardware.ur.build --build-dir build/ur-native --install-dir "$VIRTUAL_ENV"

自己集成本地接口时，核对 HTTP API 和 MCP 工具。浏览器自动衔接采 C、返回初始位置、保存和启用控制；直接调用接口时按文档逐步完成。

从旧名 robomcp 迁移复制标题链接

1. 停止旧任务与服务，避免两个进程同时连接同一设备。
2. 创建新 Python 环境，按安装指南安装 RoboAPI 0.4.5。
3. 运行 roboapi init，填写组件、设备、负载与模型设置。
4. UR e-Series 构建新的 roboapi-ur-loop；旧名称的原生程序不能替代它。
5. 完成初始位置与 A/B/C 标定，再运行任务。

RoboAPI 使用 ~/.config/roboapi/，不自动读取或迁移 ~/.config/robomcp/。旧文件仍留在原目录。旧命令和 Python 导入不作为新名称的别名。