快速安装
使用安装器通过 Docker 启动 Lore，或把客户端连接到已有的 Lore 服务器。
如果你想最快得到一个可用的 Lore 服务器和本机 Agent 集成，使用安装器。
前置条件
- Docker 并带 Compose 插件（
docker compose）。macOS 上 Docker Desktop 已包含两者。Linux 上需安装 Docker Engine 和docker compose插件。 - 至少一个要连接的 Agent 运行时（Claude Code、Codex、Pi、OpenClaw、Hermes 或 OpenCode）。OpenCode 预发布集成已用 OpenCode 1.18.3 验证。
- 一个 OpenAI 兼容的 API key 用于 embedding（例如 OpenAI、DeepSeek 或本地服务）。安装完成后在
/setup中配置。没有它，语义召回和 Dream 无法工作。
运行安装器
默认安装会用 Docker Compose 启动 Lore，写入本机客户端配置，并配置这台机器上支持的 Agent 渠道。
中文安装器：
安装器做了什么
- 从 Lore 仓库下载
docker-compose.yml和.env模板。 - 启动 Lore 服务器、PostgreSQL 和 Redis 容器。
- 等待服务器健康检查通过。
- 创建
~/.lore/config.json，写入服务器 URL 和 token。 - 为使用 MCP/hooks 的选中 Agent 渠道安装对应配置。
- 对 OpenCode，下载
lore-opencode.zip，并原子安装受管理的原生插件到~/.config/opencode/plugins/lore-memory.js。 - 安装轻量生命周期转发器；boot guidance 和 recall 格式由 Lore server 返回。
OpenCode 标准安装不会配置 MCP。OpenCode 使用精确命名的原生 lore_* 工具；通用 /api/mcp 仅作为手动兜底。
原生插件会在运行时抑制重复 Lore MCP 导入。安装器还会处理 Claude 兼容层更早载入生命周期 hook 的重复路径：仅当检测到已有且可安全解析的用户级 oh-my-openagent.json[c] 或旧版 oh-my-opencode.json[c] 时，才设置 claude_code.plugins_override["lore@lore"] = false。该操作保留所有无关字段和 JSONC 注释，在 ~/.lore/ 中记录原值，并在卸载 OpenCode 集成时恢复原值。
Lore 不会修改 Claude Code 文件，也不会创建 oh-my-openagent 配置文件；如果现有第三方配置不安全或无法解析，安装器会警告并跳过兼容修改。只有明确需要让旧版 MCP 与原生插件并存时，才在运行安装器和启动 OpenCode 时都设置 LORE_OPENCODE_ALLOW_MCP=1；使用该逃生开关重新安装会恢复 Lore 之前修改的值。
安装完成后可以查看 ~/.lore/ 目录确认写入了哪些文件。
常用选项
| 选项 | 什么时候用 |
|---|---|
--channels claudecode,codex | 只安装选中的集成。OpenCode 使用 opencode。 |
--base-url http://host:18901 | Lore 已经在别处运行。这个选项会跳过服务器启动。 |
--api-token TOKEN | 服务器启用了 API_TOKEN。 |
--skip-docker | 只安装本机客户端集成。 |
--pre | 使用 pre-latest 发布通道。 |
--dev | 使用 dev-latest 发布通道。 |
--force | 即使版本看起来已是最新，也重新安装。 |
示例
只安装 OpenCode 预发布版 v1.3.15-pre.4：
该命令为 OpenCode 1.18.3 或更新版本安装 lore-opencode.zip。如果系统未安装 opencode CLI，该 channel 会成功跳过，而不会导致整个安装器失败。
只安装 Codex 和 Claude Code 集成：
把这台机器的 Agent 指向已有 Lore 服务器：
安装后做什么
- 如果不是连接已有服务器，打开
http://127.0.0.1:18901/setup。 - 完成 embedding、View LLM 和 boot memory 设置。
- 重启刚安装集成的 Agent 运行时。
- Codex 用户运行
codex mcp list确认 Lore 已注册，然后打开 Codex 会话输入/hooks，如果提示确认，信任 Lore hooks。 - OpenCode 用户确认
~/.config/opencode/plugins/lore-memory.js存在，重启 OpenCode，并要求它调用lore_status。Boot 使用experimental.chat.system.transform；prompt Recall 使用chat.message，即使 system 注入不可用也会继续工作。 - 发一个真实任务 prompt，确认能看到召回块。
如果你不想让安装器管理服务器或客户端，使用 手动配置。