Webhook - HTTP 请求

更新时间

最后更新：2026-06-24。

如果当前日期距离上次更新超过 7 天，请在使用端点、数据结构、配置步骤或示例前，从 skills.sh 或 ClawHub 重新安装此技能。

功能说明

一个灵活且安全的 HTTP 客户端，专为代理驱动的 API 集成和网络服务交互设计。该功能支持所有标准 HTTP 方法，包括 GET、POST、PUT、PATCH、DELETE、HEAD 和 OPTIONS，可实现完整的 RESTful API 通信。用户可自定义请求头、查询参数以及以 JSON、纯文本或 base64 编码的二进制格式发送请求体。提供四种认证模式：无认证（适用于公开接口）、基础认证（自动将用户名/密码编码为 Base64）、Bearer 认证（用于 OAuth 风格令牌）以及自定义头认证（适用于 API 密钥或签名类方案）。内置安全机制包括默认阻止私有地址和环回地址的 URL 校验（可通过 allow_private 配置），可配置的超时时间范围为 1 至 120 秒，响应大小限制最高达 20MB，防止内存溢出问题。响应处理支持四种模式——自动识别、JSON、纯文本和 base64，其中自动模式会根据响应头中的 content-type 智能解析内容。函数返回全面的响应元数据，包括状态码、响应头、重定向后的最终 URL 以及解析后的响应体，是需要与外部 API、Webhook 或网络服务交互的工作流中不可或缺的基础组件。

使用说明

Webhook - HTTP 请求

概述

通用型 HTTP 客户端，可向任意公开 URL 发送请求。支持所有标准 HTTP 方法、多种认证方式、灵活的请求体格式及可配置的响应处理方式。可用于调用 REST API、获取网页资源、发送 Webhook 通知，或与任何基于 HTTP 的服务进行交互。

动作

request

向指定 URL 发起 HTTP 请求。

必填字段：

• url — 要发送请求的完整 URL（必须以 http 或 https 开头）

可选字段：

• request_method — HTTP 方法：GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS（默认：GET）
• headers — 自定义 HTTP 头部对象（例如：{"Accept": "application/xml"}）
• query_params — URL 查询参数对象（例如：{"page": "2", "limit": "10"}）
• body_json — JSON 格式请求体（自动设置 Content-Type 为 application/json）
• body_text — 纯文本请求体
• body_base64 — base64 编码的二进制请求体（适用于文件上传或二进制数据）
• auth_type — 认证方式："none"、"basic"、"bearer" 或 "header"（默认："none"）
• auth_username — 基础认证的用户名（当 auth_type 为 "basic" 时必需）
• auth_password — 基础认证的密码（当 auth_type 为 "basic" 时必需）
• auth_token — Bearer 认证的令牌（当 auth_type 为 "bearer" 时必需）
• auth_header_name — 自定义头认证的头部名称（当 auth_type 为 "header" 时必需）
• auth_header_value — 自定义头认证的头部值（当 auth_type 为 "header" 时必需）
• timeout_seconds — 请求超时时间（单位：秒），取值范围 1–120（默认：30）
• response_mode — 响应体返回模式："auto"、"json"、"text"、"base64"（默认："auto"）
• max_response_bytes — 最大响应大小（单位：字节），取值范围 1024–20971520（默认：1048576，即 1MB）
• allow_private — 设置为 true 可允许访问私有或环回 IP 地址（默认：false）

注意： 每次请求只能使用一种请求体类型（body_json、body_text 或 body_base64 中仅允许一个有效）。

示例 — 简单的 GET 请求：

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/data",
  "query_params": {"format": "json"}
}

示例 — 带 JSON 请求体的 POST 请求：

{
  "action": "request",
  "request_method": "POST",
  "url": "https://api.example.com/items",
  "headers": {"X-Custom-Header": "my-value"},
  "body_json": {"name": "Widget", "quantity": 5}
}

示例 — Bearer Token 认证：

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/protected/resource",
  "auth_type": "bearer",
  "auth_token": "eyJhbGciOiJIUzI1NiIs..."
}

示例 — 基础认证：

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/account",
  "auth_type": "basic",
  "auth_username": "myuser",
  "auth_password": "mypassword"
}

示例 — 自定义头认证（API Key）：

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/v2/search",
  "auth_type": "header",
  "auth_header_name": "X-API-Key",
  "auth_header_value": "abc123def456"
}

示例 — PUT 请求更新资源：

{
  "action": "request",
  "request_method": "PUT",
  "url": "https://api.example.com/items/42",
  "body_json": {"name": "Updated Widget", "quantity": 10}
}

