KUMON OS 协作平台 × N8N 图文实战教程

目标读者：电脑小白、刚接触 KUMON OS 与 N8N 的用户。
教程目标：① 把微博/小红书/抖音等社媒数据源接入 KUMON OS；② 让 KUMON OS 的 AI Agent 调用 N8N 工作流完成自动化任务。

1. KUMON OS 是什么 & 登录入口

KUMON OS 协作平台（官方域名 https://www.guduu.net）是一款面向企业与内容团队的 AI 原生协作操作系统。它把「人、AI 智能体、工作流、社媒数据」放在同一套界面里，常见场景包括：

• 内容团队在一个频道里做选题策划、分镜脚本、商单合作；
• AI 智能体作为「AI 同事」加入频道，被 @ 或派单时工作；
• 通过 N8N / Make / Coze 工作流抓取社媒公开数据，回流到数据看板；
• 用工作流调用外部 API（生成图片、查舆情、写文案）并自动发回频道。

登录地址：

https://www.guduu.net/#/login

输入账号、密码后，点击「登录」即可进入你的企业专属实例。

2. 登录后第一眼：工作台与「社媒数据」区块

登录成功后，你看到的是一个「实时运营画布」。左侧是频道列表（大电影、数据看板、任务看板、图文教程、组织/人事等），中间是画布，右侧是「主人」AI 助手面板。

与本文关系最密切的是中间这两个区域：

• 社媒数据：还没接入时会显示「还没接入社媒数据源」，右侧有个「接入数据源」按钮；
• 平台运营：可以看到「工作流运行」次数，说明这里能触发 N8N 工作流。

3. 接入社媒数据源：官方 API vs AI 爬取（N8N/Coze）

点击「接入数据源」，会弹出「接入社媒数据源」窗口。KUMON OS 提供两种接法：

小白怎么选？ 如果你只是想要「定时抓取小红书上某个关键词的笔记标题/点赞数」，选 AI 爬取 + N8N 最快，不用去申请各平台开发者账号。

把「取数模式」切换到「AI 爬取（N8N / Coze 工作流）」后，只需要填一个字段：工作流连接器 slug。这个 slug 就是下一节在管理后台「工作流」面板里创建的连接器标识。

4. 进入管理后台，找到「工作流」连接器

KUMON OS 的管理后台地址是：

https://www.guduu.net/#/admin

进入后，左侧菜单选择 AI 能力 → 工作流。这里就是配置 N8N / Make 连接器的地方。

点击右上角「＋ 新建连接器」，填写表单：

• 标识 slug：英文/数字/短横线，全局唯一，例如 xiaohongshu-monitor；
• 名称：给人看的名字，例如「小红书舆情监控」；
• 平台：选 Webhook（n8n / Make / 自建）；
• Webhook URL：把 N8N 里 Webhook 触发节点的 URL 填进来；
• 请求方法：通常选 POST；
• 凭据名（可选）：如果 N8N Webhook 需要鉴权，可在这里写一个名字，真实密钥由运维写在服务端环境变量 COSMAC_大写名字 里，网页和聊天数据里都不会暴露；
• 输入提示（可选）：给最终用户在聊天里看到的提示，例如「输入要监控的小红书关键词」；
• 异步（长任务）：如果工作流执行时间长（如生成视频），勾选后 KUMON OS 会等工作流反向回调再把结果发回频道。

5. 在 N8N 侧准备好 Webhook 工作流

在 KUMON OS 里填的 Webhook URL，来自你本地或云上的 N8N。如果你还没用过 N8N，建议先把本地 N8N 跑起来（参考之前的《本地 Agent 使用 N8N 图文教程》）。

N8N 侧的关键步骤：

1. 在 N8N 点击「创建工作流」；
2. 添加触发器节点，搜索并选择「Webhook」；
3. 把 Webhook 节点的 URL 复制到 KUMON OS 连接器表单；
4. 在后面接 HTTP Request、Code、AI Agent 等节点完成抓取或生成任务；
5. 点击「发布」，让工作流处于可触发状态。

注意：Webhook 工作流必须先「发布」，KUMON OS 发过来的请求才会被 N8N 接收。没发布时 Webhook URL 是休眠状态。

6. 让 AI Agent 拥有「跑外部工作流」能力

KUMON OS 的 AI 不只聊天，它还能调用工具。要让 AI 触发 N8N 工作流，必须打开一个总开关。

6.1 打开「跑外部工作流」工具开关

进入管理后台 AI 能力 → AI 配置，页面下方有「工具开关」。确保「跑外部工作流（n8n / Make 等）」处于勾选状态。关掉这个开关，主 AI 将无法调用任何 N8N 连接器。

6.2 技能库：给 AI 配「技能」

进入 AI 能力 → 技能库。技能就是「给 AI 的一段任务说明」，例如「营销活动策划」「小红书种草笔记」「短视频口播脚本」。

点击「＋ 新建技能」，可以写自己的技能。关键字段：

• 标识 slug / 名称 / 一句话说明；
• 技能正文：写给 AI 的详细步骤，例如「按小红书原生逻辑写标题+正文+标签」；
• 可用范围：谁能使用这个技能；
• 生效方式：「全局注入」会让每轮对话都带上该技能（占预算，慎用），通常建议绑定到智能体后再激活。

6.3 智能体：把角色、模型、技能打包

