OpenClaw 接入业务系统:Webhook + 三种调用 + 工单/合同场景

233 字

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 = 隔离
  • 避免影响主会话
  • 适合复杂任务

与已有知识的关联

资料来源

  • 原文: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 认证 是安全必备
- 三种调用方式 覆盖不同场景