龙虾OpenClaw v0.8.3支持AGENTS.md协议：AI Agent能力标准化声明与运行时校验
Feature Request: Support AGENTS.md — 龙虾生态首个标准化Agent能力描述协议落地在即
龙虾官网（yitb.com）确认：社区高票提案《Feature Request: Support AGENTS.md》已进入v0.8.3内测分支，预计6月15日随OpenClaw v0.8正式版上线。该功能将首次在开源AI Agent框架中强制要求以AGENTS.md文件声明模型能力边界、工具调用契约、输入/输出Schema及安全约束——不是文档建议，而是运行时校验依据。开发者提交Agent到龙虾Registry前，必须通过claw validate --strict校验该文件；未通过者无法注册、不可被claw install拉取。这意味着，AI Agent正从“能跑就行”的脚本阶段，迈入可验证、可组合、可审计的工程化阶段。
为什么一个Markdown文件能改变Agent开发范式？
AGENTS.md不是README的翻版。它采用YAML Front Matter + Markdown Body结构，强制包含4个核心区块：
capabilities: 列出支持的原子动作（如web_search,read_file,execute_python），标注是否需用户授权；tool_schema: 每个工具的OpenAPI 3.1兼容JSON Schema，含parameters.required与responses.200.content.application/json.schema；input_constraints: 定义输入长度上限、禁止的正则模式（如^[a-zA-Z0-9_\-\.]+$）、敏感词黑名单；security_policy: 明确数据驻留地（region: cn-shanghai）、是否允许外网回调（allow_webhook: false）、沙箱级别（sandbox: strict）。
OpenClaw Runtime在加载Agent时会解析此文件，并在claw run前执行静态校验——例如发现tool_schema中execute_python未声明timeout: 3000ms，则直接拒绝启动。这把传统靠文档约定的“君子协议”，变成了编译器级的强制契约。
实际影响：从调试噩梦到跨团队协作
此前，一个Devin风格的代码Agent交付给运维团队时，常因“没说清楚能否读取/etc/passwd”或“未声明Python沙箱是否禁用os.system”导致线上事故。现在，AGENTS.md让这些隐性假设显性化。某电商客户实测：接入该协议后，Agent集成耗时从平均17小时降至2.3小时；CI流水线中claw test --coverage可自动比对input_constraints与测试用例覆盖度，未达95%覆盖率的PR被自动拦截。更关键的是互操作性提升——当龙虾Agent调用Qwen-Agent时，claw link qwen-agent会自动解析其AGENTS.md中的tool_schema，生成TypeScript类型定义并注入VS Code IntelliSense，开发者无需手写适配层。
👉 Binance · OKX · Gate.io · HTX · Bitget
开发者立刻能做的三件事
- 升级CLI并初始化模板：
npm install -g @openclaw/cli@next && claw init --agent my-crawler，自动生成带完整注释的AGENTS.md骨架； - 用
claw validate做准入检查：在GitHub Actions中加入步骤- run: claw validate --strict，失败则阻断发布； - 复用Registry中的能力声明：访问registry.yitb.com/agents点击任意Agent，查看其
AGENTS.md原始文件——所有已上架Agent（含Hermes-3.5、Manus-Edge）均已按v0.1规范补全，可直接claw install并依赖其Schema做类型安全调用。
行业意义：比OpenAPI之于API更进一步
OpenAPI让REST API可发现、可测试；AGENTS.md让AI Agent可推理、可编排。当100个Agent都声明了capabilities: [web_search, parse_pdf]且tool_schema严格一致时，“自动组装一个招标文件分析工作流”就不再是Demo，而是claw compose --require web_search,parse_pdf --output tender-analyzer一条命令的事。龙虾选择Markdown而非纯YAML，是为保留人类可读性——安全策略用自然语言写"禁止调用任何数据库连接字符串"，比JSON Schema的pattern: "^(?!.*[pP][aA][sS][sS][wW][oO][rR][dD]).*$"更难绕过。这不是给AI看的协议，是给工程师、法务、合规官共同阅读的合约。
如果你正在维护一个Agent项目，今天就打开终端：claw init --agent $YOUR_PROJECT && vim AGENTS.md。别等别人定义你的能力边界——先把它写下来，然后让整个生态按你写的规则运行。
相关阅读