OpenClaw人人养虾：openclaw webhooks
管理 Webhook
概要
想管理你的 OpenClaw Webhook？命令很简单：openclaw webhooks <子命令> [选项]。下面我们来详细拆解它的用法。
描述
openclaw webhooks 这个命令，是你的 Webhook 管理中心。Webhook 是什么？简单说，它就是一条让外部系统通过 HTTP 请求来触发 Agent 操作，或者接收事件通知的通道。创建、测试、查看、删除，这些管理操作都离不开它。
子命令
| 子命令 | 说明 |
|---|---|
list |
列出所有 Webhook |
create |
创建新的 Webhook |
delete |
删除 Webhook |
test |
测试 Webhook 投递 |
logs |
查看 Webhook 投递日志 |
inspect |
查看 Webhook 配置详情 |
选项
| 选项 | 缩写 | 说明 | 默认值 |
|---|---|---|---|
--url |
- | Webhook 目标 URL | - |
--events |
-e |
订阅的事件类型（逗号分隔） | 全部 |
--secret |
- | Webhook 签名密钥 | 自动生成 |
--format |
- | 输出格式：text、json、table |
table |
--active |
- | 仅显示活跃的 Webhook | false |
事件类型
| 事件 | 说明 |
|---|---|
message.received |
收到新消息 |
message.sent |
发送消息 |
session.created |
新会话创建 |
session.ended |
会话结束 |
skill.triggered |
技能触发 |
error.occurred |
发生错误 |
pairing.requested |
收到配对请求 |
载荷格式
所有 Webhook 投递的数据，都遵循统一的 JSON 格式，清晰明了：
{
“event”: “message.received”,
“timestamp”: “2026-03-05T10:30:00Z”,
“data”: {
“session_key”: “whatsapp:+8613800001234”,
“message”: “你好”,
“channel”: “whatsapp”
},
“signature”: “sha256=xxxxxxxx”
}输出示例
光说不练假把式，来看一个实际的输出例子。比如执行 openclaw webhooks list，你可能会看到类似下面的表格，状态一目了然：
$ openclaw webhooks list
┌──────────────┬──────────────────────────────┬──────────┬──────────┐
│ 名称 │ URL │ 事件 │ 状态 │
├──────────────┼──────────────────────────────┼──────────┼──────────┤
│ notify-slack │ https://hooks.slack.com/xxx │ 全部 │ ✅ 活跃 │
│ log-server │ https://log.example.com/hook │ error.* │ ✅ 活跃 │
│ old-hook │ https://old.example.com │ 全部 │ ⚪ 禁用 │
└──────────────┴──────────────────────────────┴──────────┴──────────┘示例
掌握了基本概念，是时候上手操作了。下面这些命令示例，覆盖了从创建到管理的常见场景，跟着做一遍就熟悉了：
# 列出所有 Webhook
openclaw webhooks list
# 创建新 Webhook
openclaw webhooks create notify-slack \
--url “https://hooks.slack.com/services/xxx” \
--events “message.received,error.occurred”
# 测试 Webhook 投递
openclaw webhooks test notify-slack
# 查看 Webhook 投递日志
openclaw webhooks logs notify-slack
# 查看 Webhook 详情
openclaw webhooks inspect notify-slack
# 删除 Webhook
openclaw webhooks delete old-hook
# 仅列出活跃的 Webhook
openclaw webhooks list --active相关命令
Webhook 管理通常不是孤立的，它常常和安全、密钥等配置协同工作。如果你需要进一步操作，可以了解一下这些相关命令：
openclaw security- 安全管理openclaw secrets- 密钥管理openclaw logs- 系统日志
《DeepSeek高效数据分析：从数据清洗到行业案例》聚焦DeepSeek在数据分析领域的高效应用，是系统讲解其从数据处理到可视化全流程的实用指南。作者结合多年职场实战经验，不仅深入拆解DeepSeek数据分析的核心功能——涵盖数据采集、清洗、预处理、探索分析、建模（回归、聚类、时间序列等）及模型评估，更通过金融量化数据分析、电商平台数据分析等真实行业案例，搭配报告撰写技巧，提供独到见解与落地建议。助力职场人在激烈竞争中凭借先进技能突破瓶颈，实现职业进阶，开启发展新篇。
