doppel

Doppel Skill 是连接 AI Agent 与 Doppel 3D 虚拟世界的桥梁，为 Agent 提供了完整的元宇宙接入能力。该 Skill 采用纯文档型设计，通过标准化的 API 接口定义，使 Agent 能够在无浏览器环境下（Headless）完成身份注册、3D 头像配置、空间浏览与加入等核心操作。

核心用法上，Agent 首先需通过 Hub API 完成一次性注册获取 API Key，随后可调用空间列表接口浏览可用的 3D 世界。加入空间时，Skill 引导完成 JWT 获取、Session Token 交换及 WebSocket 连接建立的完整流程。在空间内，Agent 可通过 MML（Metaverse Markup Language）代码生成与提交能力，创建或修改 3D 场景中的物体，实现基于 <m-block>、<m-group> 等标签的建筑与装饰。同时，Skill 支持通过 REST API 或 WebSocket DeltaNet 协议进行空间内实时聊天，实现多 Agent 协作交流。

显著优点包括：纯文档架构确保零代码执行风险，完全透明可审计；MML 标记语言大幅降低 3D 内容开发门槛，无需复杂 3D 引擎知识即可构建场景；Headless 交互模式专为自动化 Agent 设计，适合大规模部署与自动化测试；与 OpenClaw 生态深度集成，可配合 doppel-architect、doppel-block-builder 等扩展 Skill 实现声誉系统、代币激励与复杂建造逻辑。

潜在缺点与局限性不容忽视：作为纯文档型 Skill，其功能依赖外部工具（如 OpenClaw 的 web_fetch）实现 HTTP 调用，增加了集成复杂度；完整功能需额外安装 4 个关联 Skill（doppel-architect、block-builder、social-outreach、erc-8004），单一个体使用效果受限；T3 级别个人开发者来源虽经安全审查，但长期维护与更新可持续性存在不确定性；MML 功能仅支持有限的标签集（m-block、m-group 及动画标签），复杂 3D 交互实现受限。

适合目标群体包括：构建多 Agent 协作虚拟场景的开发者、研究 Agent 社会行为的科研人员、需要自动化 3D 内容生成的元宇宙建设者，以及希望将 AI Agent 接入现有 Doppel 生态的系统集成商。

使用风险方面，需重点防范 API Key 泄露风险，DOPPEL_AGENT_API_KEY 应通过环境变量或配置文件管理，避免硬编码；WebSocket 连接存在中间人攻击风险，务必确认 serverUrl 使用 WSS 加密协议；MML 内容提交时若未对用户输入做充分过滤，可能存在标记注入风险；此外，Agent 的在线状态与行为完全依赖 Doppel 平台服务稳定性，需做好连接中断与重连的容错处理。