Cloud 接入概览

GSHUB Cloud 面向机器人运营场景，提供设备接入、租户与成员管理、遥测、资源和任务能力。机器人通过 MQTT 上报数据并接收云端指令；业务应用通过云端 HTTP API 接入。

端侧与云端的分工

服务	访问方式	用途
Orsus	机器人地址下的 /v1/api	直连设备，管理本机环境和任务
Cloud	交付的云服务域名下的 /api/v1	设备运营、权限和云端任务

云端认证与 Orsus 本机认证相互独立。某台机器允许免 token 直连，不代表云 API 也允许免认证访问。

接入前准备

向部署管理员获取云服务地址、所属租户和账号。设备接入还需要确认 MQTT Broker、凭据、主题权限和设备准入状态。

详细的 HTTP 契约应与当前云服务交付版本一起提供；本空间先介绍接入流程与端云协作，不承诺覆盖所有云 API。

下一步：设备接入与状态确认。