返回顶部
f

flomo-syncFlomo同步工具

将 flomo 所有记录 memo 同步/备份到本地 Markdown 文件的工具。使用 scripts/flomo-sync.py 脚本通过 flomo API 拉取 memo,支持增量同步、附件下载、多文件输出。当用户需要备份 flomo、同步 flomo memo 到本地、导出 flomo 笔记为 Markdown 时使用。

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
544
下载量
免费
免费
2
收藏
概述
安装方式
版本历史

flomo-sync

flomo-sync

将 flomo 所有 memo 增量同步为本地 Markdown 文件。

前置入参要求(必须)

执行本技能前,必须先明确并拿到以下入参:

  • - 当前项目主路径(绝对路径),例如 INLINECODE0
  • flomo token(来自项目主路径下 .flomo.config,避免在对话中明文暴露)

INLINECODE2 必须基于“当前项目主路径”传入绝对路径,禁止使用相对路径(如 ./output../backup)。

快速开始

1. 安装依赖(Python 3.10+)

CODEBLOCK0

2. 配置 token

在项目主路径下创建 .flomo.config,并包含 token=<access_token>

安全建议(强烈推荐)

  • - 优先使用 .flomo.config 保存 token,不要在对话中直接粘贴 token,避免泄露给 LLM。
  • 执行同步时优先使用 python scripts/flomo-sync.py(自动从 .flomo.config 读取)。

.flomo.config 格式说明

  • - 通用规则:一行一个 key=value;以 # 开头的行为注释;空行忽略。
  • flomo-sync 所需token=<access_token>;支持带或不带 Bearer 前缀,例如:
- token=1023456|AA000000ABCDEFGHIJKHLMNOP000000000000000 - token=Bearer 1023456|AA000000ABCDEFGHIJKHLMNOP000000000000000
  • - 获取 token:在浏览器打开 https://v.flomoapp.com 登录后,按 F12 → Network → 点击任意请求 → Headers → 复制 Authorization 的值(形如 Bearer 1023456|...)。备用:Application → Local Storage → me → 复制 access_token
  • 同一文件可同时包含 url= 供 flomo-add 使用(与 flomo-add 共用一配置文件)。

3. 运行同步

CODEBLOCK1

文档规范要求:执行同步时必须传 --dir 且使用绝对路径。实现层面为兼容保留兜底:未传 --dir 时,默认写入当前执行目录。

运行输出示例(含条目级进度)

CODEBLOCK2

参数说明

参数说明默认值
INLINECODE25flomo access_token(可从 .flomo.config 读取)。支持 Bearer <token> 格式
INLINECODE28
输出目录绝对路径(文档规范:必传)。必须基于“当前项目主路径”确定 | —(未传时实现默认当前执行目录) | | --after YYYY-MM-DD | 仅拉取该日期后更新的 memo | 自动读取 .flomo.lock | | --no-download | 不下载附件,保留远程 URL | 否(默认下载) |

输出格式

每条 memo 生成独立 .md 文件,命名格式为 {日期}_{标签}_{内容前6字}_{slug}.md

CODEBLOCK3

增量同步机制

脚本自动维护 .flomo.lock 文件,记录上次同步的最大 updated_at 时间戳。下次运行时自动从该时间点(减 1 天容错)开始拉取,无需手动指定 --after

常见问题

  • - sign 错误:token 无效或过期,重新从浏览器获取
  • 请先登录:未传入 token 或 token 不完整
  • 附件处理:图片(.png/.jpg/.gif 等)以 ![name](path) 嵌入,音频(.m4a/.mp3 等)以 [name](path) 链接;加 --no-download 保留原始远程 URL

文件说明

CODEBLOCK4

运行后会在输出目录产生:

CODEBLOCK5

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 flomo-sync-1776420039 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 flomo-sync-1776420039 技能

通过命令行安装

skillhub install flomo-sync-1776420039

下载

⬇ 下载 flomo-sync v1.0.0(免费)

文件大小: 11.02 KB | 发布时间: 2026-4-17 20:10

v1.0.0 最新 2026-4-17 20:10
flomo-sync 1.0.0 初始版本

- 支持通过 flomo API 将 flomo 全部 memo 增量同步为本地 Markdown 文件
- 支持增量同步,自动管理 .flomo.lock 以避免重复拉取
- 提供附件下载(图片、音频等)与可选 no-download 保留远程 URL
- 允许自定义输出目录(需绝对路径)及 after 参数筛选更新时间
- 输出每条 memo 为独立 Markdown 文件,支持多种命名与元数据
- 配置安全:推荐 token 保存在 .flomo.config,避免泄露

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部