进入 AI 能力 → 智能体。智能体 = 角色 + 模型 + 绑定技能。你可以把它理解为「一个专门的 AI 同事」。

点击「＋ 新建智能体」，填写：

• 标识 slug：如 workflow-architect；
• 名称：如「工作流架构师」；
• 一句话说明：如「负责搭建和调用 N8N 工作流」；
• 人设（system prompt）：写清楚它是谁、擅长什么、工作方式；
• 模型覆盖：留空则跟随全局 AI 配置。

怎么让智能体调用 N8N？ 只要「跑外部工作流」开关开着，并且智能体/主 AI 被正确提示「需要时调用工作流 slug」，它就会在对话中自动触发。你也可以直接在频道里发指令：工作流 跑 xiaohongshu-monitor。

7. 实战一：小红书舆情监控自动接入数据看板

目标：定时抓取小红书上「露营装备」相关笔记的标题、点赞数，回流到 KUMON OS 数据看板。

7.1 在 KUMON OS 创建连接器

进入管理后台 → AI 能力 → 工作流，新建连接器：

slug: xiaohongshu-monitor
名称: 小红书露营舆情监控
平台: Webhook（n8n / Make / 自建）
Webhook URL: （从 N8N Webhook 节点复制）
请求方法: POST
输入提示: 输入要监控的小红书关键词

7.2 在 N8N 搭建抓取工作流

1. 触发器选 Webhook，方法 POST；
2. 用 HTTP Request 节点请求小红书搜索页（或第三方抓取服务）；
3. 用 Code 节点解析出标题、点赞数、链接；
4. 用 Respond to Webhook 节点把结果按 KUMON OS 能识别的格式返回；
5. 发布工作流。

7.3 在数据看板接入数据源

回到频道「数据看板」→ 点击「接入数据源」：

• 平台：小红书；
• 取数模式：AI 爬取（N8N / Coze 工作流）；
• 工作流连接器 slug：xiaohongshu-monitor；
• 同步间隔：6 小时。

保存后，KUMON OS 会按设定周期调用 N8N 工作流，把抓取结果展示在「社媒数据」区块。

8. 实战二：AI Agent 调用 N8N 生成内容并回传

目标：在频道里 @「工作流架构师」智能体，让它根据关键词生成一篇小红书笔记，并自动发回频道。

8.1 N8N 工作流：接收关键词 → 调用大模型 → 返回文案

1. 触发器用 Webhook，接收 keyword 参数；
2. 接一个 OpenAI / 其他 Chat Model 节点，写 system prompt「你是小红书文案高手」；
3. 把生成结果通过 Respond to Webhook 返回 JSON；
4. 发布。

8.2 KUMON OS 配置

• 在管理后台 → 工作流，新建连接器 xiaohongshu-gen，URL 填 N8N Webhook；
• 在 AI 配置里确认「跑外部工作流」开关打开；
• 在智能体里新建「小红书文案师」，人设里写明「当用户需要小红书笔记时，调用 xiaohongshu-gen 工作流」。

8.3 在频道里使用

进入任意频道，在右侧 AI 面板或输入框里说：

@小红书文案师 给我写一篇关于「城市露营」的小红书笔记

智能体会调用 xiaohongshu-gen 工作流，N8N 生成文案后返回，KUMON OS 自动把结果发回频道。

9. 凭据与安全问题

KUMON OS 在设计上就尽量避免把密钥暴露在网页和聊天记录里：

• 官方 API 的密钥（如 COSMAC_SOCIAL_YOUTUBE_API_KEY）由运维写在服务端环境变量；
• N8N Webhook 的鉴权凭据也是填「凭据名」，真实 key 进服务端环境变量 COSMAC_大写名字；
• 留空凭据名 = URL 自带令牌或无需鉴权，适合本地测试，生产环境建议加上鉴权。

N8N 侧的安全建议：

• 给 Webhook 节点开启 Authentication（Basic Auth 或 Header Auth）；
• 不要把生产 Webhook URL 暴露到公开文档；
• 定期在 N8N「凭证」页面轮换 API Key。

10. 常见问题与排错

Q1：KUMON OS 提示「工作流运行 0 次」，明明已经配置了？

• 检查 N8N 工作流是否已发布；
• 检查 KUMON OS 连接器里的 Webhook URL 是否和 N8N 里完全一致（注意末尾有没有 /）；
• 检查 AI 配置 → 工具开关 → 「跑外部工作流」是否勾选。

Q2：N8N 收不到 KUMON OS 的请求？

• 如果 N8N 跑在本地 localhost:5678，KUMON OS 云端无法直接访问，需要用内网穿透（如 ngrok、Cloudflare Tunnel）或把 N8N 部署到公网服务器；
• 在 N8N「执行」记录页查看是否有新的执行记录；
• 用 N8N 的测试 Webhook URL 先手动 curl 一次测试连通性。

Q3：AI 不调用工作流，只回复文字？

• 在智能体/技能的人设里写清楚「必须调用工作流 slug」；
• 直接在频道输入精确指令：工作流 跑 xiaohongshu-monitor；
• 确认该智能体已被加入当前频道（或被 @ 时激活）。

Q4：抓取数据不稳定？

• AI 爬取依赖目标网页结构，网页改版后解析规则可能失效；
• 频繁抓取可能触发平台反爬，建议加随机延迟、使用代理池，或改用官方 API；
• 在 N8N 工作流里加上错误处理和重试节点。