来源：notes/projects/flomo_integration/01_flomo_整合进个人助理方案.md

flomo 整合进个人助理方案

结论

建议把 flomo 定位为“随手记录与灵感入口”，把个人助理工作区定位为“结构化处理、任务推进、文档沉淀和飞书同步中枢”。落地上采用两层能力：

1. 第一阶段用 flomo Incoming Webhook 做稳定写入：个人助理可以把灵感、任务、复盘摘要、处理结果回写到 flomo。
2. 第二阶段用 flomo MCP 做读写闭环：让 AI 工具按需读取、搜索、创建、更新 flomo 笔记，再把可执行内容同步到本地 Markdown、飞书 Docs 和飞书多维表格。

已核实能力

官方 API 与 URL Scheme

flomo 官方帮助页说明，API & URL Scheme 属于 PRO 会员能力，提供第三方工具与 flomo 交互的能力。API 页面公开说明“提供调用方便的记录 API”，详情入口在 https://flomoapp.com/mine?source=incoming_webhook，也就是登录后获取个人 incoming webhook 地址。

可用于个人助理的判断：

• 适合：从个人助理向 flomo 新建 memo。
• 不适合：稳定批量读取历史 memo、搜索 memo、更新 memo。公开帮助页没有把这些作为普通 API 能力列出。
• 约束：需要 flomo PRO；webhook URL 等同写入密钥，必须放在本地配置或环境变量，不能写入公开仓库。

URL Scheme

flomo 支持 flomo://create，可带 content 和 image_urls 参数。content 最大 5000 字，image_urls 最多 9 个 URL。

可用于个人助理的判断：

• 适合：手机端快捷打开 flomo 并预填内容。
• 不适合：服务器自动化，因为它依赖本机安装的 flomo App 和用户交互。

MCP

flomo 官方帮助页把 MCP 放在“AI 工具连接”能力下，说明可在 Claude、ChatGPT 等 AI 工具中直接读写 flomo。公开页面和页面元信息显示，该能力面向 AI 工具连接，关联创建、搜索、更新笔记及标签等操作；侧栏标注为 MAX 会员能力。

可用于个人助理的判断：

• 适合：AI 助理读取最近 memo、按标签/关键词搜索、创建 memo、更新 memo、补标签。
• 不适合：把 flomo 当作唯一数据库。MCP 更适合 AI 会话内工具调用，不适合替代本地 Markdown 和飞书 Base 的长期结构化账本。
• 约束：需要 flomo MAX；具体 token、server 地址和授权方式应以登录后的 flomo MCP 设置页为准。

导出

flomo 官方帮助页说明支持全局导出和按条件导出，导出格式为 HTML。

可用于个人助理的判断：

• 适合：一次性迁移、定期备份、补齐历史资料。
• 不适合：高频增量同步。HTML 需要解析，稳定性和字段完整性不如 API/MCP。

推荐架构

用户随手记
  -> flomo
  -> MCP/导出读取
  -> 个人助理 inbox/capture.md
  -> 分类：信息 / 任务 / 待确认
  -> tasks / notes / logs
  -> 飞书 Docs + 多维表格

个人助理处理结果
  -> 本地 Markdown 源文件
  -> 飞书 Docs / Base
  -> Incoming Webhook 回写 flomo 摘要或反思卡片

核心原则：

• flomo 负责捕捉，不承载复杂项目管理。
• 个人助理负责加工，不要求用户在 flomo 里手动整理字段。
• 飞书负责展示、检索、协作和阶段性复盘。
• 本地 Markdown 仍是源文件，避免被单一 SaaS 锁死。

多维表格设计

建议在现有个人助理多维表格基础上新增或预留一张“flomo 收件箱”表。如果短期不改表结构，也可以先把整理后的结果同步到现有“知识索引”“文档资产”“待办事项”“每日记录”。

表：flomo 收件箱

表：flomo 回写日志

本地文件设计

建议新增配置和脚本：

