Skip to main content
HTTP Webhook 频道提供 REST API,用于将外部服务与 IronClaw 集成。
如果您还没有设置智能体,请先查看我们的快速开始指南

启用 Webhook

或在引导过程中:

安全

HTTP webhook 默认绑定到 0.0.0.0:8080。如果不需要外部 webhook 传递,请设置 HTTP_HOST=127.0.0.1

共享密钥验证

配置 webhook 密钥以验证请求:
密钥通过 X-Webhook-Secret 请求头发送。

速率限制

  • 请求体大小:最大 64 KB
  • 速率:每个 IP 每分钟 60 个请求

发送消息

请求格式

响应格式


请求字段

响应字段


检查状态

响应:

错误响应


集成示例

GitHub Webhook

配置 GitHub 将事件发送到您的 IronClaw webhook URL:

Zapier

使用 Zapier 的 Webhook 操作将事件发送到 IronClaw。

自定义脚本


故障排除

  • 检查 IronClaw 是否在运行
  • 验证 HTTP_PORT 正确
  • 检查防火墙:sudo ufw allow 8080
  • 包含 X-Webhook-Secret 请求头
  • 验证密钥与配置匹配
  • 速率限制:每分钟 60 个请求
  • 实现指数退避
  • 检查日志:RUST_LOG=ironclaw=debug ironclaw run
  • 验证 JSON 格式
  • 检查 user_id 有效