openwiki-wiki/sources/OpenWiki速查手册.md

OpenWiki 速查手册 (Robin 一次聊清, 直接拿来用)

目的: 这份文档是 2026-07-27 一天 6 次对话的完整沉淀. 之后你跟任何 agent / 同事 / 客户 / 老板 提 OpenWiki, 直接把这份文档发过去, 不需要重新讲一遍.

本文件不属于 OpenWiki wiki (那是给 MiniMax code / Hermes cross-agent 用的), 这份是给你 Robin 一个人的速查手册, 跟 Robin 笔记本里其他笔记一样.

---

1. OpenWiki 是什么? (一句话)

OpenWiki = 把你 Robin 用的 7 个工具 (HN + Tavily + git-repo + NocoDB + SeaFile + Wiki.js + RAGFlow) 的真实状态, 自动汇总到 1 个 Gitea 公开 wiki, 你手机/台式机/任何浏览器都能 30 秒看全局.

不是: Notion 替代 / Obsidian 替代 / ChatGPT memory / 文档生成器. 是给 AI agent 看的本地 markdown 索引, 你手机/桌面浏览器能直接读.

---

2. 现在能用 (2026-07-27 真激活后状态)

部件	状态	频率
Gitea wiki 公网	✅ http://10.10.10.254:3080/Robin/openwiki-wiki	实时
Cron 1 (02:00) update.sh	✅ HN + Tavily + git-repo + M3 agent	每晚
Cron 2 (02:30) update-sources.sh	✅ NocoDB / SeaFile / Wiki.js / RAGFlow (5 文件)	每晚
Cron 3 (*/30) update-feishu-mail.sh	⏸️ 已布, 缺 IMAP 授权码	等飞书 IMAP
18 RAGFlow KB / 32,709 docs	✅ 已拉 401 sample 进 wiki	02:30
桌面 embedding 服务 (bge-m3 + nomic-embed)	❌ 7/17 起宕	你 IT 决定何时起
废弃库 15922 docs (RAGFlow)	🚫 你明确不要清, 永久不动	永久
飞书邮箱 IMAP	⏸️ 飞书 IMAP/SMTP 需 IT 启用, 你拿到 16 位授权码我立刻接	等

---

3. 你 Robin 怎么用 OpenWiki (3 步, 30 秒)

1. 打开浏览器 (你笔记本/手机) → http://10.10.10.254:3080/Robin/openwiki-wiki
2. 看 9 个文件 (按这个顺序最有信息密度):
   • themes.md (4 行 Robin 工作相关主题) — 30 秒看 "我关注啥"
   • sources/web-search.md (Tavily 拉的 Nature/业界新闻) — 30 秒看 "昨晚行业信号"
   • sources/hackernews.md (HN 跟你业务相关) — 30 秒看 "Hacker News 提了啥"
   • sources/git-repo.md (Obsidian vault 状态) — 30 秒看 "我 Obsidian 最近变了啥"
   • sources/nocodb.md (13 文献库 + 6604 records) — 30 秒看 "我 NocoDB 长啥样"
   • sources/seafile.md (6 Repo / 77 GB) — 30 秒看 "我 SeaFile 长啥样"
   • sources/wikijs.md (≥1633 pages) — 30 秒看 "我 Wiki.js 长啥样"
   • sources/ragflow.md (18 KB / 32,709 docs) — 30 秒看 "我 RAGFlow 长啥样"
   • sources/ragflow-documents.md (401 doc samples) — 2-3 分钟看 "我 RAGFlow 每 KB 实际有啥"
   • sources/feishu-mail.md (空白) — 等你 IT 给 IMAP 授权码才激活
3. 判断 + 决策 — 你自己用 wiki 数据做产品经理决策. 例子:
   • 客户问 "Cellink 库有多少肝类器官 paper" → 你看 sources/ragflow-documents.md 2 分钟
   • 老板问 "本周 OpenWiki 干了啥" → 你看 git log + themes.md 5 分钟
   • 同事问 "9X Bio 跟我谈过啥" → 你看 commitments.md 30 秒

---

4. 你 Robin 跟任何 agent / 人聊 OpenWiki 时, 你能用这 5 句话讲清楚

