基于Obsidian CLI与OpenClaw实现每日笔记自动化归档与链接维护
1. 项目概述：自动化归档Obsidian每日笔记
如果你和我一样，是Obsidian的重度用户，并且严格遵循每日笔记（Daily Note）的工作流，那么你的笔记库根目录下，一定散落着大量以日期命名的文件。它们记录着每一天的思考、待办和灵感，是数字大脑的宝贵记忆。但久而久之，这些文件会让根目录变得臃肿不堪，查找特定主题的笔记时，视线总被这些时间戳文件干扰。手动将它们移入一个专门的归档文件夹，比如past-days/，是个好主意，但随之而来的问题是：所有指向这些旧笔记的内部链接（[[链接]]）都会断裂，你的知识网络将出现一个个“黑洞”。
这正是archive-daily-note这个OpenClaw技能要解决的核心痛点。它不是一个简单的文件搬运工，而是一个理解Obsidian知识图谱的智能管家。其核心价值在于，它利用Obsidian官方的命令行工具（CLI）来执行移动操作，确保在物理位置变更的同时，自动、准确地更新整个笔记库中所有相关的内部链接和反向链接，保持你的知识网络的完整性与可访问性。简单来说，它让你可以放心地整理文件结构，而无需担心“牵一发而动全身”的链接失效问题。
这个技能的设计哲学是“静默且可靠”。它被设计为在每天凌晨通过cron任务自动运行，像一位尽职的图书管理员，在你入睡后，默默地将昨天的“日记”归入历史档案架，并更新所有目录卡片。整个过程对用户无感，只有当出现错误（如Obsidian CLI未安装）时才会发出警报。它适合所有希望保持笔记库整洁，同时又极度依赖内部链接来构建知识体系的Obsidian用户。
2. 核心原理与工具选型解析
2.1 为什么不能直接用mv或cp命令？
这是理解本项目价值的关键。在普通的文件系统中移动一个Markdown文件，使用mv yesterday.md past-days/命令瞬间即可完成。然而，在Obsidian（或其他支持双向链接的笔记工具，如Logseq）的语境下，一个笔记文件不仅仅是它自身，更是整个链接网络中的一个节点。
假设你的笔记ProjectA.md中有一行：[[2024-10-27 Sunday]] 讨论了初步方案。当你用mv命令将2024-10-27 Sunday.md移走，ProjectA.md中的这个链接并不会自动更新路径。在Obsidian中点击这个链接，它会尝试在根目录寻找目标文件，结果自然是“找不到该文件”，链接会显示为未解析状态（通常是一个带问号的链接）。更糟糕的是，反向链接面板也会失效，你无法从被移动的日记笔记中看到有哪些笔记引用了它。知识网络的断裂就此发生。
因此，任何涉及Obsidian笔记文件的移动、重命名操作，都必须通过Obsidian自身提供的、能感知链接的接口来完成。
2.2 Obsidian CLI：官方的“链接感知”操作工具
Obsidian CLI是Obsidian官方提供的命令行工具，它本质上是桌面应用功能的一个子集暴露。通过命令obsidian，我们可以在不打开图形界面的情况下，对笔记库进行一系列操作，其中最关键的两个命令是obsidian rename和obsidian move。
obsidian rename: 重命名指定路径下的一个文件，并自动更新库中所有指向它的链接。obsidian move: 将指定路径下的一个文件移动到新路径，并自动更新库中所有指向它的链接。
archive-daily-note技能正是基于obsidian move命令构建的。它首先通过计算确定“昨天”的日期，并据此生成预期的每日笔记文件名（如10-27-2024 Sunday.md），然后在笔记库根目录查找该文件。如果找到，则调用obsidian move <文件路径> past-days/命令。这个命令在后台会：
- 解析整个笔记库，建立所有文件之间的链接关系图。
- 将目标文件移动到新位置。
- 遍历所有包含指向该文件链接的笔记，将链接路径更新为新的相对路径。
- 更新反向链接索引。
整个过程是原子性的，要么全部成功，要么回滚，保证了数据的一致性。这是手动操作或简单脚本无法比拟的。
2.3 OpenClaw技能：可编程的自动化胶囊
OpenClaw是一个新兴的自动化平台，你可以把它理解为一个更轻量、更专注于个人工作流自动化的“超级cron”或“本地化IFTTT”。它的“技能”（Skill）是一个个可执行的任务单元，可以用多种语言编写，并通过YAML文件定义触发条件（如定时、文件变化、HTTP请求等）。
本项目就是一个OpenClaw技能。它的核心是一个脚本（可能是Shell、Python等），封装了上述“计算日期->查找文件->调用obsidian move”的逻辑。通过OpenClaw的cron触发器，我们可以非常方便地将其设置为每日定时任务，而无需直接操作复杂的系统crontab。OpenClaw还提供了“隔离”（Isolated）执行模式，为任务提供一个干净、可控的运行环境，避免了环境变量依赖等问题，增强了可靠性。
工具选型总结： 这个方案的精妙之处在于其“各司其职”的架构：OpenClaw负责可靠调度与执行环境，Obsidian CLI负责保证链接安全的文件操作，自定义脚本则负责粘合逻辑与错误处理。它没有重新发明轮子，而是巧妙地组合了现有工具的最强项，实现了一个看似简单但至关重要的自动化需求。
3. 完整部署与配置实操指南
要让archive-daily-note技能在你的系统中跑起来，需要完成以下几个步骤。我会以macOS/Linux系统为例，Windows用户需要在WSL或Git Bash等环境下操作，原理相通。
3.1 前置条件检查与安装
在开始之前，请确保你的系统满足以下条件：
Obsidian 及 CLI 工具：
- 确保已安装Obsidian桌面版。CLI工具通常随桌面版一起安装，但可能需要手动启用或检查。
- 打开终端，输入
obsidian --version。如果返回版本号（如1.5.8），说明CLI已就绪。 - 如果命令未找到，你需要手动链接或安装CLI。在macOS上，Obsidian通常安装在应用程序目录，其CLI工具位于
/Applications/Obsidian.app/Contents/Resources/app.asar.unpacked/node_modules/@obsidian/cli/obsidian.js。你可以创建一个软链接到系统路径：sudo ln -s /Applications/Obsidian.app/Contents/Resources/app.asar.unpacked/node_modules/@obsidian/cli/obsidian.js /usr/local/bin/obsidian - 重要提示：首次运行
obsidian命令时，可能需要指定笔记库路径。最稳妥的方式是先在终端内用cd命令进入你的Obsidian笔记库根目录，再执行obsidian --help测试。后续在脚本中，我们也需要通过--vault参数或环境变量明确指定库路径。
OpenClaw 平台：
- 访问OpenClaw官网，根据指引下载并安装OpenClaw客户端。
- 完成安装后，通常可以通过
openclaw命令在终端访问其CLI，或者通过本地Web界面（如http://localhost:7474）进行管理。
笔记库结构准备：
- 在你的Obsidian笔记库根目录下，手动创建一个名为
past-days的文件夹。这是归档的目标目录，确保名称完全一致。 - 确认你的每日笔记命名格式。本技能默认寻找格式为
MM-DD-YYYY DayOfWeek.md的文件（例如10-27-2024 Sunday.md）。这是Obsidian“每日笔记”核心插件的一种常见命名格式。请检查你的设置（设置 -> 核心插件 -> 每日笔记），确保生成的文件名与此匹配。
- 在你的Obsidian笔记库根目录下，手动创建一个名为
3.2 获取与安装技能
假设archive-daily-note技能已经发布在OpenClaw的技能市场或GitHub仓库中。
通过OpenClaw CLI安装：
# 假设技能在OpenClaw技能市场的ID是 meimakes/archive-daily-note openclaw skill install meimakes/archive-daily-note这个命令会将技能的定义文件（通常是
skill.yaml和脚本文件）下载到OpenClaw的技能目录下。或手动克隆仓库：
git clone https://github.com/meimakes/archive-daily-note.git cd archive-daily-note # 然后将整个目录复制到OpenClaw的技能目录，通常位于 ~/.openclaw/skills/ cp -r . ~/.openclaw/skills/archive-daily-note
3.3 技能配置与参数设定
安装后，最关键的一步是配置。技能需要知道你的Obsidian笔记库在哪里。通常，这通过修改技能的配置文件或设置环境变量来实现。
定位技能配置文件：进入技能目录，查找
skill.yaml或config.yaml文件。配置笔记库路径：在配置文件中，你需要设置一个变量来指向你的Obsidian笔记库绝对路径。
# 示例 skill.yaml 片段 name: archive-daily-note # ... 其他元数据 env: OBSIDIAN_VAULT_PATH: "/Users/YourUsername/Documents/MyObsidianVault"如果没有配置文件，你可能需要直接修改技能的执行脚本，将库路径硬编码或改为从环境变量读取。
注意：路径中不要使用
~符号，请使用绝对路径。如果你的库路径包含空格，请确保在脚本中被正确引用（通常用双引号包裹）。检查脚本逻辑：打开技能的主脚本文件（可能是
.sh或.py文件），理解其工作流程。一个健壮的脚本应该包含以下环节：- 读取配置的环境变量
OBSIDIAN_VAULT_PATH。 - 计算昨天的日期，并格式化成
MM-DD-YYYY DayOfWeek.md。 - 检查目标文件是否存在。
- 检查
past-days/文件夹是否存在。 - 执行
obsidian move --vault “$OBSIDIAN_VAULT_PATH” “yesterday_note.md” “past-days/”。 - 完善的错误处理和日志记录（成功、跳过、失败）。
- 读取配置的环境变量
3.4 定时任务（Cron）设置
本技能的核心价值在于自动化，因此定时触发是关键。
在OpenClaw中配置Cron触发器：
- 通过OpenClaw的Web界面或CLI，为
archive-daily-note技能添加一个触发器。 - 触发器类型选择
Cron。 - Cron表达式填入
5 0 * * *。这代表每天UTC时间的0点5分执行。你需要根据你的时区调整。例如，如果你在东八区，并且希望在北京时间每天凌晨0点5分执行，表达式应为5 16 * * *（UTC+8）。 - 执行模式务必选择
isolated（隔离）。这能确保任务在一个干净、独立的环境中运行，避免因你的终端会话环境变量不同而导致脚本执行失败。
- 通过OpenClaw的Web界面或CLI，为
为什么是00:05？这是一个经验值。将任务设定在午夜过后的几分钟，是为了确保当天的“每日笔记”已经由Obsidian创建（如果设置了自动创建），并且系统日期已经稳定地切换到了新的一天。这避免了在日期切换的瞬间运行可能导致的“找错文件”问题。
4. 脚本核心逻辑深度剖析与自定义
虽然可以直接使用现成技能，但理解其内部脚本逻辑有助于你调试问题或进行自定义（比如适应不同的笔记命名格式）。下面我们拆解一个典型的Shell脚本实现。
4.1 环境变量与路径检查
脚本开头必须进行严格的检查，这是健壮性的基石。
#!/bin/bash # 1. 加载配置，获取笔记库路径 VAULT_PATH="${OBSIDIAN_VAULT_PATH:-}" if [ -z "$VAULT_PATH" ]; then echo "错误：环境变量 OBSIDIAN_VAULT_PATH 未设置。" exit 1 fi # 2. 检查笔记库目录是否存在 if [ ! -d "$VAULT_PATH" ]; then echo "错误：笔记库路径不存在: $VAULT_PATH" exit 1 fi # 3. 检查目标归档目录是否存在，不存在则创建（可选，但建议提前手动创建） ARCHIVE_DIR="$VAULT_PATH/past-days" if [ ! -d "$ARCHIVE_DIR" ]; then echo “警告：归档目录 $ARCHIVE_DIR 不存在。技能需要此目录。” # 可以选择自动创建: mkdir -p “$ARCHIVE_DIR” exit 1 fi # 4. 检查 obsidian CLI 是否可用 if ! command -v obsidian &> /dev/null; then echo “错误：未找到 obsidian 命令。请确保Obsidian CLI已安装并配置在PATH中。” exit 1 fi4.2 日期计算与文件名生成
这是脚本的核心逻辑之一，需要处理跨年、跨月时的日期边界。
# 5. 计算昨天的日期 # 使用 GNU date 命令（Linux和macOS的date命令行为有差异，这里使用兼容性较好的方式） # 对于macOS，需要使用 `-v-1d` 参数 OS=$(uname) if [ “$OS” = “Darwin” ]; then # macOS YESTERDAY_FORMATTED=$(date -v-1d “+%m-%d-%Y %A.md”) elif [ “$OS” = “Linux” ]; then # Linux YESTERDAY_FORMATTED=$(date -d “yesterday” “+%m-%d-%Y %A.md”) else echo “不支持的操作系统: $OS” exit 1 fi # 生成的字符串示例: “10-27-2024 Sunday.md” SOURCE_FILE_PATH=“$VAULT_PATH/$YESTERDAY_FORMATTED”实操心得：日期计算是Shell脚本中常见的坑点。macOS的
date命令是BSD版本，而Linux通常是GNU版本，参数完全不同。上述写法做了兼容性判断。如果你确定只在一种系统上运行，可以简化。此外，确保你的系统 locale 设置正确，以免%A输出非英文的星期名。
4.3 幂等性检查与安全移动
“幂等性”意味着无论执行多少次，结果都一样。这是自动化任务的重要特性。
# 6. 检查源文件是否存在 if [ ! -f “$SOURCE_FILE_PATH” ]; then echo “信息：昨天的笔记不存在 ($YESTERDAY_FORMATTED)，可能未创建或已被归档。跳过。” exit 0 # 正常退出，不是错误 fi # 7. 检查文件是否已在目标目录（防止重复移动） TARGET_FILE_PATH=“$ARCHIVE_DIR/$YESTERDAY_FORMATTED” if [ -f “$TARGET_FILE_PATH” ]; then echo “信息：文件已在归档目录中，跳过。” exit 0 fi # 8. 执行安全的移动操作 echo “正在归档: $YESTERDAY_FORMATTED” cd “$VAULT_PATH” # 进入笔记库目录，有时Obsidian CLI需要在此上下文执行 if obsidian move “$YESTERDAY_FORMATTED” “past-days/”; then echo “成功：笔记已安全归档至 past-days/” else echo “错误：移动笔记时失败。obsidian命令返回非零状态。” exit 1 fi关键点解析：
obsidian move的参数：命令使用的是相对于笔记库根目录的路径。这就是为什么先执行cd “$VAULT_PATH”。第一个参数是源文件（相对路径），第二个参数是目标目录（相对路径）。- 错误处理：脚本通过
if...then...else判断obsidian move命令的返回值（$?）。返回0表示成功，非0表示失败。捕获并处理这个错误至关重要。
4.4 扩展：适配其他每日笔记格式
如果你的每日笔记命名格式不是MM-DD-YYYY DayOfWeek.md，你需要修改脚本中的日期格式化部分。例如，常见的格式还有：
YYYY-MM-DD.md(ISO格式)YYYY-MM-DD ddd.md(如2024-10-27 Sun.md)
你只需要调整date命令的格式化字符串即可。对于YYYY-MM-DD.md格式，将+%m-%d-%Y %A.md”改为+%Y-%m-%d.md”。
更灵活的做法：将日期格式作为环境变量传入，使技能更具通用性。
# 在skill.yaml中定义 env: OBSIDIAN_VAULT_PATH: “/path/to/vault” NOTE_DATE_FORMAT: “+%Y-%m-%d.md” # 或 “+%m-%d-%Y %A.md” # 在脚本中读取 DATE_FORMAT=“${NOTE_DATE_FORMAT:-‘+%m-%d-%Y %A.md’}” YESTERDAY_FORMATTED=$(date -v-1d “$DATE_FORMAT”) # macOS示例5. 故障排查与常见问题实录
即使配置正确，在实际运行中也可能遇到各种问题。以下是我在部署和使用过程中遇到的典型问题及解决方法。
5.1 Obsidian CLI 命令执行失败
问题现象：脚本报错“错误：移动笔记时失败。obsidian命令返回非零状态。”，或在终端手动运行obsidian move也失败。
排查步骤：
- 确认笔记库路径：在终端中，先
cd到你的笔记库绝对路径，再运行obsidian --help。如果提示找不到库，可能需要使用--vault参数显式指定。在脚本中，可以尝试将命令改为：obsidian --vault “$VAULT_PATH” move “$YESTERDAY_FORMATTED” “past-days/” - 检查Obsidian版本：过旧版本的Obsidian可能CLI功能不完善或存在Bug。尝试更新Obsidian到最新稳定版。
- 权限问题：确保运行OpenClaw服务或cron任务的用户有权限读取和写入笔记库目录及所有文件。
- 查看详细日志：Obsidian CLI可能输出更详细的错误信息到标准错误。可以临时修改脚本，捕获错误输出：
if ! output=$(obsidian move “$YESTERDAY_FORMATTED” “past-days/” 2>&1); then echo “obsidian命令失败，输出: $output” exit 1 fi
5.2 笔记文件未找到，但确认已创建
问题现象：脚本日志显示“昨天的笔记不存在，跳过”，但你确认昨天的每日笔记已经创建。
排查步骤：
- 时区与cron表达式：这是最常见的原因。你的服务器或电脑的系统时区是UTC，而cron表达式
5 0 * * *是在UTC时间0点5分运行。如果你在东八区，此时是北京时间早上8点05分，昨天的笔记当然已经创建。问题在于，你期望的是在北京时间凌晨归档。你需要调整cron表达式，或者更简单的方法：在计算“昨天”的日期时，将时区考虑进去。- 方案一（推荐）：在脚本中使用带时区的日期计算。GNU date可以指定时区：
# 假设你希望基于北京时间 (CST, UTC+8) 计算“昨天” YESTERDAY_FORMATTED=$(TZ=‘Asia/Shanghai’ date -d ‘yesterday’ ‘+%m-%d-%Y %A.md’) - 方案二：调整OpenClaw cron触发器的表达式。例如，在北京时间每天0点5分运行，对应UTC时间是前一天的16点05分，表达式应为
5 16 * * *。
- 方案一（推荐）：在脚本中使用带时区的日期计算。GNU date可以指定时区：
- 文件名格式不匹配：双击检查你的Obsidian每日笔记插件设置，确认生成的文件名格式与脚本中
date命令生成的格式完全一致，包括大小写、连字符、空格和.md后缀。一个空格或大小写的差异都会导致匹配失败。 - 文件不在根目录：脚本默认在笔记库根目录查找。如果你的每日笔记被保存到了其他文件夹（如
Daily Notes/），你需要修改脚本中的SOURCE_FILE_PATH，或者在Obsidian设置中调整每日笔记的保存位置。
5.3 链接更新似乎不完整
问题现象：笔记被移动后，大部分链接正常，但个别链接显示断裂。
排查步骤：
- 等待索引完成：Obsidian在移动文件后，需要时间重新索引和更新链接。这不是立即完成的。可以尝试在Obsidian中按
Ctrl+R(Cmd+R on Mac) 强制重新加载笔记库并重建索引。 - 检查链接格式：确保断裂的链接使用的是标准的
[[文件名]]或[[文件名#标题]]格式。如果链接包含别名，如[[显示文本|实际文件名]]，Obsidian CLI同样能正确处理。 - 手动测试：在笔记库目录下，手动执行一次
obsidian move命令，观察是否有错误输出。有时，目标文件名中包含特殊字符可能导致问题。 - 检查反向链接：打开被移动的旧笔记，查看其“反向链接”面板。如果面板为空，但你认为应该有链接，说明索引可能有问题。尝试关闭并重新打开Obsidian，或者使用“重建索引”功能（在设置 -> 文件与链接中）。
5.4 OpenClaw任务未按计划执行
问题现象：配置了cron触发器，但任务从未运行或运行时间不对。
排查步骤：
- 检查OpenClaw服务状态：确保OpenClaw的后台服务（或守护进程）正在运行。在终端运行
openclaw status或查看系统服务状态。 - 查看OpenClaw日志：OpenClaw通常会有应用日志，记录任务的触发和执行情况。查看日志文件（位置取决于安装方式），寻找关于
archive-daily-note技能的执行记录或错误信息。 - 验证Cron表达式：使用在线的Cron表达式验证工具（如crontab.guru），确认你设置的表达式确实会在你期望的时间点触发。
- 检查“隔离”模式：确认触发器配置的执行模式是
isolated。在某些OpenClaw版本中，非隔离模式可能因为环境问题导致脚本无法找到obsidian命令。
5.5 归档后，新日期的笔记链接指向了归档目录？
问题现象：10月28日，我创建了10-28-2024 Monday.md，并在其中写入了[[10-27-2024 Sunday]]。脚本在29日凌晨将10-27-2024 Sunday.md移入past-days/。之后，我点击10-28-2024 Monday.md中的这个链接，它正确地打开了past-days/10-27-2024 Sunday.md。这是正常且正确的行为。
原理澄清：这正是obsidian move的强大之处。它更新的不是链接的“文本”，而是链接背后的“目标地址”。在你的笔记10-28-2024 Monday.md中，看到的文本依然是[[10-27-2024 Sunday]]，但Obsidian内部已经将这个链接解析为指向past-days/10-27-2024 Sunday.md文件。所以点击后能正确跳转。你无需手动修改任何已有笔记的内容。
6. 高级技巧与扩展思路
当基础功能稳定运行后，你可以考虑以下优化和扩展，让这个自动化流程更贴合你的个性化需求。
6.1 添加执行日志与通知
默认技能可能是“静默”的，但了解它是否正常运行让人更安心。你可以修改脚本，添加日志功能和简单通知。
追加运行日志：
LOG_FILE=“$VAULT_PATH/archive.log” exec >> “$LOG_FILE” 2>&1 # 将脚本所有输出重定向到日志文件 echo “=== $(date) ===" # ... 原有的脚本逻辑 ...这样，每次运行都会在笔记库根目录的
archive.log文件中追加一条记录，包含时间、执行结果或错误信息。集成通知：结合OpenClaw可能支持的通知技能（如发送HTTP webhook），或者使用系统命令如
osascript(macOS) 发送桌面通知，curl调用通知服务如Pushover、Gotify等，在任务失败时及时告警。
6.2 处理周记、月记或模板
这个模式可以推广到其他定期笔记。
- 周记归档：你可以写一个类似的技能，在每周一凌晨，将上一周的周记文件（如
2024-W43.md）从weekly/文件夹移动到weekly/archive/。 - 模板文件：如果你有定期更新的模板文件，也可以用类似方式管理版本。关键在于都使用
obsidian move来维护链接。
6.3 与Git版本控制结合
如果你的笔记库使用Git进行版本控制，自动移动文件会改变工作区状态。一个良好的实践是在归档脚本执行后，自动提交这次变更。
# 在脚本成功移动文件后，添加以下命令 cd “$VAULT_PATH” git add . git commit -m “Auto-archive: Moved $YESTERDAY_FORMATTED to past-days/” # 可选：git push origin main重要警告：自动化Git操作需谨慎。确保你了解Git，并且脚本运行在正确的身份验证环境下（如配置了SSH密钥或持久化凭证）。最好先在测试库中尝试。
6.4 创建“归档索引”笔记
为了让归档的笔记更容易被浏览，可以在每次归档后，自动更新一个“归档索引”笔记。这个笔记可以是一个简单的列表，包含所有已归档日记的链接。
脚本可以在成功移动文件后，向past-days/Index.md文件追加一行：
echo “- [[$YESTERDAY_FORMATTED]]” >> “$ARCHIVE_DIR/Index.md”这样，你就有了一个按时间倒序排列的归档目录，方便回顾。
我个人在实际使用中，发现将自动化与手动整理结合是最好的。archive-daily-note解决了最繁琐、最容易出错的“物理移动与链接更新”问题，让我敢于制定更复杂的笔记组织结构。而像创建索引、Git提交这类“增值”操作，可以根据个人工作流决定是否自动化。核心是让工具服务于你，而不是增加维护负担。这个技能运行数月以来，我的笔记库根目录始终保持清爽，而所有历史记录都能通过链接或搜索瞬间获取，真正实现了“既整洁，又互联”。