2026 OpenClaw 租用 Mac Mini 实战
对接 Zendesk Webhook:夜间工单摘要、静默窗口与退避重试的可复现步骤
🎫🖥️ 七乘二十四在租用 Mac Mini上跑 OpenClaw,夜间把 Zendesk 工单扇出成摘要,需要入站 Webhook与出站 Support API一条线打通:鉴权、静默窗、退避重试。延伸阅读Datadog 夜批、Opsgenie Webhook;安装总览见OpenClaw 安装指南。公开购买页支持免登录(视套餐)。
痛点拆解
- 鉴权混用:把客服管理员密码写进脚本,泄露即全实例风险;应使用专用机器人账号的 API Token。
- Webhook 假成功:边缘返回 200 但正文未进 OpenClaw,排障无从下手。
- 429 硬冲:夜批高频调 Tickets API,触发限流仍直线重试,拖垮窗口内其他作业。
入站与出站形态矩阵
| 维度 | Zendesk→OpenClaw Webhook | OpenClaw→Support API |
|---|---|---|
| 典型用途 | 工单事件触发编排 | 写内部备注、标签、夜批摘要 |
| 鉴权 | 网关 Bearer/HMAC | 邮箱 + Token Basic |
| 七乘二十四要点 | TLS 与证书续期 | 429 退避与幂等键 |
安装与监听(简述)
在租机按文档安装 OpenClaw,用 launchd 保证崩溃自拉起;进程只监听 127.0.0.1 端口,公网由反向代理接入。完整命令与多平台差异见上文内链《安装指南》。
网关与 Zendesk Webhook
在 Zendesk「管理中心 → Webhook」新建目标,URL 填 https://你的域名/openclaw/zendesk;POST、Content-Type: application/json。网关校验 Authorization: Bearer … 或与 OpenClaw 一致的自定义头,再转发到本机。触发器测试应稳定 2xx,并在租机日志出现验签与 body 长度一行。
Support API 鉴权(出站)
为机器人管理员生成 API Token,与邮箱组成 HTTP Basic(email/token:api_token Base64)。密钥文件 chmod 600,经 launchd EnvironmentVariables 注入;子域名 https://{subdomain}.zendesk.com 与 Token 同属一实例,勿混用沙箱与生产。
静默窗口与夜批摘要
在 Zendesk 配置维护窗或业务低峰 UTC 时段;OpenClaw 同步读取本地 MAINT 标志(JSON),窗内跳过出站摘要或将级别降为 info。夜批作业带统一 batch_window_id,摘要正文首行写 digest 版本,便于与触发器去重。
退避重试
429 优先解析 Retry-After 秒;缺失时默认等待 60s。5xx 与网络断连:基数 2s 起指数退避,封顶约 60s,加 0–20% 抖动;同一 ticket 连续失败 5 次后落盘待人工,避免无限循环。
网关基础排错
- 证书链不全:浏览器能开、Zendesk 测通失败——补中间证书或换 ACME 全链。
- 502/504:反代 upstream 指错端口或 OpenClaw 未起;
curl -v http://127.0.0.1:端口/health先隔离。 - 401:Webhook 头与网关不一致,或复制了多余空格/换行。
- 时钟漂移:租机未同步 NTP,与 UTC 维护窗错开数分钟,静默失效。
日志与告警
每条 Webhook 记 request_id、状态码、body 字节数、验签结果;Support API 记 ticket_id、HTTP 状态、重试序号。告警条件建议:连续 N 次网关 5xx、鉴权 401 激增、退避用尽仍失败——再通知值班,避免单次抖动误报。
建议阈值一览
| 项 | 建议值 | 说明 |
|---|---|---|
| 摘要去重窗 | 5 min | 同 digest 跳过 |
| 429 默认等待 | 60s | 无 Retry-After 时 |
| 5xx 退避封顶 | 约 60s | 至多 5 次 |
落地步骤清单(建议按序勾选)
- 安装 OpenClaw + launchd;前置 TLS 网关,防火墙仅放行 443 至反代。
- Zendesk 创建 Webhook 与触发器,跑通测试;网关记录验签日志。
- 生成 Support API Token,固定 JSON 契约与
batch_window_id。 - 对齐维护窗与 MAINT 标志;夜批摘要写入内部备注前做 digest 去重。
- 接入 429/5xx 退避与上限;演练证书轮换与 Token 轮换。
- 配置日志与告警阈值;与 SSH 连机指南交叉验证。