← 返回 2026-06-12

SpatialClaw:重新思考智能体空间推理的动作接口 SpatialClaw: Rethinking Action Interface for Agentic Spatial Reasoning

Seokju Cho, Ryo Hachiuma, Abhishek Badki, Hang Su, Byung-Kwan Lee, Chan Hee Song, Sifei Liu, Subhashree Radhakrishnan, Seungryong Kim, Yu-Chiang Frank Wang, Min-Hung Chen 📅 2026-06-11 👍 111 2026-07-13 08:37
3D推理 代码执行 智能体系统 空间推理 视觉语言模型

SpatialClaw用持久化Python内核替代传统工具调用,提升VLM空间推理能力

前置知识

视觉语言模型(VLM)

视觉语言模型是能够同时处理图像和文本输入的多模态AI系统,通过将视觉编码器和语言编码器结合,实现图像理解、视觉问答、图像描述等跨模态任务。典型的VLM包括CLIP、GPT-4V、Gemma4等,它们通过对比学习或指令微调学习图像和文本之间的语义对齐关系。

本文的核心是增强VLM的空间推理能力,读者需要理解VLM的基本架构和能力边界,才能明白为什么需要外部工具来弥补其空间推理的不足。

空间推理

空间推理是指在三维环境中理解物体位置、方向、距离、运动轨迹以及它们之间空间关系的能力。人类可以轻松回答汽车是否向摄像头移动、哪个物体离桌子最近等问题,但这对AI系统极具挑战性,因为需要从2D图像推断3D几何结构,包括深度估计、相机姿态恢复、多视图几何等计算。

本文解决的核心问题就是VLM的空间推理能力不足,读者需要理解空间推理的复杂性(需要深度、相机姿态、时间对应关系等多种证据的组合),才能认识到为什么现有方法无法很好地处理这类任务。

工具增强智能体

工具增强智能体是一种通过调用外部专业工具来扩展能力的AI系统架构。它将大语言模型作为控制器,根据任务需求选择并调用专门的感知模块(如目标检测器、分割器、深度估计器),通过工具的输出弥补基础模型在特定领域的不足。典型的工具调用方式包括JSON格式的结构化调用和代码生成。

本文的SpatialClaw就是一种工具增强智能体,读者需要理解这个基本概念,才能理解作者提出的代码即动作接口与传统工具调用方式的区别和创新点。

持久化Python内核

持久化Python内核是指在多次代码执行之间保持状态的计算环境,类似于Jupyter Notebook的工作方式。不同于传统程序执行后内存清空,持久化内核会将前一步产生的变量(如分割掩码、深度图、数值数组等)保留在内存中,后续步骤可以直接访问和操作这些变量,无需重新计算。

这是SpatialClaw的核心创新,理解持久化内核的工作原理对于理解为什么它能够实现渐进式分析和灵活的工具组合至关重要。

深度估计和3D重建

深度估计是从2D图像推断每个像素点相对于相机的距离的过程,3D重建则是从单张或多张图像恢复场景的三维几何结构。本文使用的Depth Anything 3(DA3)能够从任意视角的图像估计深度,并结合相机内外参生成密集点云,为后续的空间计算(如距离测量、方向判断)提供几何基础。

这是SpatialClaw工具集中最重要的感知工具之一,读者需要理解它的输出(深度图、相机参数、点云)才能明白后续的几何计算是如何进行的。

研究动机

现有的视觉语言模型在空间推理任务上存在显著不足。具体表现在:第一,VLM需要从2D像素直接推断3D几何关系,包括深度、相机姿态、时间对应关系等,这种从视觉外观到几何论证的结构化分析极其困难;第二,传统的工具增强智能体虽然通过外部感知模块(检测器、分割器、深度估计器)提供了额外的几何信息,但它们的能力受到动作接口设计的限制。现有两类主流接口都存在问题:单次代码执行要求在观察到任何中间结果之前就确定完整的分析策略,无法根据中间证据调整;结构化工具调用通过预定义的API暴露操作,但缺乏灵活性,难以在测试时自由组合操作或根据任务调整分析。例如在图2所示的测距任务中,单次代码生成在发现掩码有效性未检查时无法修订,结构化工具调用缺乏寻找最近点的工具,都导致错误答案。

