如果您还没有设置智能体,请先查看我们的快速开始指南
启用 Webhook
安全
共享密钥验证
配置 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
401 未授权
401 未授权
- 包含
X-Webhook-Secret请求头 - 验证密钥与配置匹配
429 请求过多
429 请求过多
- 速率限制:每分钟 60 个请求
- 实现指数退避
消息未处理
消息未处理
- 检查日志:
RUST_LOG=ironclaw=debug ironclaw run - 验证 JSON 格式
- 检查
user_id有效