用途：通过 robo-dispatcher 服务管理具身任务调度，让智能体在指定机器人（robot_id）上、以执行模型（exec_model_id）在会话（session_id）中创建并运行自然语言任务，支持监控、取消、等待完成与结果获取。
主要能力：创建任务（create-task，需 --constraints-json 提供 model、robot_id、exec_constraints 停止条件，默认 max_run_time=10 分钟、max_iter_num=100 步）；列出/查看任务（list-tasks、show-task，可按状态、机器人、推理服务、时间、内容过滤并分页排序）；等待完成（wait-task，内部每 5 秒轮询，默认超时 600 秒，范围 1–3600，状态离开 RUNNING 即返回）；取消任务（cancel-task）；获取结果（show-task-result，返回 task 与 log_items）。SDK 提供 DispatchClient 的 6 个对应方法。
使用方式：命令格式为 cloudrobo dispatch <command> [OPTIONS]。当前版本 session_id 等于当前工作区 workspace_id，可通过 cloudrobo workspace current 获取。exec_model_id 不是模型资产 UUID：自建推理服务用其 service_id（cloudrobo infer list 获取），平台预置/外部模型服务为 ext_ 前缀句柄，可从同会话已有成功任务的 constraints.model.exec_model_id 确认。create-task 的 constraints.model 只填 exec_model_id，不要填 exec_model_name（会报 400）。机器人须 ONLINE（R2C 边缘客户端已连接），否则返回 Robot offline。若推理服务以 strict:true 部署，任务文本必须匹配预定义技能提示。
适用场景：任务下发、任务监控与查询、阻塞等待完成、任务取消、结果检索，以及结合 cloudrobo-robot 与 cloudrobo-infer/cloudrobo-asset 的跨技能编排。
限制：所有操作需有效 workspace_id 与 session_id；旧的 create-session、exec_task、create-session-task 接口已废弃；wait-task 无独立后端接口，仅客户端轮询；超时会抛 TimeoutError 或 CLI 报错退出码 1。Windows PowerShell 需将 bash 续行改为单行或反引号，环境变量用 $env:NAME="value"。CLI 安装、AK/SK 认证与工作区配置见 references/cli-installation-guide.md。