n8n工作流中枢

技能简介

n8n-hub 是一个集中式 n8n 工作流管理平台，覆盖设计与运维两条主线：设计侧帮助规划具备幂等性、自动重试、日志记录和人工审核队列的可靠流程；运维侧通过 n8n 公开 REST API 实现工作流与执行的列表查询、发布、停用及调试等生命周期操作。

能做什么

• 生成可导入的 workflow.json 文件及配套运行手册
• 通过 API 列出、激活或停用工作流
• 查询执行记录并支持失败重试
• 触发 Webhook 并传递自定义数据
• 输出包含节点配置、数据契约和故障模式的设计规格文档

使用说明

安装与配置

1. 确保 n8n 实例已升级至付费计划（免费试用版禁用 Public API）
2. 在 n8n 设置中创建 API 密钥：Settings → n8n API → Create an API key
3. 配置环境变量（或写入 .n8n-api-config 文件）：

   export N8N_API_BASE_URL="https://your-instance.app.n8n.cloud/api/v1"
   export N8N_API_KEY="your-api-key-here"

快速调用示例

列出所有工作流：

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_BASE_URL/workflows" | jq '.data[] | {id, name, active}'

激活指定工作流：

curl -s -X POST -H "X-N8N-API-KEY: $N8N_API_KEY" -H "Content-Type: application/json" -d '{"versionId":"","name":"","description":""}' "$N8N_API_BASE_URL/workflows/{id}/activate"

停用指定工作流：

curl -s -X POST -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_BASE_URL/workflows/{id}/deactivate"

查询最近10条执行记录：

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_BASE_URL/executions?limit=10" | jq '.data[] | {id, workflowId, status, startedAt}'

重试失败执行：

curl -s -X POST -H "X-N8N-API-KEY: $N8N_API_KEY" -H "Content-Type: application/json" -d '{"loadWorkflow":true}' "$N8N_API_BASE_URL/executions/{id}/retry"

触发 Webhook（无需 API Key）：

curl -s -X POST "$N8N_API_BASE_URL/../webhook/{webhook-path}" -H "Content-Type: application/json" -d '{"key":"value"}'

输入与输出

见下方输入与输出表格。

项目	内容
输入	触发类型与调度时区；成功判定标准与目标地址（邮件/云盘/数据库）；现有工作流 JSON（可选）；样本数据载荷（可选）；去重键（可选）
输出	设计规格（节点、数据契约、故障模式）；workflow.json（按需）；workflow-lab.md 运行手册（按需）
适用人群	需要构建可靠工作流并 API 运维的 n8n 用户；需要可导入配置及运行手册的技术团队
不包含	纯代码自动化方案；绕过安全控制或隐藏审计轨迹的能力

 

风险提示

• Public API 在免费试用计划中不可用，需升级付费方案
• API 密钥需妥善保管，避免泄露导致未授权访问
• Webhook 路径暴露后可能被外部调用，建议配合验证机制
• 执行数据受保留策略限制，过期后无法检索
• API playground 仅在自托管环境可用且操作真实数据，测试需谨慎

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/codedao12/n8n-hub/SKILL.md
来源类型：GitHub 仓库