本文的目标是本文的目标是设计一个适合空间推理的动作接口,使智能体能够灵活地组合、检查和修改感知工具的输出。具体来说,作者希望实现:第一,智能体能够在执行过程中观察到中间结果(如分割掩码、深度图、可视化图表),并根据这些观察调整后续策略;第二,智能体能够自由组合感知工具和数值计算原语(如numpy、scipy),实现测试时才确定的特定计算;第三,系统不需要针对特定基准或模型进行调优,保持零样本泛化能力;第四,提供统一的推理纪律,而不是任务特定的指令,确保方法能够泛化到多种空间推理任务。

与已有工作不同的是,本文的独特切入点在于重新思考动作接口本身的设计对空间推理智能体能力的影响,而不是设计更多的感知工具或更大的模型。作者指出,现有工作要么关注如何设计更好的感知工具,要么关注如何通过微调或强化学习提升工具调用策略,但很少有人系统研究动作接口的表达能力如何限制或赋能智能体。SpatialClaw的核心洞见是将代码不仅仅视为一次性程序或预注册工具的调度接口,而是作为编排空间,让智能体在其中序列化、组合和诊断其可访问的感知工具。这与CodeAct在通用LLM智能体中展示的代码作为动作优于JSON或文本格式的发现一脉相承,但SpatialClaw将其专门应用于空间推理领域,并提供了控制性对比分析和追踪级分析来识别何时代码动作接口有帮助以及哪些空间分析模式驱动了性能提升。

核心方法

SpatialClaw的核心思想是将代码作为空间推理的动作接口,通过持久化Python内核让智能体能够逐步编写、执行和修订Python代码。直观理解是:给智能体一个预加载了输入帧和感知工具的Python环境,让它像人类程序员一样,先进行粗略计算,检查中间结果,根据观察到的证据逐步细化分析,而不是一开始就确定完整的策略。技术路线上,SpatialClaw包含两个核心组件:持久化内核工作空间和外层智能体循环。持久化内核工作空间在每个样本上初始化一次并在系统终止后丢弃,它保持所有中间结果作为普通Python变量,包括分割掩码、深度图、数值数组和渲染图表,使后续代码单元格可以访问、检查、组合和修改这些结果。外层智能体循环是一个五阶段迭代过程,包括规划、代码生成、代码执行、反馈组装和答案提交,循环持续直到智能体提交答案或达到预设的最大步数Nmax=30。

SpatialClaw的核心创新点在于将代码作为动作接口与持久化状态相结合,这与已有方法有本质区别。单次代码生成虽然允许灵活的工具调用,但要求在观察任何中间结果之前就确定完整的分析策略,无法根据观察到的证据调整;结构化工具调用通过预定义的API暴露操作,但限制了自由组合能力,特别是难以表达测试时才确定的自定义计算(如用scipy.spatial.KDTree查找最近邻或用RANSAC估计表面平面)。SpatialClaw通过让智能体在持久化内核中逐步写入可执行的Python单元格,每个步骤都基于之前的所有输出进行条件化,使智能体能够灵活地组合和操作感知结果,适应中间文本和视觉观察以及每个问题的需求。例如在图2c的测距任务中,智能体先进行3D重建和分割,检查掩码质量后计算质心,发现使用中位数不合适后改用KDTree查找最近点,最终得到正确答案0.9439米。

方法步骤详情

