Obsidian Inbox Pipeline — Obsidian Inbox 流水线

Obsidian Inbox 流水线

打通外部信息源与 Obsidian 知识库的自动化流水线。安装后配置好环境变量，即可持续将资讯日报、文章、帖子等结构化沉淀到 Obsidian，无需手动整理。

核心脚本 脚本 功能 关键参数 capture.py 写入单条笔记到 inbox --type, --title, --source, --tags, --content 查询.py 搜索知识库（索引 + 正文） --查询, --type, --tags, --limit review.py 生成 inbox 整理报告 --dry-运行（预览） scripts/dAIly_流水线.sh 三合一流水线参考 radar 类型、名称、分类、来源 快速开始

• 安装依赖

# 克隆 技能 到本地 ClawHub 安装 obsidian-inbox-流水线

# 复制环境变量模板 cp references/.env.example .env # 编辑 .env，填入真实路径和凭证

• 配置环境变量

# .env 文件示例 OBSIDIAN_VAULT_PATH=/Users/you/obsidian/MyKnowledge OBSIDIAN_INBOX_DIR=inbox TELEGRAM_机器人_令牌=123456:ABC-xxx TELEGRAM_CHAT_ID=987654321 FEISHU_应用_ID=命令行工具_xxx FEISHU_应用_SECRET=xxx

⚠️ 安全提醒：.env 文件请加入 .gitignore，不要提交到公开仓库。脚本从不硬编码任何凭证。

• 写入一条笔记（测试）

导出 OBSIDIAN_VAULT_PATH=/path/to/vault

python3 capture.py \ --type capture \ --title "测试笔记" \ --source "手动测试" \ --tags "[测试]" \ --content "这是正文内容，可以是任何文本..."

• 搜索知识库

导出 OBSIDIAN_VAULT_PATH=/path/to/vault

# 搜索标题和摘要 python3 查询.py --查询 "OpenClaw" --limit 5

# 只看 knowledge 类型 python3 查询.py --查询 "AI 代理" --type knowledge --limit 5

# 搜索正文内容（需要 obsidian-命令行工具） python3 查询.py --查询 "OpenClaw" --include-content

• 生成 Inbox 整理报告

导出 OBSIDIAN_VAULT_PATH=/path/to/vault

# 预览（不写文件） python3 review.py --dry-运行

# 正式生成（写入 notes/_review/inbox-review-YYYY-MM-DD.md） python3 review.py

• 定时自动运行（cron）

# 每天 7:00 自动跑（来源和 cron 触发自行配置） 0 7 cd /path/to/技能 && \ OBSIDIAN_VAULT_PATH=/path/to/vault \ TELEGRAM_机器人_令牌=xxx \ TELEGRAM_CHAT_ID=xxx \ bash scripts/dAIly_流水线.sh "AI-radar" "AI 资讯雷达" "AI" "🤖" "AI 资讯" \ >> /var/记录/obsidian_流水线.记录 2>&1

流水线架构 外部来源（RSS / API / 爬虫 / 手动） │ ▼ ┌─────────────────────┐ │ 生成原始 Markdown │ │ (日报/文章/帖子) │ └────────┬────────────┘ │ ▼ ┌─────────────────────┐ │ capture.py │◄── 写入 Obsidian inbox │ (结构化模板写入) │ （type / tags / source / TL;DR） └────────┬────────────┘ │ ▼ ┌─────────────────────┐ │ rebuild_索引.mjs │◄── 重建 .AI/索引.json │ (Obsidian 官方脚本) │ （支持 查询.py 搜索） └────────┬────────────┘ │ ▼ ┌─────────────────────┐ │ 查询.py / review │◄── 知识库检索 / inbox 整理 │ │ └─────────────────────┘

可选通知渠道（均走环境变量，不硬编码）： ├── Telegram 机器人（需 TELEGRAM_机器人_令牌） └── 飞书自建应用（需 FEISHU_应用_ID / FEISHU_应用_SECRET）

frontmatter 标准格式

写入的每条笔记使用统一 frontmatter，便于后续检索和分类：

---

type: capture # capture | dAIly-报告 | knowledge 创建d: 2026-03-21 # 自动时间戳 tags: [AI, 日报] # 自定义标签 source: AI 资讯雷达 # 来源 状态: inbox # inbox → knowledge → _归档

---

配合 AI 雷达使用

配合 AI-radar、economy-radar、travel-radar 等 技能 使用时：

# 三合一每日自动运行（配合 cron） 0 7 \ source /path/to/.env && \ bash /path/to/obsidian-inbox-流水线/scripts/dAIly_流水线.sh \ "AI-radar" "AI 资讯雷达" "AI" "🤖" "AI 资讯" && \ bash /path/to/obsidian-inbox-流水线/scripts/dAIly_流水线.sh \ "economy-radar" "经济雷达" "经济" "📊" "经济资讯" && \ bash /path/to/obsidian-inbox-流水线/scripts/dAIly_流水线.sh \ "travel-radar" "旅游雷达" "旅游" "✈️" "旅游资讯"

故障排查 问题 解决方案 OBSIDIAN_VAULT_PATH 报错 确保环境变量已设置，或安装 obsidian-命令行工具 inbox 写入了但 查询 搜不到 运行 node /path/to/vault/scripts/rebuild_索引.mjs 重建索引 Telegram 推送失败 确认 机器人 令牌 和 Chat ID 正确，机器人 已被用户发起过对话 飞书推送失败 检查 应用_id / 应用_secret 权限（需要发消息权限） 依赖 Python ≥ 3.8 obsidian-命令行工具（可选，vault 路径自动发现） node（可选，索引重建脚本） Telegram 机器人 令牌（可选，通知推送） 飞书自建应用凭证（可选，通知推送）