SpatialClaw是什么
首先来了解SpatialClaw的具体背景。这是由NVIDIA Research与KAIST(韩国科学技术院)联合推出的一款无需训练即可使用的空间推理框架,其核心设计理念非常巧妙——依托“代码即动作”机制,在持久化的Python内核中循环执行复杂的3D/4D空间推理任务。实际表现相当出色:在20项基准测试里,平均准确率达到了59.9%,相较此前最优方法提升了整整11.2个百分点。这样的性能跃升,在该领域内无疑是极为亮眼的突破。
SpatialClaw的主要功能
- 代码即动作接口:智能体能够在持久化Jupyter内核中逐单元格编写Python代码,灵活组合深度重建、分割掩码等多种感知工具的输出结果,操作自由度极高。
- 五阶段智能体循环:整个流程涵盖规划、代码生成、AST安全校验、执行与反馈组装、答案提交或迭代修正五个环节,构成完整闭环。
- 多模态感知集成:原生兼容Depth Anything 3、SAM 3等主流视觉工具,同时结合NumPy/SciPy进行实时几何计算,能力范围相当广泛。
- 完全免训练部署:同一套系统提示词与工具集,可直接在Qwen3.5/3.6、Gemma4等6种不同骨干网络上运行,无需任何额外训练。
- 动态4D推理支持:无论是单张图像、多视角图片、视频片段还是4D时序场景,都能完成空间关系理解与度量计算。
SpatialClaw的技术原理
- 代码即动作接口:SpatialClaw将传统的结构化工具调用方式,替换为直接生成Python代码。VLM在持久化Jupyter内核中能够自由编写、执行并修正代码,动作空间不再受限于预定义的JSON格式,理论上任何复杂的空间计算逻辑均可实现。
- 五阶段智能体循环:上述五阶段循环中,执行后的变量状态与可视化结果会作为多模态反馈传回VLM,驱动下一步代码的修正优化。这一迭代机制是整个系统性能的关键所在。
- 持久化Jupyter内核:代码执行后,变量与对象均保留在内存中,后续单元格可直接复用中间结果,从而支持多步迭代推理。内核中的matplotlib输出会被捕捉为图像反馈,让VLM能够“观察”计算过程,并据此调整策略。
- 感知工具集成:Depth Anything 3、SAM 3等视觉基础模型以Python模块形式对外开放,VLM通过代码自由编排深度估计、分割掩码生成以及NumPy/SciPy几何计算,实现模块化的灵活组合。
- AST安全校验:借助抽象语法树进行静态分析,拦截危险调用。仅允许白名单内的感知工具与数学库执行,既能有效防范恶意代码,也能控制资源占用上限。
如何使用SpatialClaw
- 环境准备:克隆GitHub仓库,配置好持久化Jupyter内核以及Depth Anything 3、SAM 3等依赖工具。
- 模型接入:选择Qwen3.5/3.6或Gemma4等受支持的VLM作为推理骨干。
- 任务输入:提交包含空间推理问题的图像、多视角图片或视频数据。
- 智能体循环:系统将自动执行规划、代码生成、AST校验、执行与反馈组装的迭代循环。
- 结果获取:从内核变量状态与可视化输出中,提取最终的空间推理答案。
SpatialClaw的核心优势
- 免训练即插即用:无需针对任何基准或模型进行微调,大幅降低了部署门槛与算力成本。
- 代码动作灵活性:相较于固定的JSON工具调用,Python代码的表达能力强大得多,任意复杂的空间计算逻辑都能轻松驾驭。
- 显著性能领先:在DSI-Bench与MindCube等动态任务上,分别提升了17.6和15.3个百分点,这一优势相当明显。
- 跨模型通用性:同一套架构在26B至397B参数规模的6种不同VLM上,均取得了一致的性能增益。
- 安全执行保障:内置AST安全校验机制,可有效防止恶意代码执行,确保内核状态稳定可靠。
SpatialClaw的项目地址
- 项目官网:https://spatialclaw.github.io/
- GitHub仓库:https://github.com/NVlabs/SpatialClaw
- arXiv技术论文:https://spatialclaw.github.io/static/pdfs/spatialclaw.pdf
SpatialClaw的同类竞品对比
| 维度 | SpatialClaw | SpaceTools |
|---|---|---|
| 定位 | NVIDIA与KAIST联合发布的免训练空间推理智能体框架 | 此前最优的空间智能体基线方法 |
| 动作接口 | 代码即动作,在持久化Jupyter内核中生成并执行Python代码 | 结构化工具调用,以固定JSON格式调用预定义感知工具 |
| 训练需求 | 完全免训练,同一套提示词直接运行在6个不同VLM上 | 需要针对特定基准或模型进行训练/微调 |
| 支持模态 | 单图、多视图、视频与4D时序场景 | 主要支持单图与多视图,动态4D能力有限 |
| 核心机制 | 五阶段循环(规划→代码生成→AST校验→执行反馈→迭代修正) | 单步或有限步的工具链编排,无代码级反馈循环 |
| 动态4D性能 | DSI-Bench提升+17.6,MindCube提升+15.3,原生支持时序推理 | 动态任务表现较弱,缺乏时序状态累积机制 |
| 迭代纠错 | 执行错误与变量状态回传VLM,支持代码级自主修正 | 工具调用出错后难以自动修复,通常需人工干预 |
SpatialClaw的应用场景
- 机器人导航与抓取:为移动机器人与机械臂提供精确的物体公制距离测量与空间关系判断,辅助路径规划及抓取姿态决策。
- AR/VR室内布局:自动识别家具、门窗等元素的相对位置与尺寸,生成合理的室内摆放方案,并实时叠加于虚拟空间之中。
- 自动驾驶感知:融合多摄像头输入进行3D场景重建,理解道路元素的空间拓扑关系,以支持后续决策规划。
- 建筑安全巡检:基于多视角图像分析工地结构的空间合规性,检测脚手架间距、防护栏高度等关键安全指标。
- 工业精密测量:通过多视图深度估计,对零部件进行非接触式三维尺寸测量与形位公差检测。