SpatialClaw的工作流程包括以下完整步骤:第一,持久化内核工作空间初始化。在每个样本开始时创建一个有状态的IPython内核,注入六个公共入口点:InputImages(采样的帧或图像)、Metadata(帧率、持续时间、帧索引)、tools(感知和几何原语,包括Reconstruct包装Depth Anything 3、SAM3用于分割、以及轻量级掩码操作和几何计算工具)、show(注册图像直接嵌入到智能体下一轮上下文)、vlm(调度到单独VLM会话的查询,返回响应而不将图像嵌入主智能体上下文)、ReturnAnswer(提交候选答案)。第二,规划阶段。规划器运行在单独的LLM会话中,每个样本执行一次,它接收问题、元数据和工具文档(但不接收输入帧以提高效率),生成分析计划和需要获取的证据,然后将计划附加到主智能体的系统提示中。第三,代码生成阶段。主智能体每步产生结构化响应,包含purpose(目的)、reasoning(推理)、next goal(下一步目标)和code(Python代码)四个字段,代码字段实现下一个分析动作。第四,代码执行阶段。执行前静态检查器解析代码的抽象语法树(AST)以拒绝不允许的模块和不安全的内置函数,验证后的单元格在持久化内核中执行。第五,反馈组装阶段。下一轮模型上下文接收执行单元格产生的标准输出、任何失败执行的简洁追踪、新创建变量的类型、长度和大小的摘要,以及通过show注册的用于视觉检查的图像。循环返回第三阶段,除非智能体已提交答案或步数达到最大值Nmax。第六,答案提交阶段。当智能体确定已收集足够证据时,通过ReturnAnswer提交答案,一旦提交的答案符合问题类型的预期格式(如多选、数值或自由文本),循环终止。

技术新颖性

SpatialClaw的技术新颖性体现在三个方面:第一,首次系统研究动作接口设计对空间推理智能体能力的影响,提出了代码作为动作接口的范式,区别于传统的单次代码生成或结构化工具调用;第二,设计了持久化Python内核与迭代执行循环相结合的架构,使智能体能够逐步构建、检查和修订空间分析,这不同于现有方法要么一次性生成完整程序,要么通过预定义API调用工具;第三,提供了全面的实证评估和深入分析,包括控制性对比三种动作接口、消融研究(移除实用函数、移除感知工具)、LLM作为裁判的归因分析(识别52.2%的增益来自代码组合)、失败模式分析(21%为几何计算错误)和工具使用模式分析(距离问题优先使用KDTree和范数,方向问题依赖点积和角度运算),这些分析揭示了动作接口如何影响空间推理性能以及哪些空间分析模式驱动了增益。

SpatialClaw studies code as the action interface for spatial reasoning. Three action interfaces on the same question. (a) A single-pass program chooses a complete computation before seeing its intermediate outputs. (b) A structured tool interface exposes common operations through structured commands (e.g., JSON, XML). (c) SpatialClaw writes Python in a persistent kernel, renders intermediate evidence, and revises the measurement before answering.
Figure 2: SpatialClaw studies code as the action interface for spatial reasoning. Three action interfaces on the same question. (a) A single-pass program chooses a complete computation before seeing its intermediate outputs. (b) A structured tool interface exposes common operations through structured commands (e.g., JSON, XML). (c) SpatialClaw writes Python in a persistent kernel, renders intermediate evidence, and revises the measurement before answering.
Agentic loop for iterative code execution. SpatialClaw wraps a persistent kernel in a five-stage loop. A planner receives the question and tool documentation but not the images, and produces an analysis plan. The main agent generates a Python cell executed in the persistent kernel. Feedback comprising stdout, variable summaries, and images registered via show() is appended to the model context. The loop continues until the agent submits an answer with ReturnAnswer() or the step count has reached the predefined maximum Nmax.
Figure 3: Agentic loop for iterative code execution. SpatialClaw wraps a persistent kernel in a five-stage loop. A planner receives the question and tool documentation but not the images, and produces an analysis plan. The main agent generates a Python cell executed in the persistent kernel. Feedback comprising stdout, variable summaries, and images registered via show() is appended to the model context. The loop continues until the agent submits an answer with ReturnAnswer() or the step count has reached the predefined maximum Nmax.

实验结果

