跳转到内容
OMem

跑 setup 向导

已经 装好了 OMem、想把它接到你的数据上?看这一页。omem setup 是个一次性的向导——跑一遍、回答几个问题,OMem 就配置好了。这一页会把每一步都讲到,省得你中途冒出意外,尤其是 macOS 权限那一段。

启动向导

Section titled “启动向导”
Terminal window
omem setup

它会一步步引导你走完——几乎每个问题,你直接回车用默认值就行。在你跑完之前,后台不会摄入任何东西;向导做的,只是把你的配置写下来。

向导会问些什么

Section titled “向导会问些什么”

整个流程就是一小串步骤。下面逐一说说每一步替你定了什么——默认值用粗体标出。

  1. wiki 放在哪。 OMem 把你的记忆写成一个装满 Markdown 文件的文件夹。可以选默认路径(~/omem/wiki)、一个现成的 Obsidian vault,或者你自己指定的路径。(以后想挪地方,用 omem wiki move。)输出语言也在这一步选:auto(每页跟着它源文档的语言走),或者强制走 zh / en。

  2. 定时摄入。 选一个间隔(比如每 15 分钟),或者干脆跳过。这里要留神:这一步只是把间隔记进配置,它并不会真把定时装上。向导写的是配置;真正去注册那个定时器,得靠之后你另跑的一条 omem install(见下面的提示框)。详见 定时。

  3. 搜索索引。 内置的 fts5(关键词搜索、快、零配置)拿来就能用,不过我们更建议你把 qmd 插件打开——它多了语义搜索和跨语言搜索,在真实工作上好用得多。qmd 要装一个单独的二进制(基于 Node),而且会在你第一次跑 omem ingest 或 omem query 时,顺手把 ~2.2 GB 的本地模型拉下来——这是一次性的开销,会让头一次跑慢一些。条件允许就上 qmd;fts5 则是那个稳稳兜底的选择。详见 检索。

  4. LLM + 视觉 provider。 用哪个模型来整理页面、描述图片。见下面 怎么选 LLM provider。

  5. 每一类工作——文件、邮件、日历、Loop 笔记。每一类默认都是关着的;你把想要的逐个打开,OMem 会帮你把每一类配好(哪几个文件夹、哪几个邮件账号、哪几个日历)。macOS 要权限,也是在这一步问你——见 授予访问权限。

  6. 浏览器会话(只有开了 Loop 才会有)——一次性登录,好让 OMem 能去取你的 Teams Loop 页面。

全部走完,OMem 就把你的配置写下来(原子写入,顺带给旧配置留个备份)。这会儿还什么都没摄入呢——那是 下一页 的事。

怎么选 LLM provider

Section titled “怎么选 LLM provider”

OMem 自己不带模型——是你把它指向某一个。整理器(文本 → wiki 页)和视觉模型(图片 → 描述)甚至可以分别用不同的 provider。四个选择:

anthropic-oauth——用你的 Claude Pro / Max 订阅。不用粘 API key;登录由向导搞定。如果你本来就在为 Claude 付费,这是最省事的一条路。这也是默认值。

这些以后都能用 omem config set 改——见 LLM provider 怎么配。

授予 macOS 访问权限

Section titled “授予 macOS 访问权限”

这一步值得花点心思弄懂,因为 macOS 的权限有个绕人的地方,不少人都在这儿栽过。

要读你的邮件——以及在 macOS 26+ 上读你的日历——OMem 需要完全磁盘访问权限(Full Disk Access,FDA)。这个 FDA,macOS 从不自动弹窗问你要,得你手动给。你开这几类时,向导会把你领到地方;你也可以随时自己触发:

Terminal window
omem setup --grant-tcc

它会打开 系统设置 → 隐私与安全性 → 完全磁盘访问权限,并在 Finder 里把 omem 这个二进制亮出来,方便你把它拖进去(或者直接打开它的开关)。

每一类各需要什么:

  • 邮件——完全磁盘访问权限(就是上面那个手动给的),所有 macOS 版本都要。
  • 日历——旧版 macOS 上是一个普通的日历弹窗;到了 macOS 26+ 就要完全磁盘访问权限了(日历数据库挪进了沙箱容器,如今跟邮件一样被卡着)。版本细节见 摄入日历。
  • 文件 / Loop——正常弹窗(或者压根不用什么特殊权限)。
只重跑某一步

只想改一样东西,不必把整个向导重走一遍。omem setup --kind mail 只重跑邮件那一步;omem setup --llm 直接跳到 provider 那一步;omem setup --browser 重做 Loop 的登录。新加了邮件账号、或者刚换了 LLM provider,用这几个就很顺手。

接下来

Section titled “接下来”

配好了——这就看它干活去。