Agent Space普通目录格式指不依赖特殊框架、仅用标准文件系统结构即可被多数Agent平台识别的最小可行目录组织方式，核心包括：①顶层目录名即Agent ID（如sales-report-v2）；②内置skills/子目录；③根目录下存在config.yaml或agent.json之一。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space普通目录格式指的是在AI Agent开发中，不依赖特殊框架或运行时约定、仅用标准文件系统结构就能被多数Agent平台识别并加载的最小可行目录组织方式。它不包含编译产物、配置清单文件或元数据描述，仅靠目录名、子目录层级与固定命名的文件组合，就能让Agent运行时自动挂载为独立工作空间。
核心构成：三个必需元素
① 顶层目录名即Agent ID：该目录名必须是合法路径标识符（如sales-report-v2），不能含空格、中文或控制字符，【这是Agent Space被唯一识别的前提】；
② 内置skills/子目录：存放所有可调用技能脚本（如skills/fetch_sales_data.py），路径必须为相对skills/起始；
③ 存在config.yaml或agent.json之一：位于根目录下，用于声明模型端点、默认工具列表和记忆策略，缺失则运行时抛出ConfigNotFoundError。
常见变体与兼容性说明
方法一：OpenClaw兼容格式
根目录下必须有workspace/子目录，且该目录内存在.env和memory/；skills/可选，但若存在，其下每个.py文件需含def run(...)入口函数。
使用 dm.bot API 进行加密的智能体间消息传递。适用于向其他智能体发送私信、发布公开消息、查看收件箱、管理群组或设置 webhook。触发词包括 dm.bot、智能体消息或加密通信。
方法二：Vercel Eve原生格式
不要config.yaml，改用model/目录（含llm.yaml）+ tools/目录（含web_search.py等）+ prompt.md三者共存；【Eve会忽略config.yaml，只认这三个路径】。
方法三：AgenticFS挂载格式
只需一个空目录，目录名带@前缀（如@reporting-agent），其余全由AgenticFS动态注入配额、凭证与沙箱规则，本地无需任何文件。
验证是否符合普通目录格式
第一步：执行ls -F your_agent_space/
确认输出中包含skills/、config.yaml（或agent.json）、无build/或__pycache__/等构建残留目录。
第二步：检查config.yaml是否能被PyYAML安全加载：python -c "import yaml; print(yaml.safe_load(open('config.yaml')))"，报错即格式非法。
第三步：进入目录后运行pwd，路径末尾不能出现符号链接，【AgenticFS和OpenClaw均拒绝软链路径作为Space根】。