SpatialClaw在20个空间推理基准上取得了59.9%的平均准确率,相比最近的智能体SpaceTools提升了11.2个百分点。Gains在动态4D视频推理和多视图推理上最大,平均提升分别为18.3个百分点(DSI-Bench)和14.3个百分点(MindCube),这些正是需要跨帧和跨视点链式几何计算的类别,没有任何预定义的工具调用能够捕获所需的组合。值得注意的是,这些增益无需修改就能泛化:SpatialClaw在测试的大多数基准和骨干模型上提供了一致的改进,跨越Qwen和Gemma4两个模型家族,参数范围从27B到397B,而无需对系统提示、工具集或基准特定工程进行任何修改。控制性对比三种动作接口的结果显示,SpatialClaw在所有基准上持续优于其他两种接口,在需要多步几何组合的任务上增益最大,平均提升6-9个百分点。LLM作为裁判的归因分析发现,超过50%的SpatialClaw相对于结构化工具调用的成功实例归因于代码组合(即将多个工具调用链接成一个连贯的程序),19.5%归因于控制流(如if或for语句),28.3%为接口中性成功(依赖视觉识别或运气而非智能体动作空间)。消融研究表明,即使移除所有预定义的实用包装器(只保留核心感知工具SAM3/DA3和科学计算库numpy、scipy),性能仍与完整SpatialClaw相当,这表明持久化内核加上科学原语可以在很大程度上补偿缺失的实用工具。移除感知工具(只保留代码即动作接口和科学库)的变体相对于无工具基线获得了2.7个百分点,这孤立了动作接口本身的贡献。

Main results across 20 spatial reasoning benchmarks. For each backbone, we compare a no-tool baseline (thinking mode without tool access) with our SpatialClaw agent framework.
Table 1: Main results across 20 spatial reasoning benchmarks. For each backbone, we compare a no-tool baseline (thinking mode without tool access) with our SpatialClaw agent framework.
Action interface comparison. All variants use the same toolset. Structured Tool-Call exposes the tools through a JSON command interface (Chen et al., 2026). Single-Pass Code generates one complete program before execution.
Table 2: Action interface comparison. All variants use the same toolset. Structured Tool-Call exposes the tools through a JSON command interface (Chen et al., 2026). Single-Pass Code generates one complete program before execution.
Comparison with other spatial agent methods. All use the same Gemma4-31B (Google DeepMind, 2026) backbone model. *: video or multi-image not supported.
Table 3: Comparison with other spatial agent methods. All use the same Gemma4-31B (Google DeepMind, 2026) backbone model. *: video or multi-image not supported.
Analysis on tools of SpatialClaw. We ablate two design choices: No utility function, keeping only the perception tools (SAM3/DA3) and removing perception tools and keeping only the utility functions. We additionally report a no-tool baseline (backbone with thinking only). Each variant is evaluated on subsampled examples (500 per benchmark) across 15 benchmarks due to computation constraints. Gemma4-26B-A4B is used as the backbone for its small size.
Table 4: Analysis on tools of SpatialClaw. We ablate two design choices: No utility function, keeping only the perception tools (SAM3/DA3) and removing perception tools and keeping only the utility functions. We additionally report a no-tool baseline (backbone with thinking only). Each variant is evaluated on subsampled examples (500 per benchmark) across 15 benchmarks due to computation constraints. Gemma4-26B-A4B is used as the backbone for its small size.
SpatialClaw improves spatial reasoning across the board. Per-benchmark accuracy on 20 spatial reasoning benchmarks (Gemma 4-31B backbone), split into two panels by task category. Each axis is individually rescaled so SpatialClaw traces the constant-radius ring. Baselines are SpaceTools-Toolshed (Chen et al., 2026), pySpatial (Luo et al., 2026), and a no-tool backbone.
Figure 1: SpatialClaw improves spatial reasoning across the board. Per-benchmark accuracy on 20 spatial reasoning benchmarks (Gemma 4-31B backbone), split into two panels by task category. Each axis is individually rescaled so SpatialClaw traces the constant-radius ring. Baselines are SpaceTools-Toolshed (Chen et al., 2026), pySpatial (Luo et al., 2026), and a no-tool backbone.
Pairwise win/loss margin of SpatialClaw over baselines across 13 meta-categories. SpatialClaw outperforms both (a) Structured tool-call and (b) Single-Pass Code in 11/13 categories. The largest gains concentrate in categories that demand multi-step geometric composition.
Figure 4: Pairwise win/loss margin of SpatialClaw over baselines across 13 meta-categories. SpatialClaw outperforms both (a) Structured tool-call and (b) Single-Pass Code in 11/13 categories. The largest gains concentrate in categories that demand multi-step geometric composition.
Composition adapts to the question type. Primitive usage frequency across meta-categories.
Figure 5: Composition adapts to the question type. Primitive usage frequency across meta-categories.
Attribution of SpatialClaw's wins over structured tool-call via LLM-as-judge. Over half of the gains are driven by code composition, 19.5% by control flow, and 28.3% are interface-neutral wins on perceptual tasks unaffected by the action interface.
Figure 6: Attribution of SpatialClaw's wins over structured tool-call via LLM-as-judge. Over half of the gains are driven by code composition, 19.5% by control flow, and 28.3% are interface-neutral wins on perceptual tasks unaffected by the action interface.
查看结构化数据
任务指标本文基线提升
单图像空间推理(ERQA) 准确率 61.3% No-tool 58.3% +3.0个百分点
多视图空间推理(MindCube) 准确率 72.8% No-tool 57.5% +15.3个百分点
视频空间4D推理(DSI-Bench) 准确率 62.9% No-tool 45.3% +17.6个百分点
通用视频理解(Video-MME) 准确率 77.0% No-tool 74.8% +2.2个百分点
20个基准平均 平均准确率 59.9% SpaceTools 48.7% +11.2个百分点
Gemma4-31B骨干 平均准确率 59.9% No-tool 53.4% +6.5个百分点
相对于单次代码 平均准确率 59.9% Single-Pass Code 55.2% +4.7个百分点
相对于结构化工具调用 平均准确率 59.9% Structured Tool-Call 56.7% +3.2个百分点

