n8n-as-code

为你的 AI Agent 赋予 n8n 超能力。

GitOps · AI 技能 · TypeScript 工作流 · VS Code · Claude Code · OpenClaw

你的 AI Agent 不仅仅是“阅读”关于 n8n 的文档，它真正“了解” n8n。 这是一个为 n8n 开发的可安装本体库——包含了每个节点、每个属性、每个选项及其相互关系——并在安装时完成嵌入。 零外部调用。零延迟。零幻觉。

📖 文档 · 🚀 快速开始 · 🧠 AI 技能

---

⚠ n8n 版本兼容性说明 — n8n-as-code 捆绑的节点架构是基于 n8n 的最新稳定版本 构建的。为了获得最佳效果，请保持你的 n8n 实例为最新版本。使用过旧的实例可能会导致生成的自动化流程引用当前实例尚不支持的节点类型版本，从而在画布中显示为损坏的节点。

---

⚡ 快速开始

选择最符合你当前工作方式的入口。

💻 VS Code / Cursor

编辑器内的可视化工作流视图。

适用场景： VS Code, Cursor, Windsurf, Antigravity

设置： 从 VS Code Marketplace 或 Open VSX 安装。 打开 n8n 视图。 执行 n8n: Configure，输入你现有 n8n 实例的 URL 和 API Key，加载项目，然后保存并激活配置。

VS Code Marketplace · Open VSX

✴️ Claude Code

基于插件的 Claude 工作流工作模式。

适用场景： 通过 marketplace 安装进行 Agent 驱动的编辑

运行：

/plugin marketplace add EtienneLescot/n8n-as-code
/plugin install n8n-as-code@n8nac-marketplace

Claude 设置文档

🦞 OpenClaw

OpenClaw 原生插件和工作区引导流程。

适用场景： 需要内置基础支撑和设置的 OpenClaw 用户

运行：

openclaw plugins install @n8n-as-code/n8nac
openclaw n8nac:setup
openclaw gateway restart

OpenClaw 设置文档

Yagr

引导式入门、持久化运行环境，通往 n8n-as-code 的最简路径。

适用场景： 最快设置、以 Agent 为核心的工作流、跨工具共享运行环境

运行：

npm install -g @yagr/agent@latest
yagr onboard

Yagr 文档 · Yagr 代码仓库

然后，只需告诉你的 Agent 你想用 n8n 工作流做什么。 构建新流程、更新现有流程、搜索节点和模板、验证更改、从 n8n 拉取、推送更新，并保持一切同步。

新特性：Agent 现可闭环执行运行时

n8n-as-code 现已消除 AI 辅助工作流开发中的一大痛点。

Agent 现在可以：

• 在推送后检测工作流缺失哪些凭据 (credentials)
• 仅向用户索要其无法自行推断的私密值
• 无需跳回 n8n UI 即可配置这些凭据
• 配置完成后激活工作流
• 代表用户执行 Webhook、聊天和表单工作流
• 当服务器端运行失败时，直接从 n8n 检查执行结果数据

从用户角度来看，这是一次重大进步：Agent 不再局限于编辑工作流代码。它现在可以驱动工作流直到实际执行，并利用 n8n 返回的执行数据进行调试。

详细命令请参考 CLI 指南。

⌨️ CLI

用于同步和自动化的终端优先工作流。

适用场景： 脚本、CI、GitOps 流水线、直接工作流操作

运行：

npx --yes n8nac init