核心用法
n8n-api skill 提供对 n8n 公开 REST API 的完整封装，允许用户从 OpenClaw 环境直接驱动 n8n 实例。核心能力覆盖六大领域：
- 工作流管理：列出、创建、更新、激活/停用工作流
- 执行监控：查询执行记录、筛选状态（成功/失败）、重试失败任务
- Webhook 触发：直接调用生产环境或测试环境的 webhook 端点
- 元数据操作：标签、凭证、项目管理
- 健康巡检：自动化统计活跃工作流数量与 24 小时失败率
- 故障诊断：获取失败执行的节点级详情，辅助定位问题
配置需设置 N8N_API_BASE_URL 与 N8N_API_KEY，支持自托管实例与 n8n Cloud。注意：API 访问需付费计划，免费试用期间不可用。
显著优点
1. 双向兼容：同时支持自托管与云端，迁移成本低
2. 原子化操作：每个 API 调用均可独立执行，便于脚本化与 CI/CD 集成
3. 实时反馈：执行状态查询与重试机制支持主动运维
4. 无代码联动：n8n 内部可通过「n8n API 节点」调用自身 API，实现元编程
潜在局限
- 权限粒度粗：API Key 为全局权限，无法细分到工作流级别
- 无事件驱动：需轮询获取状态变化，无法订阅实时事件
- 速率限制未明：官方文档未公开具体限流策略，高频调用存在不确定性
- 数据保留依赖配置：执行记录可能因实例保留策略被清理
适合人群
- DevOps/SRE 工程师：批量管理大量工作流，自动化运维
- 平台管理员：多实例监控与合规审计
- 高级用户：构建外部控制面板或与现有系统集成
常规风险
- 密钥泄露：API Key 具备实例级权限，需妥善保管
- 误操作传播：批量激活/停用可能影响生产业务
- Webhook 混淆：API URL 与 Webhook URL 路径规则不同，配置错误会导致调用失败
- 依赖实例可用性：API 调用受目标 n8n 实例状态影响，需设计重试与降级策略