OpenClaw 接入业务系统:Webhook + 三种调用 + 工单/合同场景
OpenClaw 接入业务系统:Webhook + 三种调用 + 工单/合同场景
来源类型: 实战教程
日期: 2026-06-17
标签: #OpenClaw #Webhook #业务集成 #工单 #合同 #i龙虾
核心场景
"如果你只是想让龙虾响应外部事件,看前半部分就够了。如果想把 OpenClaw 对接自己的业务系统——比如工单触发 AI 分析、合同上传自动审查——后半部分专门讲这个,包括结果怎么回传。"
Webhook 配置
"OpenClaw 的 Webhook 挂在网关上,默认端口 18789,路径默认 /hooks。"
{
"hooks": {
"enabled": true,
"token": "your-shared-secret",
"path": "/hooks"
}
}
认证方式
Authorization: Bearer ***
x-openclaw-token: <token>
三种调用方式
1. /hooks/wake 简单调用
{ "text": "收到新邮件", "mode": "now" }
| 字段 | 说明 |
|---|---|
text |
事件描述,作为系统行写进主会话队列 |
mode |
now 立即触发心跳 / next-heartbeat 等下次定期检查 |
适合场景:
- 外部脚本监控目录
- 出现新文件就通知龙虾处理
- 逻辑简单、不需要隔离环境
2. /hooks/agent 跑隔离 Agent(重头戏)
{
"message": "帮我总结这封邮件",
"name": "Email",
...
}
3. (推断)/hooks/advanced
关键洞察
1. 工单触发 AI 分析
- 业务系统收到工单
- 通过 Webhook 推给 OpenClaw
- OpenClaw AI 分析
- 结果回传业务系统
2. 合同上传自动审查
- 合同上传业务系统
- 通过 Webhook 通知 OpenClaw
- AI 自动审查合同
- 结果回传
3. 隔离运行环境
/hooks/agent= 隔离- 避免影响主会话
- 适合复杂任务
与已有知识的关联
- wiki/entities/openclaw — OpenClaw
- wiki/concepts/openclaw-webhook — OpenClaw Webhook
- wiki/concepts/business-integration — 业务集成
- wiki/entities/ilobster — i 龙虾
- wiki/concepts/ticket-ai-analysis — 工单 AI 分析
- wiki/concepts/contract-ai-review — 合同 AI 审查
资料来源
- 原文:https://mp.weixin.qq.com/s/TmtN43DEOAcBsNS_FeDpnA
- 原始文件:
raw/articles/openclaw/如何把OpenClaw接入你的业务系统.md - 来源:i 龙虾
我的判断(高置信度)
这是 2026 年 OpenClaw 业务集成最实战的教程——Webhook + 三种调用 + 工单/合同场景。
关键洞察:
1. "Webhook 18789 端口" —— 是标准配置
2. "token 必填" —— 是安全机制
3. "/hooks/wake vs /hooks/agent" —— 简单 vs 隔离
4. "工单 + 合同" —— 典型企业场景
5. "结果回传" —— 闭环设计
预测:
- 2026 H2:OpenClaw 业务集成可能成为标准能力
- 2027:可能涌现"OpenClaw 企业版"
- 2028:可能形成 OpenClaw 业务生态
- 对企业 IT 的建议:
关注 OpenClaw Webhook——业务集成关键
- 隔离 Agent 是企业级特性
- 结果回传 是闭环核心
- 对开发者的启示:
Webhook 18789 是集成起点
- token 认证 是安全必备
- 三种调用方式 覆盖不同场景