局限与改进

作者承认的主要局限性包括:第一,工具支持的视觉判断能力有限,智能体经常尝试超出其可用工具能力的视觉判断;第二,底层VLM偶尔会产生幻觉,产生场景中实际不存在的物体、属性或空间关系;第三,低级感知原语如检测和分割也会产生局部错误,这些错误会传播到下游推理中;第四,几何计算错误是主要的失败模式(21%的失败实例),即使底层的感知证据是合理的,智能体也经常在处理3D坐标、距离、角度或投影关系时出错;第五,工具选择和覆盖问题占18%的失败,智能体调用了不合适的工具或遗漏了必要的中间步骤。我观察到的额外局限性包括:第一,系统依赖于感知工具(Depth Anything 3和SAM3)的质量,如果这些工具本身在特定场景下失败,整个系统也会失败;第二,代码执行引入了安全风险,虽然作者实施了AST静态分析和正则表达式过滤,但仍可能存在绕过的方法;第三,对于需要实时响应的应用,每轮代码执行和API调用的开销可能无法接受;第四,系统需要为每个样本创建持久化内核,在批量处理时内存开销较大;第五,某些任务上SpatialClaw的性能反而下降(如Qwen3.5-397B在ERQA上下降1.0个百分点),可能是因为在这些任务上VLM本身已经足够强,额外工具引入了额外的复杂性和错误机会。

独立分析的弱点

基于对论文的深入分析,我识别出以下具体的弱点和改进方向:第一,感知工具质量限制。系统依赖的Depth Anything 3和SAM3在特定场景(如极端光照、遮挡、纹理缺乏)下可能产生错误深度估计或分割掩码,这些错误会传播到下游推理。改进方向:引入多模态感知工具融合(如结合LiDAR数据、立体视觉、运动恢复结构),或实现自适应工具选择机制,在检测到工具输出质量低时切换到替代工具或方法。第二,VLM幻觉问题。智能体的底层VLM会产生场景中不存在的物体或关系的幻觉,导致后续错误操作。改进方向:在系统提示中增强验证纪律,要求智能体在生成假设前通过视觉观察(如show渲染分割结果)验证关键假设;或引入反向验证机制,在提交答案前检查计算结果与视觉证据的一致性。第三,几何计算错误。21%的失败来自几何计算错误,即使感知证据正确,智能体仍可能在处理3D坐标、距离、角度时出错。改进方向:引入几何计算验证库,自动检测常见的几何错误(如坐标系混淆、单位错误、投影计算错误);或通过强化学习训练智能体更好地进行几何计算,特别是在多步链式计算中的状态保持。第四,工具选择错误。18%的失败来自工具选择或覆盖错误,智能体调用不合适的工具或遗漏必要步骤。改进方向:实现自动工具推荐系统,根据问题类型和当前状态建议相关工具;或通过示例驱动的few-shot学习,在系统提示中提供工具使用的正确示例。第五,错误恢复能力不足。智能体在检测到不一致时往往无法恢复,要么坚持错误的早期假设,要么来回震荡而不收敛。改进方向:实现自动错误检测和恢复机制,当检测到矛盾(如计算距离与视觉观察不一致)时,触发系统级的重新规划;或引入回溯机制,允许智能体回到早期步骤并尝试替代路径。第六,计算效率和资源开销。每步代码执行和API调用增加了延迟,持久化内核在批量处理时内存开销较大。改进方向:实现内核状态压缩和缓存策略,避免存储不必要的中间结果;或引入增量执行机制,只重新执行受后续修改影响的代码单元格。

