（10773期）n8n API – 远程管控 n8n 自动化中枢

远程管控 n8n 自动化中枢 通过官方 REST API 远程管理 n8n 工作流，支持自动化部署、执行监控与故障排查，适合运维与开发者集成。 使用说明 核心用法 n8n-api 技能提供对 n8n 公开 REST API 的完整封装，允许用户通过 API 密钥认证方式，远程执行原本需要在 UI 中完成的操作。核心能力覆盖六大模块： 工作流管理：列出、创建、更新、激活/停用工作流，获取详细配置 执行监控：查询执行历史、筛选成功/失败状态、获取执行详情与日志 触发执行：通过 Webhook 触发生产环境或测试环境的工作流 故障排查：重试失败执行、分析失败节点参数与错误信息 健康检查：统计活跃工作流数量、24小时内失败率，生成运维摘要 元数据管理：标签、凭证、项目等辅助资源的查询操作 使用方式 配置 N8NAPIBASEURL 和 N8NAPI_KEY 环境变量后，通过标准 HTTP 请求（curl 示例已提供）调用端点。支持自托管实例与 n8n Cloud 两种部署模式。 显著优点 权威原生：直接调用 n8n 官方公开 API，非第三方封装，功能与 UI 保持同步 运维自动化：可将工作流部署、监控、告警纳入 CI/CD 或定时任务体系 故障恢复：支持执行重试与批量失败分析，降低人工介入成本 双模式兼容：同时适配本地自托管与云端托管场景 潜在局限 付费门槛：API 访问在免费试用期间不可用，需升级付费计划 无沙箱环境：Playground 仅自托管可用，且操作真实数据，测试需谨慎 执行记录保留：历史执行数据受实例保留策略限制，可能被自动清理 Webhook 独立认证：Webhook 端点不使用 API Key，需单独管理 URL 安全 适合人群 平台运维工程师：需要批量管理多工作流、监控执行健康的 DevOps 团队 自动化开发者：将 n8n 集成到更大自动化架构中的后端工程师 工作流管理员：负责故障排查、版本发布与权限治理的技术负责人 常规风险 | 风险类型 | 说明 | 缓解建议 ||---------|------|---------|| 密钥泄露 | API Key 拥有工作流完全控制权 | 使用环境变量或密钥管理服务，避免硬编码 || 误操作生产 | API 直接操作真实工作流状态 | 配置前验证 N8NAPIBASE_URL，区分生产/测试实例 || 数据暴露 | 执行详情可能包含敏感业务数据 | 限制 API Key 权限范围，启用最小权限原则 || 执行重试风险 | 重试失败执行可能产生副作用（如重复通知） | 重试前确认工作流幂等性设计 | 原始说明 Operate n8n via its public REST API from OpenClaw. Use for workflow management, executions, and automation tasks such as listing, creating, publishing, triggering, or troubleshooting. Works with both self-hosted n8n and n8n Cloud.