OpenClaw + n8n 工作流编排

痛点

让你的 AI 智能体直接管理 API 密钥和调用外部服务是安全事故的温床。每个新集成都意味着 .env.local 中多一个凭证，多一个智能体可能意外泄露或误用的攻击面。

当 OpenClaw 直接处理所有事情时，你会遇到三个叠加问题：

• 无可见性：当智能体构建的内容埋在 JavaScript 技能文件或 shell 脚本中时，很难检查它实际做了什么。
• 凭证蔓延：每个 API 密钥都在智能体的环境中，离暴露只差一次错误提交。
• 浪费 token：确定性子任务（发邮件、更新电子表格）在可以作为简单工作流运行时却消耗 LLM 推理 token。

你可以做什么

• 代理模式：OpenClaw 编写带有传入 webhook 的 n8n 工作流，然后为所有未来的 API 交互调用这些 webhook。
• 凭证隔离：API 密钥存放在 n8n 的凭证存储中——智能体只知道 webhook URL。
• 可视化调试：每个工作流都可以在 n8n 的拖放 UI 中检查。
• 可锁定工作流：一旦构建和测试完成，锁定工作流使智能体无法修改。
• 安全措施步骤：在任何外部调用执行之前，在 n8n 中添加验证、速率限制和审批门。

架构

┌──────────────┐     webhook 调用     ┌─────────────────┐     API 调用     ┌──────────────┐
│   OpenClaw   │ ───────────────────→ │   n8n 工作流     │ ─────────────→ │  外部服务     │
│   （智能体）  │   （无凭证）          │  （锁定，含       │  （凭证留在     │  （Slack 等） │
│              │                      │   API 密钥）      │   这里）        │              │
└──────────────┘                      └─────────────────┘                  └──────────────┘

你需要的技能

• n8n API 访问（用于创建/触发工作流）
• fetch 或 curl 用于 webhook 调用
• Docker（如使用预配置堆栈）
• n8n 凭证管理（手动，每个集成一次性设置）

如何设置

选项 1：预配置 Docker 堆栈

社区维护的 Docker Compose 设置（openclaw-n8n-stack）预配置了所有内容：

git clone https://github.com/caprihan/openclaw-n8n-stack.git
cd openclaw-n8n-stack
cp .env.template .env
# 将你的 Anthropic API 密钥添加到 .env
docker-compose up -d

这会给你：

• OpenClaw 在端口 3456
• n8n 在端口 5678
• 共享 Docker 网络，OpenClaw 可直接调用 http://n8n:5678/webhook/...
• 预构建的工作流模板（多 LLM 事实核查、邮件分拣、社交监控）

选项 2：手动设置

1. 安装 n8n（npm install n8n -g 或通过 Docker 运行）。
2. 配置 OpenClaw 使其知道 n8n 的基础 URL。
3. 在你的 AGENTS.md 中添加：

## n8n 集成模式

当我需要与外部 API 交互时：

1. 永远不要在我的环境或技能文件中存储 API 密钥
2. 检查是否已存在此集成的 n8n 工作流
3. 如果不存在，通过 n8n API 创建一个带 webhook 触发器的工作流
4. 通知用户添加凭证并锁定工作流
5. 对于所有未来的调用，使用 webhook URL 和 JSON 负载

工作流命名：openclaw-{service}-{action}
示例：openclaw-slack-send-message

Webhook 调用格式：
curl -X POST http://n8n:5678/webhook/{workflow-name} \
  -H "Content-Type: application/json" \
  -d '{"channel": "#general", "message": "Hello from OpenClaw"}'

构建 → 测试 → 锁定循环

1. 智能体设计工作流 → 通过 n8n API 创建，带 webhook 触发器。
2. 你添加凭证 → 打开 n8n UI，手动添加 token。
3. 你锁定工作流 → 防止智能体进一步修改。
4. 智能体调用 webhook → 从此以后，它永远看不到 API 密钥。

关键洞察

• 三合一收益：可观测性（可视化 UI）、安全性（凭证隔离）和性能（确定性工作流不消耗 token）。
• 测试后锁定："构建 → 测试 → 锁定"循环至关重要——不锁定的话，智能体可以静默修改工作流。
• n8n 有 400+ 集成：大多数外部服务已有 n8n 节点，省去了智能体编写自定义 API 调用的麻烦。
• 免费的审计追踪：n8n 记录每次工作流执行的输入/输出数据。

灵感来源

这种模式由 Simon Hoiberg 描述，他概述了这种方法优于让 OpenClaw 直接处理 API 交互的三个原因：通过 n8n 可视化 UI 实现可观测性、通过凭证隔离实现安全性、以及通过将确定性子任务作为工作流而非 LLM 调用来提升性能。openclaw-n8n-stack 仓库提供了实现此模式的即用型 Docker Compose 设置。

相关链接

• n8n 文档
• openclaw-n8n-stack（Docker 设置）
• n8n Webhook 触发器文档

通过 ShipClaw 部署

跳过繁琐配置 — 获取全托管 OpenClaw 实例，即可运行此用例。

快速开始

1. 选择方案 — 此用例推荐 Pro
2. 进入实例面板，点击部署新实例
3. 部署完成后，使用上方的示例提示词配置你的智能体
4. 根据需要自定义阈值、计划和数据源