未来方向

作者提出的未来研究方向包括:第一,应用强化学习来改进智能体循环内的工具选择、几何运算编码和错误恢复。这可以解决当前基于规则的系统提示方法的局限性,让智能体通过试错学习最优的工具使用策略和错误恢复模式。第二,扩展工具集以支持更多类型的感知和几何原语,如目标追踪、光流估计、语义分割、实例分割等,以支持更广泛的空间推理任务。第三,将SpatialClaw与物理引擎集成,使智能体不仅能够观察和分析场景,还能够进行物理预测(如物体碰撞、运动轨迹),这对于机器人导航和操作等应用场景至关重要。第四,探索与其他模态的集成,如音频、触觉传感器数据,实现多模态空间推理。基于本文成果,可以延伸的研究方向包括:第一,自适应系统提示。当前系统提示是固定的,但可以根据任务类型和难度动态调整,在简单任务上简化流程以提高效率,在复杂任务上提供更详细的指导。第二,分层空间推理。将空间推理分解为多个抽象层次,从低级的像素级分析到高级的场景语义理解,实现渐进式细化和验证。第三,交互式空间推理。允许人类用户介入,在智能体推理过程中提供反馈或纠正,实现人机协作的空间推理。第四,跨模态空间推理。研究如何将空间推理能力从视觉扩展到其他模态,如从文本描述构建3D场景、从音频定位声源等。第五,领域特定的空间推理。针对机器人、自动驾驶、增强现实等特定应用场景,优化工具集和推理纪律,提供领域特定的空间原语和验证机制。

复现评估

SpatialClaw的复现情况如下:代码方面,作者声明代码已开源(论文中提到Links: Code · Project Page),读者可以访问GitHub仓库获取完整实现。数据方面,评估使用的20个基准测试都是公开数据集,每个基准都有明确的评估协议(准确率Acc、平均相对精度MRA、视图变化推断VCI),论文在Table 5中详细列出了每个基准的评估指标和评分协议。对于超过1000个样本的基准,作者评估了固定种子随机选择的1000个样本子集,相同的子集可以通过运行补充代码使用相同种子复现。算力方面,系统需要运行大型语言模型(从26B到397B参数)和感知模型(Depth Anything 3和SAM3),这需要大量的GPU资源。作者提到系统使用vLLM服务语言模型,通过HTTP服务托管感知模型,这意味着需要多个GPU节点分别服务LLM和感知模型。具体来说,作者使用的是DA3Nested-Giant-Large变体和SAM3。难度方面,复现难度较高,主要原因包括:第一,需要下载和部署多个大型模型(LLM、Depth Anything 3、SAM3),这些模型需要大量存储和计算资源;第二,系统架构相对复杂,包括持久化IPython内核、安全沙箱、HTTP服务、前缀缓存等组件,需要仔细配置;第三,20个基准测试的数据获取和预处理可能比较耗时;第四,完整的评估需要大量的计算时间(每个样本最多30步,每步包括LLM推理和可能的感知模型推理)。但是,作者提供了详细的实现细节(在补充材料的E、F、G节),包括系统配置、输入预处理、持久化内核实现、安全沙箱、错误处理、提示设计和工具API参考,这降低了复现难度。此外,作者使用相同的超参数、系统提示和感知工具跨所有基准和骨干模型,这意味着复现者不需要针对特定任务进行调优。总的来说,虽然SpatialClaw的复现需要较多的计算资源和时间,但详细的文档和开源代码使得有经验的研究人员能够复现主要结果。