n8n 工作流自动化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-n8n-automation。
技能介绍
要解决什么问题
n8n 把各类应用和定时任务串成可编排的工作流,但日常运维往往要切进 Web 控制台:查某条执行为什么失败、临时关掉有问题的流程、或从别的环境导出 JSON 再导回来。若你已经在用 AI 助手处理告警和变更记录,却还要手动点界面,上下文很容易断。
本技能让助手通过 REST API(请求头 X-N8N-API-KEY)直接与 n8n 交互,把「列工作流、改激活状态、用 webhook 触发、查执行详情、从 JSON 创建工作流」等操作收敛成可复述的步骤,而不是让你记一整页端点表。
核心能力与典型用法
- 工作流生命周期:列出工作流(可用
?active=true/?active=false过滤)、读取详情、激活/停用、按 JSON 创建或删除。 - 执行侧排查:列出执行记录,拉取单次执行详情,定位失败节点;按 SKILL 里的 Debug 模式,从失败列表 → 执行 ID → 节点参数与输入数据 → 结合错误信息给出修复建议。
- 运维巡检:周期性 Health Check——扫描活跃工作流、看近期执行是否有错误并汇总状态。
- 快速读懂流程结构:解析工作流 JSON,归纳触发类型、节点数量、已连接应用与调度方式。
更完整的端点说明见资料中的 references/api-endpoints.md;密钥可通过 n8n「Settings → n8n API」创建,也可写入环境变量或 .n8n-api-config。
边界与注意点
- 非企业版下,API Key 通常具备实例级完整权限,交给助手前要想清楚暴露范围。
- 云端有速率限制,自托管一般不限;Webhook 触发 URL 与 API 基址不同,触发时不需要带 API 认证头。
- 执行历史可能受 n8n 保留策略裁剪,过久的数据未必还能查到。
使用场景
- 生产环境定时任务报错,需要在不打开控制台的情况下列出失败执行并定位故障节点
- 变更窗口前要批量停用指定工作流,用 active 过滤列出清单后再逐个 deactivate
- CI 或运维脚本导出的工作流 JSON,需要在目标 n8n 实例上通过 API 创建并核对触发与节点摘要
- 值班巡检要周期性汇总活跃流程及近期执行错误,把状态写进告警或工单备注
适合人员
- 负责 n8n 自托管或云端实例的 SRE,希望把失败执行排查和激活/停用写进 AI 驱动的值班流程
- 用 n8n 对接内部 webhook 与 SaaS 的集成工程师,需要助手代查执行详情并解释节点参数问题
- 在多环境间迁移工作流 JSON 的平台工程师,要创建/删除流程并快速读出触发类型与已连接应用
- 编写 n8n 自动化 runbook 的技术写作者,需要与官方 API 行为一致的健康检查与调试步骤描述