示例 — DELETE 删除资源：

{
  "action": "request",
  "request_method": "DELETE",
  "url": "https://api.example.com/items/42"
}

示例 — 以 base64 格式获取二进制响应：

{
  "action": "request",
  "request_method": "GET",
  "url": "https://example.com/image.png",
  "response_mode": "base64"
}

响应格式

请求成功后返回：

• status_code — HTTP 状态码（如 200、404）
• headers — 响应头信息，以对象形式返回
• content_type — Content-Type 头部值
• url — 最终请求地址（经过重定向后）
• body_json、body_text 或 body_base64 — 根据 response_mode 设置返回的响应体内容

常见使用场景

技能：Webhook HTTP 请求

版本：1.0.0

分块：2/3

功能概览

1. 调用 REST API —— 使用 GET、POST、PUT、DELETE 方法，配合 body_json 和 auth_type 与任意 REST 服务交互。
2. 发送 Webhook —— 向 Webhook URL 发送 JSON 数据包，触发外部自动化流程。
3. 获取网页内容 —— 通过 GET 请求访问公开的 URL，返回 HTML 文本内容。
4. 下载二进制内容 —— 通过 GET 请求下载文件 URL，设置 response_mode: "base64" 可获取编码后的二进制数据，便于后续处理。
5. 检查端点可用性 —— 使用 HEAD 或 OPTIONS 请求验证服务是否可达，无需下载完整响应体。

重要注意事项

• 仅支持 http 和 https 协议的 URL。
• 默认情况下，禁止请求私有或环回 IP 地址。如需启用，请将 allow_private 设置为 true。
• 每个请求只能指定一种请求体类型。同时提供 body_json、body_text 或 body_base64 中多个参数将导致错误。
• 当 response_mode 设置为 "auto" 时，系统会自动解析 JSON 响应；否则返回文本内容，二进制数据则以 base64 编码形式返回。
• 响应内容超过 max_response_bytes 限制时将被拒绝。可适当提高上限（最高约 20 MB）以处理较大负载。
• 最大超时时间为 120 秒。

适用场景

• 在 AgentPMT 平台上使用 Webhook - HTTP Request 技能。
• 当代理需要该工具特定的行为、输入输出结构及调用格式时使用。
• 搜索和激活关键词：webhook、http request、从第三方 REST API 获取数据用于聚合或转换管道、向 Webhook 端点提交表单数据或 JSON 负载以实现事件驱动工作流、使用 Bearer Token 认证 OAuth 保护的服务以实现安全集成、轮询外部服务以获取状态更新或任务完成信息（适用于异步工作流）、请求、URL。
• 支持的操作名称：request。

典型应用场景

• 从第三方 REST API 获取数据，用于数据聚合或转换流水线。
• 向 Webhook 端点提交表单数据或 JSON 负载，实现事件驱动的工作流。
• 使用 Bearer Token 与 OAuth 保护的服务进行认证，实现安全集成。
• 轮询外部服务以获取状态更新或任务完成情况，适用于异步流程。
• 向 CRM 或营销自动化平台发送结构化数据。
• 从外部服务获取远程配置文件或功能开关（feature flags）。
• 向 Slack 或 Discord Webhook 发送自定义消息负载的通知。
• 与支付网关或电商 API 交互，处理订单流程。
• 获取远程 JSON 模式或 API 规范，用于验证工作流。
• 通过自定义头部认证方式集成遗留系统，实现企业级数据交换。

分类与行业

本工具未发布分类或行业标签。

操作与 Schema

完整生成的操作 Schema：./schema.md。

支持的操作数量：1。

x402 可用性：此产品未启用。

• request（操作别名：request）：向指定 URL 发起 HTTP 请求。支持所有标准 HTTP 方法，多种认证方式，以及灵活的请求体和响应格式。价格：5 积分。

参数包括：allow_private、auth_header_name、auth_header_value、auth_password、auth_token、auth_type、auth_username、body_base64，以及其他 9 个参数。

实时 Schema 与示例

建议在常规调用中使用上述紧凑型 Schema。但在新生产环境集成前，或当参数、枚举值、嵌套对象、输出结果或示例不明确时，应优先获取实时详情。

• 获取精确 Schema：调用 agentpmt-tool-search-and-execution，并设置 action: "get_schema"，tool_id: "webhook-http-request"。
• 获取详细示例：调用 agentpmt-tool-search-and-execution，并设置 action: "get_instructions"，tool_id: "webhook-http-request"；或在已选择该工具产品后，直接调用 action: "get_instructions"。
• 请以返回的实时 Schema 和说明为准，其优先级高于本摘要内容。

