# Servi Q 开发百科：Bear Robotics 餐厅服务机器人二次开发

> 原文链接：https://robotics.hellobike.com/wiki/bear-robotics-servi-q-dev-guide
> 频道：wiki | 更新日期：2026-10-22 | 标签：Bear Robotics, Servi Q, 服务机器人, gRPC, ROS 2, UDP
> 核心摘要：Servi Q 是 Bear Robotics 面向窄过道餐厅的紧凑型服务机器人，具备防泼洒导航、后向碰撞检测和 18.5 英寸显示屏，可结合云端、机器人与固件 API 做二次开发。

# Servi Q 开发百科：Bear Robotics 餐厅服务机器人二次开发

## 本体与算力接口

Servi Q 面向窄过道或紧凑空间餐厅，可支持团队工作，并可在 18 英寸通道中导航。整机尺寸为 13.8 × 18.3 × 41.7 in（35 × 46.6 × 106 厘米），重量 99.2 磅（45 千克），驱动速度 0.7 米/秒。每个托盘和底部层板可承载 22 磅（10 千克），总负载 66.1 磅（30 千克）。机器人具备防泼洒导航、后向碰撞检测，后退移动中检测到碰撞会停止；采用有线充电器，充电时间 4-6 小时。18.5 英寸集成显示屏可展示每日特价、促销、品牌内容或导向信息。

## 官方 SDK 与通信协议

- [cloud](/sdks/bearrobotics-public-cloud)：Bear Cloud API，基于 gRPC，用于第三方发送机器人控制命令、接收任务与电池等状态、获取机器人信息；仓库为 `https://github.com/bearrobotics-public/cloud`。README 写明需 gRPC Framework 与 `protoc`，克隆后安装 `requirements.txt` 依赖，参照 `docs` 调用云侧接口。
- [firmware](/sdks/bearrobotics-public-firmware)：C++ BaseBoard API，定义固件与 ROS driver 的低层通信协议，使用 UDP 二进制包，支持电机控制、系统命令、电源管理、IMU、电池、充电状态与日志等数据。测试环境为 Ubuntu 22.04 LTS、GCC 11.x、CMake 3.16+、ROS 2 Humble，按 README 通过 CMake 编译。
- [robot](/sdks/bearrobotics-public-robot)：Bear Robot API，基于 gRPC，用于发送控制命令、接收里程计与电池状态、获取机器人信息；仓库为 `https://github.com/bearrobotics-public/robot`。README 写明需 robot base、gRPC Framework 与 `protoc`，并提供 Python 客户端代码生成说明和使用示例。

## 推荐上手顺序

1. 先核对 Servi Q 的应用边界：通道宽度、载重、充电时间、后向碰撞检测和 18.5 英寸显示屏内容需求。
2. 若做云侧业务对接，优先阅读 [cloud](/sdks/bearrobotics-public-cloud)，按 gRPC 与 Protocol Buffers 准备环境。
3. 若做机器人本体任务与状态集成，使用 [robot](/sdks/bearrobotics-public-robot)，重点处理 server-streaming 的时间戳、sequence number、60 分钟 timeout 与 best effort 消息语义。
4. 若进入固件层或 ROS driver 对接，再使用 [firmware](/sdks/bearrobotics-public-firmware)，按 UDP 包的方向、header、sequence number 与超时机制设计客户端。

## 来源

- [Bear Robotics：Bear Robotics 产品页](https://www.bearrobotics.ai/servi-q)
- [GitHub cloud](https://github.com/bearrobotics-public/cloud)
- [GitHub firmware](https://github.com/bearrobotics-public/firmware)
- [GitHub robot](https://github.com/bearrobotics-public/robot)

本页由站内机型卡、官方 SDK README 与已验证记录整理而成；命令与版本以仓库当前 README 为准。

## 原始参考来源 (Sources)

- [Bear Robotics：Bear Robotics 产品页](https://www.bearrobotics.ai/servi-q)
- [GitHub cloud](https://github.com/bearrobotics-public/cloud)
- [GitHub firmware](https://github.com/bearrobotics-public/firmware)
- [GitHub robot](https://github.com/bearrobotics-public/robot)