CangLu Knowledge Base

速查清单

6分钟阅读

速查清单

learn 索引 | 主题索引

按帕累托——用 20% 的篇幅覆盖 80% 的实际使用场景。

1. 最短上手路径

  1. 自托管：docker compose up -d（需 Khoj 主体 + Postgres，可选 Searxng 增强搜索）
  2. 配 LLM provider：Anthropic / OpenAI / DeepSeek 任一 API Key
  3. 配推送：Resend API Key（推荐，每月 100 封免费）或自有 SMTP
  4. 进 Web UI 对话框，直接用自然语言创建第一个任务
  5. 在”Automations”页面看任务列表 / 编辑 / 删除

2. 对话创建任务的话术模板

场景直接照抄说一遍
每天主题简报每天早上 9 点搜一下 [主题] 最新进展，中文总结后发邮件给我
Notion 待办整理每天 18 点把我 Notion 里 tag=今天 的待办整理一份发邮件给我
GitHub 趋势每天 9 点搜 GitHub Trending 上 [语言/标签] 类前 10，按热度排序发我
论文追踪每周一 9 点搜过去 7 天 arXiv 上 [关键词] 的新论文，挑 3 篇
行业新闻每天 8 点搜 [公司名] 官方博客和发布说明，有更新就发我，没有就不发
复杂研究每周日 10 点深度研究 [主题]，列出现状、争议、值得关注的人

LLM 会自己把这些话转成 cron + 内部 query。

3. 常用 cron 速查（手工调试 API 时用）

含义cron
每天早 9 点0 9 * * *
每天 18 点0 18 * * *
每周一早 9 点0 9 * * 1
每月 1 号 9 点0 9 1 * *
工作日每天 9 点0 9 * * 1-5

⚠️ 分钟字段必须是数字，*/5 * * * * 这类不被允许（Khoj 硬限制）。最细粒度=小时。

4. 推送渠道配置速查

渠道配置位置备注
Resend 邮件env RESEND_API_KEY最推荐，简单稳定
自有 SMTP 邮件env 配 SMTP host/user/pass可走腾讯企业邮 / 163
WhatsAppenv 配 Twilio 凭证国内不稳定
推送到飞书/钉钉/企微不直接支持走”Khoj→中转邮箱→AP 中继”二跳

5. 11 个内置工具默认行为速查

关键词触发主要工具备注
”搜一下”、“查最新”、“现在情况”Online + ReadWebpage走互联网
”深度研究”、“全面调研”Research多轮迭代，慢但全
”我笔记里”、“我 Notion 里”Notes提前接入私域知识
”算一下”、“统计”、“画个图”Code (Python)沙箱内执行
”在网页上点一下”、“截图”Operator浏览器自动化

任务到点时 AI 自动选；无需在 query 里手工指定。

6. 关键限制清单

  • ❌ 分钟级触发（最细到小时）
  • ❌ 同任务 6 小时内不重复跑
  • ❌ 不监听邮箱新邮件（用 Dify 也不行，要 ActivePieces piece-imap）
  • ❌ 不接外部 webhook 触发（要 ActivePieces）
  • ❌ 不直推国内 IM 群（要中转）
  • ⚠️ Operator（操作浏览器）依赖额外组件，首启可能要装 Playwright

7. 排障速查

现象可能原因
自动化任务”成功”但没收到邮件should_notify 判断”不值得通知”；查 Khoj 日志 Decided to not notify ... reason: ...
创建任务报”Invalid crontime”分钟位用了 * 或 */N；改成具体数字
创建报”Unable to create automation”同标题任务已存在，先删旧的
自动化没按时跑检查 APScheduler 是否在跑、Khoj 进程是否常驻、TZ 时区是否正确
邮件内容很丑 / 直接是 raw jsonformat_automation_response 失败回落原文；检查 LLM provider key

8. 何时该选 Khoj，何时不该

✅ 选 Khoj，如果：

  • 主要场景是”按时跑 + AI 主动查 + 推 newsletter”
  • 不在意推送渠道仅限邮件
  • 数据来源在公网 / Notion / 自己的文档库

❌ 不选 Khoj，如果：

  • 必须监听邮箱新邮件 → 用 ActivePieces
  • 必须接外部 webhook → 用 ActivePieces
  • 必须实时（< 1 小时）触发 → 用 ActivePieces
  • 必须直推飞书/微信群 → 用 ActivePieces / OpenClaw

9. 与本地工具组合的最小增量方案

flowchart TD
    Khoj[Khoj 自动化] -->|发邮件到| Inbox[中转邮箱]
    Inbox -->|piece-imap 监听| AP[ActivePieces]
    AP -->|HTTP webhook| FS[飞书/钉钉/企微群]
  • 这是把 Khoj”对话即配”和 AP”国内 IM 输出”组合起来的最便宜路径
  • 中转邮箱可用 Khoj 邮件服务的同一个账号，AP 那条 flow 配一个 IMAP trigger 即可
  • 详细 piece 配置参考 ActivePieces 部署文档（待后续补）

关系图谱