ClawDirect Dev

遵循ClawDirect模式,构建基于ATXP认证的面向Agent的Web体验。适用于通过MCP工具构建AI Agent交互网站、实现基于Cookie的Agent认证,或为Web应用创建Agent技能。提供使用@longrun/turtle、Express、SQLite和ATXP的模板。

安装

概览

ClawDirect Dev 是一个专为构建面向 AI Agent 的 Web 体验而设计的开发框架,其核心理念是遵循 ClawDirect 模式,通过 ATXP(Agent Transaction Protocol)认证机制为 Agent 提供安全、可信的交互环境。该工具集整合了现代 Web 开发的关键技术栈,包括 Express.js 用于构建 Web 服务、@longrun/turtle 实现 MCP(Model Context Protocol)服务端点、SQLite 数据库管理用户状态,以及 ATXP 协议处理 Agent 身份验证与交易支付。这种架构使得开发者能够快速搭建既能被浏览器自动化工具访问,又能通过程序化接口直接调用的双模系统。特别地,它采用基于 Cookie 的身份验证桥接方案,解决了 Agent 浏览器难以直接设置 HTTP-only 安全 cookie 的技术难题——通常建议将认证 cookie 值通过 URL 查询参数传递(如 ?myapp_cookie=XYZ),由服务器代为设置并清理链接,从而兼顾安全性与兼容性。整个项目结构清晰,提供了完整的模板代码和部署指南,支持从本地开发到云端发布的无缝衔接。

核心功能特点

  1. 基于 ATXP 协议实现 Agent 身份认证与可选支付功能
  2. 集成 MCP 工具体系,支持 Agent 程序化调用 API 能力
  3. 独创 Cookie 桥接认证模式,兼容浏览器模拟与直接接口访问
  4. 内置 SQLite 数据库管理认证凭证与用户数据
  5. 提供 Express + TypeScript 全栈开发模板,开箱即用
  6. 支持一键发布至主流云平台(Render/Railway/Fly.io 等)

适用场景

ClawDirect Dev 主要适用于需要与智能代理(AI Agent)进行深度集成的 Web 应用场景。典型用例之一是构建可被 MCP 客户端直接调用的技能型网站,例如自动化客服助手平台、智能内容生成服务或数据分析仪表盘。这些场景要求系统不仅能响应人类用户的自然语言指令,还需能接收来自外部 Agent 的精准 API 请求并完成特定任务,如执行付费操作或获取受保护的数据资源。另一个重要适用场景是开发面向 Agent 生态的 SaaS 产品目录,即允许第三方 Agent 发现并使用你的服务——这正是 ClawDirect 目录所服务的目标。此外,对于希望在其应用中嵌入 Agent 协作能力的开发者而言,此框架也极具价值,比如让企业内部流程自动化系统能够主动调用外部 Agent 完成采购审批、报告撰写等复杂工作流。无论是初创团队打造首个 Agent 友好型应用,还是成熟企业扩展智能化服务能力,ClawDirect Dev 都能显著降低技术门槛,加速产品落地。