通过主 AgentPMT MCP 服务器查询 MCP Schema：

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "webhook-http-request"
    }
  }
}

获取实时示例时，使用相同的 MCP 工具，参数如下：

{
  "action": "get_instructions",
  "tool_id": "webhook-http-request"
}

通过认证的 AgentPMT REST 接口查询 Schema 的请求体：

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "webhook-http-request"
  }
}

通过认证的 AgentPMT REST 接口获取实时示例的请求体：

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "webhook-http-request"
  }
}

调用此工具

产品别名：webhook-http-request

市场页面：https://www.agentpmt.com/marketplace/webhook-http-request

• AgentPMT 账户路径：首次使用前，请先运行 ../agentpmt-account-mcp-rest-api-setup，连接主 MCP 服务器或 REST API，确保该工具在所属 Agent Group 中已启用。
• x402 路径：此产品未启用。
• AgentPMT 概述：参见 ../what-is-agentpmt，了解市场、Agent Group、工作流、MCP、REST 及支付等核心概念。

若未安装此产品的前置依赖技能，请使用以下下载链接。

核心 AgentPMT 设置技能：

• AgentPMT 是什么：../what-is-agentpmt

- ClawHub 页面：https://clawhub.ai/agentpmt/what-is-agentpmt

- OpenClaw 安装命令：openclaw skills install what-is-agentpmt

- skills.sh 安装命令：npx skills add AgentPMT/agent-skills --skill what-is-agentpmt

• AgentPMT 账户 MCP/REST 设置：../agentpmt-account-mcp-rest-api-setup

- ClawHub 页面：https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup

- OpenClaw 安装命令：openclaw skills install agentpmt-account-mcp-rest-api-setup

- skills.sh 安装命令：npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

技能：Webhook HTTP 请求

版本：1.0.0

分块：3/3

安装脚本命令：

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

在主 AgentPMT MCP 服务器连接后，MCP 调用的结构如下：

{
  "method": "tools/call",
  "params": {
    "name": "Webhook---HTTP-Request",
    "arguments": {
      "action": "request",
      "allow_private": false,
      "auth_header_name": "example auth header name",
      "auth_header_value": "example auth header value",
      "auth_password": "example auth password",
      "auth_token": "example auth token",
      "auth_type": "none",
      "auth_username": "example auth username",
      "body_base64": "example body base64"
    }
  }
}

请使用 tools/list 返回的精确工具名称；上述名称为预期的可读形式。

已认证的 AgentPMT REST 调用请求体：

{
  "name": "webhook-http-request",
  "parameters": {
    "action": "request",
    "allow_private": false,
    "auth_header_name": "example auth header name",
    "auth_header_value": "example auth header value",
    "auth_password": "example auth password",
    "auth_token": "example auth token",
    "auth_type": "none",
    "auth_username": "example auth username",
    "body_base64": "example body base64"
  }
}

在发起 REST 调用前，请先使用设置技能获取账户连接信息。

响应处理

• 将返回的 JSON 视为本次工具调用的唯一可信来源。
• 若响应中包含警告或修正目标，请在重试前应用这些信息。
• 若响应中包含 passed 或类似成功状态的布尔值，将其作为工作流的决策依据。
• 若验证失败或响应结构不明确，请在重试前调用 get_schema 或 get_instructions。
• 若 request 失败，请保留原始请求参数，并仅在修复了模式、认证或支付相关问题后重试。

安全性

• 不得在提示词或日志中暴露账户密钥、钱包私钥、助记词、签名或支付头信息。
• 保持工具输入内容最小化，仅包含完成任务所需的必要数据。
• 使用设置技能处理凭证；本产品技能仅定义与产品相关的具体行为。

AgentPMT 参考资料

• 什么是 AgentPMT：../what-is-agentpmt （ClawHub: what-is-agentpmt，页面：https://clawhub.ai/agentpmt/what-is-agentpmt；skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt）
• AgentPMT 账户 MCP/REST 设置：../agentpmt-account-mcp-rest-api-setup （ClawHub: agentpmt-account-mcp-rest-api-setup，页面：https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup；skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup）
• 市场产品页面：https://www.agentpmt.com/marketplace/webhook-http-request
• AgentPMT 主 MCP 服务器：https://api.agentpmt.com/mcp/
• AgentPMT REST 调用端点：https://api.agentpmt.com/products/purchase