智元灵犀X2机器人二开,从 0 到 1 入门智元灵犀 X2 二次开发

六篇实战系列。覆盖端侧 AIMDK、云端灵心 AgentSDK，以及端云联合与复杂场景 Agent 架构。

解决什么问题

灵犀 X2 的二开不是一套 SDK，而是两套并行体系：

• 端侧 AIMDK（ROS 2 Humble）—— 实时控制、感知、音频采集，代码跑在机器人本体
• 云端灵心 AgentSDK（WebSocket）—— 语义理解、LLM、TTS，代码跑在你的服务器

两者可以协同，也可以单独使用。本系列按”能跑起来 → 能跑对 → 能跑在复杂场景”的顺序推进，每一篇都对应一个可验证的产出。

阅读路径

graph LR
    A["01 认知与全景"] --> B["02 端侧环境"]
    A --> D["04 云端 AgentSDK"]
    B --> C["03 端侧接口实战"]
    C --> E["05 端云联合"]
    D --> E
    E --> F["06 复杂场景 Agent"]

按手头资源选择入口：

你的情况	路径	说明
只有机器人	01 → 02 → 03	端侧链路独立可用
只有云端账号	01 → 04	用文本即可跑通全流程，不需要真机
两者都有	01 → 02 → 03 → 04 → 05 → 06	02/03 与 04 可并行
只做架构设计	01 → 04 → 05 → 06	跳过真机操作

篇目

篇	标题	产出	需要真机
01	认识灵犀 X2 与二开全景	路线选择判断 + 端云平台心智模型	否
02	端侧环境搭建与第一个 AIMDK 程序	可运行的 ROS 2 状态查询节点	是
03	端侧接口实战：控制、交互与感知	动作编排脚本 + 端侧接口速查	是
04	云端 AgentSDK：被动交互与语义技能	合规的云端应答 Agent	否
05	端云联合：语音意图控制动作与导航	修复版端云工程 + 缺陷定位能力	是
06	从 Demo 到产品：复杂场景下的智能 Agent	四层闭环架构 + 两个落地案例	否

技术前提

内容	需要到什么程度
ROS 2	理解 node / service / topic 三个概念即可（02 篇会用到）
Python 3	线程、异步、JSON 处理
WebSocket	长连接、心跳、重连的基本概念（04 篇会讲）

全局约定

这三条在每一篇都会出现：

1. 运控计算单元（PC1，10.0.1.40）不可部署二开程序 —— 它承担运控等高实时任务，占用其算力会直接影响行走安全。
2. 跨板 ROS service 必须加异常处理与快速重试 —— 这是官方在文档中明确提出的要求，实际场景使用需格外注意。
3. app_key / app_secret 不可硬编码进代码或写入日志 —— 泄露后需立即在灵心开放平台重置。

参考资料

• 端侧文档：智元 X2 AIMDK —— https://x2-aimdk.agibot.com/zh-cn/latest/index.html
• 云端文档：LinkSoul AgentSDK v1.4.0 - https://open.agibot.com/docs/linksoul/agentsdk_docs/python/v140/zh
• 官方 demo,端侧demo在sdk下有源代码,机器人开发机上也有aimdk目录下
• 智元AIMA开放平台