• codex_personal_assistant/config/flomo.json：保存非敏感配置，例如默认标签、同步窗口、处理规则。敏感 token 使用环境变量。
• codex_personal_assistant/scripts/flomo_write.py：通过 Incoming Webhook 写入 memo。
• codex_personal_assistant/scripts/flomo_mcp_ingest.py：通过 MCP 拉取最近 memo，写入 inbox 或 notes。
• codex_personal_assistant/scripts/sync_flomo_to_base.py：把 flomo 收件箱和回写日志同步到飞书多维表格。

环境变量建议：

export FLOMO_WEBHOOK_URL='https://flomoapp.com/iwh/your-token'
export FLOMO_MCP_URL='以 flomo 设置页为准'
export FLOMO_MCP_TOKEN='以 flomo 设置页为准'

处理规则

flomo 到个人助理

1. 拉取最近 24 小时或上次同步后的 memo。
2. 按标签和内容识别类型：
   • 包含 #todo、#任务、要做：进入 tasks/todo.md。
   • 包含 #日记、今天、时间地点事件：进入 logs/daily_log.md。
   • 包含 #灵感、#选题、#研究：进入 inbox/capture.md，必要时生成 notes/topics/...。
   • 包含链接或长摘录：标为资料，等待二次处理。
3. 生成处理结果后同步飞书多维表格。
4. 重要内容再创建或更新飞书 Docs。

个人助理到 flomo

建议只回写“高价值摘要”，避免把 flomo 变成重复备份仓库：

• 每日复盘：写入一条 #个人助理/日复盘。
• 新建正式笔记：写入一条 #个人助理/知识沉淀，包含标题、摘要、飞书 Docs 链接。
• 任务计划：写入一条 #个人助理/行动，只保留当天最重要 1-3 件事。

回写模板：

#个人助理/知识沉淀
标题：...
一句话结论：...
下一步动作：...
飞书文档：...

实施步骤

第 1 步：写入能力打通

• 在 flomo 设置页获取 Incoming Webhook。
• 本地设置 FLOMO_WEBHOOK_URL。
• 编写 flomo_write.py，支持 --content 和 --file。
• 用一条测试 memo 验证写入。

第 2 步：读能力验证

• 如果已有 flomo MAX，优先在 AI 工具中启用 MCP。
• 验证四个动作：搜索最近 memo、按标签搜索、创建 memo、更新 memo。
• 记录 MCP 返回字段，确认是否有 memo ID、创建时间、更新时间、标签。

第 3 步：建立 flomo 收件箱表

• 在飞书 Base 增加“flomo 收件箱”和“flomo 回写日志”。
• 更新 feishu_base.json 增加表 ID。
• 扩展同步脚本，把 flomo 处理状态写入多维表格。

第 4 步：半自动处理

• 每天拉取一次 flomo 最近 memo。
• 个人助理先生成分类建议，不自动删除或改写 flomo 原文。
• 用户确认后写入任务、日志或主题笔记。

第 5 步：自动化复盘

• 每天晚上自动汇总当天 flomo、todo、daily log。
• 输出一条日复盘到飞书文档/多维表格。
• 只把最终摘要回写 flomo。

风险与边界

• 普通 API 公开信息只确认“写入记录”能力，读取和更新不要押注在非官方接口上。
• MCP 能力受会员等级、客户端支持和授权方式影响，必须用你的账号实测。
• flomo 是碎片化记录工具，不适合承载复杂任务状态；任务主表仍应在个人助理和飞书 Base。
• Webhook URL 泄露会导致别人向你的 flomo 写入内容，应按密钥管理。
• HTML 导出适合作备份和迁移，不适合作实时同步。

下一步动作

1. 获取并保存 FLOMO_WEBHOOK_URL，先打通个人助理到 flomo 的写入。
2. 确认账号是否有 MAX，决定是否启用 MCP 读写闭环。
3. 在飞书多维表格新增两张 flomo 专用表，或先用现有表做一周轻量试运行。
4. 一周后复盘：保留“回写摘要”和“任务识别”，谨慎开启自动更新 flomo 原文。

来源

• flomo API & URL Scheme 官方帮助页：https://help.flomoapp.com/advance/api.html
• flomo MCP 官方帮助页：https://help.flomoapp.com/advance/mcp/
• flomo 存储与导出官方帮助页：https://help.flomoapp.com/basic/storage.html