\u2699\ufe0f n8n — 管理工作流
v2.0.0通过 API 管理 n8n 工作流与自动化：列出、启停、查看执行状态、手动触发、调试问题，一站式完成。
53· 1.7万·177 当前·187 累计
by 下载技能包
最后更新
2026/2/26
安全扫描
OpenClaw
安全
high confidenceNULL
评估建议
该技能通过 n8n REST API 管理自托管 n8n 实例中的工作流和自动化任务。使用 API 密钥认证，功能与声称目的完全一致。
1. **自托管实例**：n8n 由用户自行部署，API 端点由 N8N_BASE_URL 指定，提供了完整控制
2. **API 密钥认证**：使用 n8n API 密钥而非 OAuth，凭证管理更简单但需妥善保管
3. **工作流控制能力**：可激活、停用、触发工作流，请确保访问权限最小化
4. **无第三方代理**：直接连接用户自托管的 n8n，无中间人风险
**使用注意**：
- N8N_API_KEY 是高权限凭证，仅授予可信任的 AI 代理
- 确保 n8n 实例网络访问策略符合安全要求
- 定期检查 n8n 访问日志，关注异常操作
- 工作流可能执行任意节点操作（如 HTTP 请求、代码执行），激活前请审查工作流内容
- 不要将 API 密钥暴露在日志或代码中...详细分析 ▾
✓ 用途与能力
N8N_API_KEY 和 N8N_BASE_URL，存储在环境变量中
ℹ 指令范围
向用户自托管的 n8n 实例发起 API 请求，所有工作流操作通过 n8n REST API
ℹ 安装机制
可列出、激活、停用、触发 n8n 工作流，管理自动化执行
✓ 凭证需求
使用 n8n API 密钥认证，无需 OAuth 流程
✓ 持久化与权限
可访问 n8n 中的工作流配置、凭证、执行记录等数据
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv2.0.02026/1/15
NULL
● 无害
安装命令
点击复制官方npx clawhub@latest install n8n
镜像加速npx clawhub@latest install n8n --registry https://cn.longxiaskill.com 镜像可用
本土化适配说明
n8n — 管理工作流 安装说明： 安装命令：npx clawhub@latest install n8n 支持国内镜像加速，使用 --registry https://cn.longxiaskill.com 参数可加速下载
技能文档
n8n 平台综合工作流自动化管理，具备创建、测试、执行监控和性能优化能力。
⚠️ 关键：工作流创建规则
创建 n8n 工作流时，务必：
- ✅ 生成完整的工作流，包含所有功能节点
- ✅ 包含实际的 HTTP Request 节点用于 API 调用（ImageFX、Gemini、Veo、Suno 等）
- ✅ 添加 Code 节点用于数据转换和逻辑处理
- ✅ 创建节点之间的正确连接
- ✅ 使用真实的节点类型（n8n-nodes-base.httpRequest、n8n-nodes-base.code、n8n-nodes-base.set）
禁止：
- ❌ 创建仅包含"设置说明"占位符的节点
- ❌ 生成只有 TODO 注释的工作流
- ❌ 生成需要手动添加节点的未完成工作流
- ❌ 使用纯文本节点替代实际功能
好的工作流示例：
Manual Trigger → Set Config → HTTP Request (API 调用) → Code (解析) → Response
差的工作流示例：
Manual Trigger → Code ("在这里添加 HTTP 节点，配置 API...")
始终构建包含所有必要节点（已配置并连接）的完整可用工作流。
设置
必需的环境变量：
N8N_API_KEY— 您的 n8n API 密钥（n8n 界面 → 设置 → API）N8N_BASE_URL— 您的 n8n 实例 URL
通过 OpenClaw 设置配置凭证：
添加到 ~/.config/openclaw/settings.json：
{
"skills": {
"n8n": {
"env": {
"N8N_API_KEY": "your_api_key",
"N8N_BASE_URL": "https://your-n8n-instance.com"
}
}
}
}
使用方法
列出所有工作流
python scripts/list_workflows.py
激活或停用工作流
python scripts/toggle_workflow.py --id WORKFLOW_ID --activate
python scripts/toggle_workflow.py --id WORKFLOW_ID --deactivate
获取执行历史
python scripts/get_execution_history.py --workflow-id WORKFLOW_ID
手动触发执行
python scripts/trigger_workflow.py --id WORKFLOW_ID