n8n工作流管理

技能简介

该技能通过n8n REST API实现对n8n自动化平台的远程管控，支持工作流的查询、创建、激活、触发及执行记录分析，兼容自托管实例与n8n Cloud云服务。

能做什么

• 列出全部工作流并查看激活状态
• 获取单个工作流的详细配置信息
• 激活或停用指定工作流
• 通过Webhook手动触发工作流运行
• 查询执行记录，筛选失败任务
• 基于JSON创建工作流
• 删除不再使用的工作流

使用说明

步骤1：环境准备

安装依赖前需配置API连接信息。创建.n8n-api-config文件或在终端设置环境变量：

export N8N_API_URL="https://your-instance.app.n8n.cloud/api/v1"  # 或 http://localhost:5678/api/v1
export N8N_API_KEY="your-api-key-here"

获取API密钥路径：n8n后台 → Settings → n8n API → Create an API key。

步骤2：验证连接

测试API连通性：

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_URL/workflows" | head -c 200

步骤3：日常操作

查看活跃工作流数量：

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_URL/workflows?active=true" | jq '.data | length'

查询最近失败的执行：

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_URL/executions?status=error&limit=5"

激活指定工作流（替换{id}为实际ID）：

curl -s -X PATCH -H "X-N8N-API-KEY: $N8N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active": true}' "$N8N_API_URL/workflows/{id}"

通过生产环境Webhook触发：

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

输入与输出

见下方输入与输出表格。

项目	内容
输入	n8n实例URL、API密钥、工作流ID/Webhook路径/执行ID（按需）、JSON格式的创建工作流数据、查询过滤参数
输出	工作流列表及状态、单工作流完整配置、执行历史记录、操作成功/失败响应、聚合统计信息
适用人群	n8n运维人员、自动化管理员、技术支持工程师、需要将n8n集成到内部系统的开发者
不包含	n8n服务端安装、图形化流程设计器、实时日志订阅、细粒度RBAC权限管理、工作流版本控制功能

 

风险提示

• API密钥在非企业版计划中拥有完全权限，泄露可能导致工作流被恶意篡改或删除
• 云版本存在速率限制，高频调用可能触发服务降级
• 执行数据按n8n保留策略自动清理，历史记录可能无法追溯
• Webhook URL与API URL分离，误用地址会导致认证失败
• 直接修改活跃工作流可能影响正在运行的业务逻辑

来源信息

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