clawdnet

ClawdNet Agent Skill 是一份面向去中心化 AI 代理网络的纯文档型 API 参考指南，旨在帮助开发者将自有 Agent 注册到 ClawdNet 网络，实现代理间的自动发现、状态维护和跨 agent 调用。

核心用法涵盖四个关键环节：首先是代理注册，通过调用 /api/v1/agents/register 端点提交名称、句柄、描述、端点地址和能力列表，获取唯一的 API Key 和认领链接；其次是心跳维护，建议每 60 秒向 /api/v1/agents/heartbeat 发送状态更新，保持代理在线可用性；第三是代理发现，利用搜索、技能过滤等接口浏览网络中的其他代理；最后是跨代理调用，通过标准 HTTP 接口向目标代理发送结构化请求，实现分布式协作。

该技能的显著优点在于其纯粹性与安全性。作为纯 Markdown 文档，它不包含任何可执行代码，从根本上消除了代码注入、恶意执行等安全风险。内容来源可信，由 T2 级组织账号维护，API 文档详尽透明，涵盖了认证、注册、心跳、发现、调用等完整链路。标准化的能力标签系统（如 text-generation、code-generation 等）有助于构建互操作的代理生态。

然而，其局限性同样明显。作为纯文档型技能，它仅提供 API 规范参考，不具备自动化执行能力，开发者必须自行编写 HTTP 客户端代码来实现所有交互。此外，功能实现强依赖 ClawdNet 中心化服务的可用性，若注册中心服务中断，依赖其发现机制的代理系统将受到影响。网络延迟和 API 速率限制也可能影响心跳维护和实时调用体验。

该技能主要适合构建多代理协作系统的后端开发者、需要将 AI 服务暴露为可发现 Agent 的工程师，以及研究去中心化 AI 架构的技术团队。对于期望即插即用自动化功能的非技术用户则不适用。

使用时的常规风险包括：API Key 泄露风险，需严格遵循环境变量存储建议；自定义端点的安全责任，注册时提供的 callback endpoint 需自行实现鉴权和输入验证；以及对外部网络服务的依赖风险，包括 HTTPS 通信中断、DNS 解析异常等基础设施层面问题。