"OpenWiki = LangChain 7/10 开源的'personal brain' 框架. 它有个 CLI 跑 cron, 自动把 Gmail/HN/Tavily/git-repo/Notion 6 种 connector 跟 NocoDB/SeaFile/Wiki.js/RAGFlow 4 种内部子系统的状态, 汇总成 1 个本地 markdown wiki, 推 Gitea. 我自己写的 cron 脚本补 RAGFlow 4 子系统的真实计数 + 401 个 doc sample. 目前覆盖 18 个 RAGFlow KB / 32,709 docs / 116,254 chunks. 飞书邮箱还没接, 因为企业邮箱 IMAP 需 IT 启用. 桌面 embedding 服务挂了, KB vector retrieval 不可用, 但 metadata 还可查."

---

5. 你 Robin 真正"动手" 操作 (用你终端 + 1-2 行命令)

5.1 看 wiki 公网是否活

curl -I http://10.10.10.254:3080/Robin/openwiki-wiki

5.2 看 cron 是否今晚跑

tail -20 ~/.openwiki/logs/cron-$(date +%Y%m%d).log
tail -20 ~/.openwiki/logs/sources-sync-$(date +%Y%m%d).log
ls -la ~/.openwiki/logs/

5.3 看 wiki 上次 commit

cd /home/ldw/.openwiki/wiki
git log --oneline -10
git status

5.4 手动 trigger cron 1 (02:00 那条) 跑一次 (不进 agent loop, 5 min)

bash /home/ldw/.local/bin/openwiki-update.sh

5.5 手动 trigger cron 2 (02:30 那条) 跑一次 (4 subsystem, 1 min)

bash /home/ldw/.local/bin/openwiki-update-sources.sh

5.6 手动 trigger cron 3 (30 分钟那条) — 等你 IT 给 IMAP 授权码后才生效

bash /home/ldw/.local/bin/openwiki-update-feishu-mail.sh

5.7 看 crontab

crontab -l

5.8 看 RAGFlow 18 KB / 32,709 docs 真实数据

# 看 wiki sources/ragflow.md
head -30 /home/ldw/.openwiki/wiki/sources/ragflow.md

# 看 wiki sources/ragflow-documents.md (401 doc samples)
head -50 /home/ldw/.openwiki/wiki/sources/ragflow-documents.md

# 直接查 RAGFlow
TOKEN="ragflow-FiKwwHC1Lzw65IA83Funb3a3VF8-D8AC9nw7zYtBbFU"
curl -s -H "Authorization: Bearer $TOKEN" \
  "http://10.10.10.254:9980/api/v1/datasets?page=1&page_size=20" | python3 -c "
