N8N 新手图文教程

从零基础开始,一步步教你用 N8N 搭建自动化工作流和 AI 聊天机器人(基于真实界面截图)

阅读提示:本教程所有截图都来自你电脑里真实运行的 N8N(http://localhost:5678)。图片中红字标注的按钮和区域,就是你在操作时要点的地方。建议边打开 N8N 边照着做。

〇、启动 N8N

每次想用 N8N 之前,都要先启动它。方法有两种:

  1. 双击桌面或 C:UsersAdministrator 8nstart-n8n.bat 文件
  2. 等待窗口中出现类似 Editor is now accessible via: http://localhost:5678 的字样
  3. 打开浏览器,访问 http://localhost:5678
如果 N8N 已经在运行,直接打开浏览器访问上面的地址即可。窗口关掉就等于停止服务。

一、登录 N8N

第一次打开会看到登录页。输入你注册时用的邮箱和密码,点击 登录 按钮。

登录页

图 1:N8N 登录页面

如果忘记密码,可以在本机命令行重置,或私信我帮你处理(数据不会丢)。

二、认识主界面

登录成功后,首先看到的是 概述 页面:

概览页

图 2:概览页,这里能看到所有工作流、凭据、执行记录

2.1 界面四大区域

位置名称作用
最左边侧边栏切换 Overview、Templates、Insights、Help、Settings
顶部标签页工作流、凭证、执行、变量、数据表格
中间工作流列表显示你已创建的所有工作流
右上角创建工作流新建工作流按钮

三、创建第一个自动化工作流

我们先做一个最简单的自动化:每天早上自动访问一个网页,获取数据。它由两个节点组成:

3.1 新建工作流

点击右上角的 创建工作流 按钮。
空白画布

图 3:新建工作流后,中间会出现一块「画布」,中间写着「添加第一步...」

3.2 添加第一个节点:Schedule Trigger

点击画布中间的 添加第一步...
右侧会弹出一个面板,问你要用什么「触发器」。
触发器选择面板

图 4:触发器选择面板,N8N 会问你「是什么触发这个工作流?」

在顶部搜索框输入 schedule
点击 Schedule Trigger
搜索 schedule

图 5:输入 schedule 后,第一个就是「Schedule Trigger」

点击后,画布上会出现一个时钟图标,右侧自动打开配置面板:

Schedule Trigger 配置

图 6:Schedule Trigger 配置面板

3.3 设置定时规则

右侧面板里有几个关键选项:

如果你只是想测试,先把间隔设成「Every minute」或「Every hour」。等确认没问题再改成每天或每周。

3.4 添加第二个节点:HTTP Request

接下来让工作流去访问一个网页。

把鼠标移到 Schedule Trigger 节点上,按键盘上的 N 键,会弹出节点浏览器。
按 N 打开节点浏览器

图 7:选中节点后按 N,会弹出「节点浏览器」提示

节点浏览器出现后,在搜索框输入 http request
点击 HTTP Request
搜索 HTTP Request

图 8:在节点浏览器中搜索 HTTP Request

3.5 配置 HTTP Request

点击 HTTP Request 后,右侧会打开它的配置面板。我们用它访问一个免费的测试接口:

HTTP Request 配置

图 9:HTTP Request 配置面板

Method 保持 GET 不变。
URL 填写 https://httpbin.org/get
Authentication 保持 None 不变(因为这个测试接口不需要认证)。
点击右上角的 执行步骤 按钮。

如果一切正常,右侧 OUTPUT 区域会出现返回值:

HTTP 执行结果

图 10:执行成功后,右侧会显示服务器返回的数据

OUTPUT 区域怎么看? 这里是节点执行后的输出数据。N8N 会自动把数据整理成表格形式,你可以点击 argsheadersoriginurl 等字段查看详情。

此时你的画布应该是这样:

两个节点的工作流

图 11:一个简单的工作流:定时触发 → HTTP 请求

四、保存并发布工作流

工作流只有发布后才会按定时规则自动运行。如果只是保存但不发布,它不会自动触发。

4.1 点击发布

点击右上角的 发布 按钮。
Publish 对话框

图 12:点击 Publish 后,需要给这个版本起个名字

版本名称 里写个简单说明,例如 初版:每日自动获取数据
点击对话框右下角的 发布
发布成功

图 13:发布成功后,会提示「Workflow published」

4.2 查看执行记录

发布后,工作流会按照你设置的时间自动运行。想查看它是否正常运行,可以点击顶部标签的 执行

执行记录

图 14:Executions 页面,可查看每次运行的状态和时间

绿色表示成功,红色表示失败。点击某一条记录,可以进去看每个节点的输入输出,方便排查问题。

五、认识 AI Agent 工作流

前面做的是普通自动化。接下来看 N8N 的「AI Agent」功能——也就是聊天机器人。

5.1 打开示例 AI 工作流

N8N 已经内置了一个 AI Agent 示例。回到 概述 页面,可以看到一条叫 Chat with a database using AI 的工作流:

概览页中的 AI 工作流

图 15:概述 中已有的 AI Agent 示例工作流

点击它,你会看到一个典型的 AI Agent 结构:

AI Agent 工作流

图 16:AI Agent 工作流结构

5.2 这个工作流是什么意思?

看图 16,从左边到右边依次是:

  1. When chat message received:聊天触发器。用户在聊天窗口发消息时,工作流开始运行。
  2. AI Agent:智能体大脑。它会把用户消息传给大模型,并决定是否需要调用工具。
  3. OpenAI Chat Model:大模型。这里用的是 OpenAI 的 GPT 模型,也可以换成 DeepSeek、Claude 等。
  4. Simple Memory:简单记忆。让机器人能记住对话上下文。
  5. Postgres:数据库工具。机器人可以通过它查询数据库内容。

5.3 配置 AI Agent 节点

双击 AI Agent 节点,可以看到它的配置面板:

AI Agent 配置

图 17:AI Agent 节点配置面板

关键配置:

5.4 配置 OpenAI 模型

双击 OpenAI Chat Model 节点,会要求你绑定 OpenAI 的 API Key:

OpenAI 配置

图 18:OpenAI Chat Model 节点需要 API Key 凭据

只有正确配置了 API Key 并选了模型(如 gpt-4o-mini),AI Agent 才能正常工作。如果没有 OpenAI 账号,也可以换成国内的 DeepSeek、Moonshot 等模型节点。

六、如何添加凭据(Credentials)

凭据是 N8N 存放 API Key、密码等敏感信息的地方。所有需要登录的服务都要先在这里配置。

6.1 进入凭据页面

点击 概述 顶部标签的 凭证

凭据页面

图 19:凭据管理页面,第一次使用会显示空状态

6.2 新建 OpenAI 凭据

点击 创建凭证
在弹出的搜索框输入 openai
点击 OpenAI
新建凭据对话框

图 20:点击 创建凭证 后选择服务

搜索 OpenAI

图 21:搜索 OpenAI

点击 继续。
API Key 框里粘贴你的 OpenAI API Key。
OpenAI API Key 表单

图 22:OpenAI 凭据表单

点击右上角的 保存
API Key 从哪里拿? 去 OpenAI 官网(platform.openai.com)登录后,点击左侧 API keys,新建一个 key。国内的 DeepSeek、Moonshot 也在各自的开发者平台提供 API Key。

七、测试聊天机器人

配置好大模型凭据后,回到 AI Agent 工作流,点击画布下方的 打开聊天 按钮,会弹出聊天面板:

聊天测试面板

图 23:Open chat 面板,可在这里和机器人对话测试

测试时如果机器人报错,先检查:1)凭据是否保存;2)是否选了正确的模型;3)网络是否能访问 OpenAI 接口。

八、常用快捷键速查

快捷键作用
Tab打开节点搜索
N选中节点后,快速添加下一个节点
Ctrl + S保存工作流
Ctrl + Enter执行工作流
Ctrl + Z / Ctrl + Y撤销 / 重做
Delete删除选中的节点
Ctrl + 鼠标滚轮放大 / 缩小画布

九、下一步可以做什么

学会基础操作后,你可以尝试这些自动化场景:

关于密码:为了截图,我刚才临时把你的 N8N 登录密码改成了 ************。建议你立刻登录后,在 设置 → 个人 里重新改成自己记得住的密码。