> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.alephant.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server. # OpenClaw 服务 x402 端点 > 使用 Alephant 将 OpenClaw 服务转为可变现的 x402 端点 OpenClaw 服务不止可以作为内部工具服务。只要服务暴露稳定的 HTTP API，并返回可预测的 JSON 响应，Alephant 就能将其封装为受治理、具备支付能力的 x402 端点，供其他开发者和智能体付费调用。 核心思路很简单： ```text Buyer or agent -> Alephant x402 Paid Endpoint -> Alephant Agent -> OpenClaw service HTTP endpoint -> OpenClaw skill execution -> Stable JSON result -> Alephant trace, cost, revenue, and margin record ``` 本页以 `News Report Service` 为例。相同模式适用于任何能够接收 JSON 请求、在背后运行技能或工具并返回稳定响应的 OpenClaw 服务。 ## 视频演示 观看在 Alephant 中将 OpenClaw 服务配置为 x402 端点的过程。 [Open the Loom walkthrough](https://www.loom.com/share/1a509da77eaf40fb87ac6e6f319cd128) ![OpenClaw Service x402 Endpoint architecture](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/67c061306693a171db3962142dec232f7ab56ac715ddc1571150a7c8d393201e/docs/assets/openclaw/openclaw-x402-architecture.svg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T035108Z&X-Amz-Expires=604800&X-Amz-Signature=def6cea506c080e39d61eb2bee6a457d4e60f73ec3eaae843189237fdc1642ad&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## 准备内容 创建付费端点前，请确保已具备： * 已部署到生产环境的 OpenClaw 服务。 * 一个稳定的 HTTPS 端点，例如 `POST /v1/news/report`。 * 买方可以依赖的 JSON 请求与响应契约。 * 不暴露运行日志、回溯信息、密钥、本地文件路径或内部主机名的响应体。 * 可在其中创建智能体和付费端点的 Alephant 工作区。 * 用于接收 x402 付款的钱包或结算配置。 ## 1. 将 OpenClaw 服务准备为 API 在 Alephant 将其转为付费端点之前，OpenClaw 服务应表现得像一个可正常调用的 API。在新闻报告示例中，上游运行时接收 `POST` 请求，并在 JSON 对象中返回英文 Markdown 报告。 对于付费端点，应将 OpenClaw 服务边界配置为公开契约： | 设置 | 建议值 | 原因 | | --------------- | -------------------------- | ---------------------------------------- | | HTTP 方法 | `POST` | 付费工具调用通常发送结构化 JSON 输入。 | | 路径 | 稳定的路径，例如 `/v1/news/report` | 这是支付校验通过后 Alephant 转发请求的目标路径。 | | 身份验证 | 网关来源验证或私有网络访问 | 买方不应直接调用 OpenClaw；Alephant 应继续作为支付和策略关卡。 | | 请求 Content-Type | `application/json` | 让客户端和智能体易于调用端点。 | | 响应格式 | 一个稳定的 JSON 对象 | Alephant、智能体和客户端应用可预测地解析结果。 | | 超时 | 明确的服务超时 | 新闻收集和 AI 格式化可能比简单的数据库查询更慢。 | | 并发 | 配置服务限制 | 防止付费流量压垮上游 OpenClaw 工作进程。 | 不要将上游 OpenClaw URL 作为产品契约。公开契约是 Alephant x402 端点；OpenClaw URL 是该端点背后的私有转发目标。 ## 2. 定义请求与响应契约 只有调用方知道该发送什么以及会收到什么，Alephant 才能将服务变现。请让 OpenClaw 请求 Schema、响应 Schema 和示例与实际运行时保持一致。 请求体示例： ```json { "preset": "ai", "limit": 3, "deep_fetch": false } ``` 字段说明： | 字段 | 类型 | 默认值 | 说明 | | ------------ | ------- | ------- | ----------------------------- | | `preset` | string | `ai` | 当服务支持多种报告模式时，选择新闻报告预设。 | | `limit` | integer | `3` | 要包含的新闻条目最大数量。范围应足够小，以保证延迟可预测。 | | `deep_fetch` | boolean | `false` | 买方需要更丰富的报告时，启用更深入的上游抓取。 | 成功响应示例： ```json { "status": "ok", "tool": "ai_news_report", "format": "markdown", "content": "# AI News Report\n\n## 1. Market headline..." } ``` 错误响应示例： ```json { "status": "error", "code": "UPSTREAM_TIMEOUT", "message": "The news report timed out before completion." } ``` 良好的付费端点响应应当： * 返回一个 JSON 对象，而非原始日志流或任意工具输出列表。 * 包含清晰的成功或错误字段，例如 `status`。 * 避免泄露 API 密钥、原始 stderr、回溯信息、钱包元数据、本地路径或 OpenClaw 内部执行细节。 * 在各服务版本间保持字段名稳定。 * 返回客户端能够处理的、带 HTTP 状态码的有用错误。 ## 3. 在 Alephant 中创建智能体 在 Alephant 中创建一个代表 OpenClaw 服务运行时的智能体。 为智能体身份选择 **AI Agent**，然后将生产 OpenClaw HTTP 端点连接为运行时连接。之后即可将此端点关联到智能体付费端点。 ![Create an Alephant Agent for an OpenClaw runtime](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/418899689e12e92ddb4a4ca650220d42a2454a83dd9971e5acd918bc3b78157b/docs/assets/openclaw/alephant-create-workflow-agent.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T035108Z&X-Amz-Expires=604800&X-Amz-Signature=2702d619f25880f55fcd8417904750e2c2d6bf719e91d10e8eecfedb79a8df41&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 使用描述付费能力而非内部实现的名称和说明。例如： | 字段 | 示例 | | ------------------ | -------------------------------- | | Agent Type | `AI Agent` | | Runtime Connection | `Custom Webhook` | | Agent Name | `News Report Service` | | 描述 | `抓取真实 AI/科技新闻并返回英文 Markdown 报告。` | | 环境 | `Production` | 连接运行时时，请使用生产 OpenClaw URL，例如 `https://openclaw.example.com/v1/news/report`。如果 OpenClaw 服务需要网关签名密钥或私有请求头，请在运行时连接中配置，以免买方看到它们。 ## 4. 创建 x402 付费端点 智能体创建完成后，在 Alephant 中新建一个智能体付费端点。 ![Create a new Agent Paid Endpoint basic info](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/37b7b641fb9fffe85c897f9eaa6f1f5cb431bdf8597c85fcd26efd53986252a6/docs/assets/openclaw/alephant-create-paid-endpoint-basic-info.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T035108Z&X-Amz-Expires=604800&X-Amz-Signature=6236a665aaee02102195dd6c9a44a8b010e82707d9fb7c5b9ea3ec36e0215704&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 先配置端点基本字段： | 字段 | 示例 | 说明 | | -------- | --------------------------------------------- | ---------------------------------------------- | | 端点类型 | `Agent Endpoint` | 该端点调用关联的 Alephant 智能体。 | | 关联智能体 | `News Report Service` | 选择上一步创建的智能体。 | | 端点名称 | `News Report Service` | 用户会在市场或端点列表中看到该名称。 | | 端点 Slug | `news-report-service` | Alephant 会将其暴露在 `/x402/news-report-service` 下。 | | 方法 | `POST` | 与 OpenClaw 服务方法一致。 | | 转发目标 URL | `https://openclaw.example.com/v1/news/report` | 生产 OpenClaw 端点。不要在公开文档中暴露本地或私有主机名。 | | 描述 | `抓取真实 AI/科技新闻并返回英文 Markdown 报告。` | 面向用户的描述应具体且聚焦能力。 | 然后完成商业配置： * 设置每次调用的价格。 * 选择 x402 配置支持的结算网络和资产。 * 配置速率限制、买方访问、预算护栏和滥用控制。 * 决定以私有、内部还是市场形式发布。 * 在广泛分发前确保收款钱包和收入提现设置已就绪。 x402 使用 HTTP `402 Payment Required` 流程。调用方请求端点、收到付款要求、提交已签名付款载荷，并在付款验证和策略检查通过后收到 OpenClaw 服务结果。 ### 添加 Schema 与示例 端点发现需要 Schema。外部智能体通过它了解参数、预期响应和定价要求。 ![Configure paid endpoint schemas and examples](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/11ddcb399c3ebbf5e89aa2e279bb16c53ccb24cf782d327389fce52d23aad05a/docs/assets/openclaw/alephant-paid-endpoint-schema-examples.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T035108Z&X-Amz-Expires=604800&X-Amz-Signature=64e602a6c1942ba15e46016526f659bba81c1c397b1ce2cbe864375c5bb31c35&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 输入 Schema 示例： ```json { "type": "object", "required": ["preset", "limit", "deep_fetch"], "properties": { "preset": { "type": "string", "description": "News report preset to run.", "enum": ["ai"], "default": "ai", "examples": ["ai"] }, "limit": { "type": "integer", "description": "Maximum number of news items to include in the report.", "minimum": 1, "maximum": 10, "default": 3, "examples": [3] }, "deep_fetch": { "type": "boolean", "description": "When true, enables deeper retrieval before generating the report.", "default": false } } } ``` 请求示例： ```json { "preset": "ai", "limit": 3, "deep_fetch": false } ``` 响应示例： ```json { "status": "ok", "tool": "ai_news_report", "format": "markdown", "content": "# AI News Report\n\n..." } ``` Alephant 中的 Schema 应与运行时契约完全匹配。如果服务添加了新的预设或输出字段，请在广泛发布端点前更新 Schema 和示例。 ### 使用签名密钥验证网关来源 如果可从公网访问 OpenClaw 服务 URL，请验证 Alephant 网关签名，防止客户端绕过 x402 直接调用上游服务。 这不是买方 API 密钥认证。买方认证、付款和结算由 x402 处理。签名密钥仅用于确认请求来自 Alephant 付费网关。 ```text X-Alephant-Timestamp X-Alephant-Signature ``` 服务器应使用 Alephant 签名密钥验证这些请求头，验证失败时拒绝请求。请将签名密钥存储在密钥管理器或受保护的环境变量中，不要提交到仓库或在市场示例中暴露它。 ## 5. 发布到市场 端点发布后，可与其他 x402 条目一同出现在 Alephant 市场中。 ![News Report Service listing in the Alephant marketplace](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/0e3ea9a086f8a9ff03d371b1cb28777659bee32b790c0fd4dcd230fdfbe2d426/docs/assets/openclaw/alephant-marketplace-finance-news-report.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T035108Z&X-Amz-Expires=604800&X-Amz-Signature=8496ae83b576ef61ff20a3d4f3d2f400ac0ea90209f5ee96adc97827ddd84578&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 一个好的条目应说明服务完成的具体工作： * 买方提供什么输入。 * 买方获得什么输出。 * 使用了哪些数据源。 * 结果是确定性的、AI 生成的，还是尽力而为的。 * 报告通常需要多长时间。 * 如何返回错误和超时。 对于新闻报告示例，条目应明确说明：此端点抓取实时 AI/科技新闻，并返回其他智能体或应用可使用的英文 Markdown 报告。 ## 6. 测试付费调用 先从受信任服务器或私有网络直接测试 OpenClaw 服务： ```bash curl -X POST "https://openclaw.example.com/v1/news/report" \ -H "Content-Type: application/json" \ -d '{"preset":"ai","limit":3,"deep_fetch":false}' ``` 然后在不带付款载荷的情况下测试 Alephant x402 端点。预期响应为 HTTP `402 Payment Required`。 ```bash curl -X POST "https://pay.alephant.io/x402/news-report-service" \ -H "Content-Type: application/json" \ -d '{"preset":"ai","limit":3,"deep_fetch":false}' ``` ![Unsigned x402 request returns payment-required](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/1f2f920dcaead04de3c96bdf5fdaf850119889e89c3f82dcf565da193810fee3/docs/assets/openclaw/alephant-x402-payment-required.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T035108Z&X-Amz-Expires=604800&X-Amz-Signature=13caa1a145371f95e35cdd5c3657f34999561dc1a37750907bf749cf014dd6ef&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 按 x402 协议对付款要求进行签名，然后携带已签名付款载荷再次发送请求： ```bash curl -X POST "https://pay.alephant.io/x402/news-report-service" \ -H "Content-Type: application/json" \ -H "PAYMENT-SIGNATURE: " \ -d '{"preset":"ai","limit":3,"deep_fetch":false}' ``` 调用成功后，在 Alephant 中检查： * 付款验证和结算状态。 * 智能体执行状态。 * OpenClaw 服务响应延迟。 * 端点错误率。 * 如有追踪，AI token 成本和外部工具成本。 * 收入、费用和已知利润率。 * 与端点和智能体运行关联的请求日志。 ## 生产清单 广泛推广端点前： * OpenClaw 服务已部署到生产环境并返回稳定 JSON。 * Alephant 端点 Schema 与线上 OpenClaw 请求和响应契约匹配。 * 上游 OpenClaw URL 受到私有网络、网关来源验证或等效控制的保护。 * 公开示例不暴露真实主机名、IP 地址、密钥、回溯信息、stderr 或本地文件路径。 * 当可从公网访问上游服务时，已验证 `X-Alephant-Timestamp` 和 `X-Alephant-Signature`。 * 已配置端点策略、速率限制、超时预期和买方访问控制。 * 按调用追踪收入、模型成本、外部 API/工具支出和利润率。 * 请求或响应契约变化时，端点已进行版本控制。 ## 相关文档 * [x402 Overview](https://docs.cdp.coinbase.com/x402/welcome) * [How x402 Works](https://docs.cdp.coinbase.com/x402/core-concepts/how-it-works) * [Bazaar Quality Ranking](https://docs.cdp.coinbase.com/x402/bazaar#quality-ranking) * [Alephant Marketplace](https://alephant.io/marketplace) * [Paid Endpoints](/docs/overview/monetize/paid-endpoints)