import json, sys
d = json.load(sys.stdin, strict=False)
for x in d['data']:
    print(f\"{x['name']:30s} {x['id']:35s} docs={x['document_count']:>5d} chunks={x['chunk_count']:>6d}\")
"

5.9 你不记得某个命令时

# 看 cron 脚本本身 (self-documenting)
cat /home/ldw/.local/bin/openwiki-update.sh | head -30
cat /home/ldw/.local/bin/openwiki-update-sources.sh | head -30

---

6. 你 Robin 不要 做的 5 件事 (跟 OpenWiki 相关的禁区)

1. ❌ 不清废弃库 15922 docs (你 7-27 明确说不要清, 永久不动)
2. ❌ 不跑 curl -X DELETE /api/v1/datasets/... 类代码 (即使 KB "看着该清")
3. ❌ 不让 agent 改 ~/.openwiki_env.sh 里的 RAGFlow/SeaFile/TAVILY/飞书 IMAP token (这些是 secret, 改了就连不上)
4. ❌ 不"重置" wiki (wiki 累积 7-16 至今的 git 历史, 重置就全丢)
5. ❌ 不用 Gmail 路径去接飞书邮箱 (你客户邮箱是飞书不是 Gmail, 路径完全不同)

---

7. 你 Robin 7-27 一次性解决的真事 (回顾)

问题	我做的	状态
7 天 0 产物 (cron PATH 错)	修 PATH + 加 TAVILY key auto-load	✅ 真跑通
Wiki.js 47 vs 1000+	5-orderBy union + max ID 1633	✅ 真相写 wiki
RAGFlow 14 KB vs 真 18 KB / 32,709 docs	直接 token + list_datasets API	✅ 401 doc sample 入 wiki
飞书邮箱整合	准备 IMAP polling 脚本 (12 min 实现)	⏸️ 等 IT 授权码
4 子系统自动同步 (NocoDB/SeaFile/Wiki.js/RAGFlow)	update-sources.sh + crontab 02:30	✅ 全跑
桌面 webUI 笔记本能进	portproxy + 防火墙 + 任务计划 (7-16)	✅ 跑通
跨 agent 共享 wiki	Gitea public repo http://10.10.10.254:3080/Robin/openwiki-wiki	✅
飞书邮箱 不是 Gmail	memory 永久记录	✅ 未来不会推错
废弃库 15922 docs 不动	memory 永久记录	✅ 永久铁律

---

8. 你 Robin 未来 可以让 OpenWiki 升级的 4 个方向 (按价值)

优先级	方向	价值	你要做的
1	飞书邮箱 IMAP 集成	⭐⭐⭐⭐⭐ 客户邮件→wiki 自动	IT 给授权码
2	桌面 embedding 服务起来 (bge-m3 + nomic-embed)	⭐⭐⭐⭐ RAGFlow KB vector retrieval 恢复	启动 7997/8090/11434 服务
3	方式 4 MCP real query (OpenWiki agent 实时问 RAGFlow)	⭐⭐⭐⭐ 跨 KB cross-query	桌面服务起来后我做
4	跟 NocoDB table 自动 sync (13 文献库 → wiki)	⭐⭐⭐ 元数据可查	我现在能做, 但需你拍板

---

9. 你 Robin 跟其他 agent 交接时, 这份文档怎么用

A. 你换 / 升级 agent (你切到 MiniMax code 桌面)

发这条:

"看 /mnt/c/Users/20864/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md (或 D 盘这个路径). 这是我 OpenWiki 全套配置 + 7-27 实测状态. 你读完就能用."

B. 同事 / 老板问 "OpenWiki 是什么"

直接发这份手册. 30 秒读完, 同事能 catch up.

C. 你自己 1 个月后忘了

打开 ~/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md (或你 vault 同名文件) — 30 秒全回忆.

D. 你 6 个月后想升级 (飞书邮箱接好 / 桌面服务起)

看第 8 段, 4 个升级方向已经按价值排序. 你告诉 agent "做 1" / "做 2" 即可.

---

10. 你 Robin 这份文档本身怎么"记录"

放哪	路径	用途
Obsidian vault (主版)	/mnt/c/Users/20864/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md	跟 Obsidian 同步, git 推 Gitea, 跨设备
OpenWiki wiki sources (副本, 公开)	后续如果想让 MiniMax code / Hermes 看到, 拷一份 ~/.openwiki/wiki/sources/OpenWiki速查手册.md	让 agent 也能读
Gitea wiki (直接看)	http://10.10.10.254:3080/Robin/openwiki-wiki (commit + push 后)	任何浏览器访问

---

11. 你 Robin 7-27 的"vibe" (跟 agent 聊天的 4 个习惯, 跟 OpenWiki 一起沉淀)

• 你对 "47" 数字不信 — 你要实测. → OpenWiki 探针用 GraphQL union, 不盲信
• 你不喜欢 "agent 凭印象" — 你要带证据 + URL. → OpenWiki docs 真实下载, 不虚拟
• 你明确 "废弃库不要清" — 你不会给"我帮你写个清理脚本" 留口. → memory 铁律, 永久
• 你对 "OpenWiki 怎么联 RAGFlow" 等战略问题想清楚再选 — 你不要"4 个选项让你选". → 给唯一推荐 + 理由, 你拍板

下次你 Robin 跟任何 agent (包括我) 说"OpenWiki" 时 — 你直接说"看速查手册第 X 段" — 30 秒内任何 agent 都能 catch up.

---

Robin 2026-07-27: 这份文档是 1 个小时 6 个转折的全部沉淀. 之后你 / 任何 agent / 任何同事, 拿这份文档, 直接用, 不用每次聊.

下次我 (或别的 agent) 跟你重提 OpenWiki 时, 你第一句说:

"看 ~/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md 速查手册第 X 段, 你现在该做什么?"

—— 零重聊.