← 返回项目库

XLeRobot 机器人远程控制台

为 XLeRobot 机器人提供浏览器端远程控制、视频流与遥测查看。

项目包含 React 与 Vite 客户端、FastAPI 与 Socket.IO 服务端，通过 ZeroMQ 与机器人主机通信；本次适配增加中文界面和仅供本地验证的稳定演示模式。

真实界面

项目截图

共 6 张

XLeRobot 机器人远程控制台
视频流已成功启动
录制中
浅色模式
系统日志
系统诊断

Capabilities

核心功能

✓显示控制连接、视频流和延迟状态
✓启动与停止实时视频流
✓展示电池、速度、温度和电压遥测
✓展示网络性能与机械臂关节角度
✓提供 WASD、方向键和虚拟摇杆运动控制
✓提供镜头重置与紧急停止操作
✓提供遥测、日志和诊断三个工作视图
✓支持浅色与深色显示模式

适用场景

在实验室内通过浏览器观察并控制 XLeRobot
在没有实体设备时用本地演示模式验收前端流程
将控制台作为机器人应用的自部署运维界面

适合谁

机器人开发者、实验室工程师和需要自部署远程控制台的技术团队。

商业化思路

开源自部署交付，可配套实施、集成和技术支持服务。

你会拿到什么

  • ✓webcontrol/client React/Vite 中文客户端源码
  • ✓webcontrol/server FastAPI/Socket.IO 与 ZeroMQ 服务端源码
  • ✓上游许可证文件和中文运行说明

部署流程

  1. 1在服务端安装 requirements.txt 并配置机器人类型、主机地址及 5555/5556 通道
  2. 2在客户端执行 npm ci 与 npm run build，再启动静态预览或部署构建产物
  3. 3接入机器人主机后按页面提示验证连接、视频、运动和遥测能力

真实验证结果

已通过 6 个真实运行中文界面、HTTP、可见正文、控制台、坏图和横向溢出质量门。

部署前须知

本地演示模式使用稳定的合成遥测和 JPEG 画面；真实运动控制仍需要可用的机器人主机，生产部署前应单独完成设备安全评估。

部署难度

中等

最低配置

Python 3.11 或更高版本、Node.js 22 或更高版本、npm、pip，以及机器人主机或兼容的 ZeroMQ 模拟器。

开源许可证

Apache-2.0；XLeVR 子目录使用 MIT

最后验证

2026-08-27

技术栈

ReactTypeScriptViteFastAPISocket.IOZeroMQ

授权说明

交付保留根目录 Apache License 2.0 与 XLeVR/LICENSE 的 MIT 条款；中文适配和本地演示模式不改变上游版权归属，使用前应分别核对对应目录的许可证义务。

Release notes

版本记录

1 个已发布版本

vcn-11ab2abb8c50 当前推荐

完成核心控制台中文化，补充本地演示遥测与视频画面，并保留上游服务端控制路径。

部署要求：客户端需要 Node.js 22+ 与 npm；服务端需要 Python 3.11+、requirements.txt 依赖和机器人主机或兼容 ZeroMQ 模拟器。

已知问题：本地演示只用于界面和通信流程验收，不代表真实机器人已连接；真实设备接入前必须复核环境变量、通道和安全边界。

登录后领取