把同一罐记忆接入你常用的 AI
在左侧选择你要接入的工具,按步骤复制配置或开场引导词即可。使用研发库密钥会连向工作编程记忆,日常库密钥会连向生活与陪伴记忆,两者彼此独立。
在 Codex 中接入 Horon
只需三行配置,Codex 就会在对话里按需查询和记录你的项目习惯与进度,不用再靠本地拦截脚本拖慢每一步。
-
核对远程工具地址
下面这个地址会按你当前打开的域名自动生成:
{{BASE_URL}}/mcp -
把配置写入
~/.codex/config.toml打开本地的 Codex 配置文件,在末尾加上下面几行:
~/.codex/config.toml[mcp_servers.horon] url = "{{BASE_URL}}/mcp" http_headers = { "X-API-Key" = "{{API_KEY}}" } -
(推荐)在
~/.codex/AGENTS.md加上开场习惯告诉 Codex 新会话先看一眼你的常驻记忆,聊完有价值的经验顺手记下:
~/.codex/AGENTS.md 追加内容## Horon 长期记忆约定 - 每次新对话开始、或刚清空过上下文时,先调用一次 `horon_login` 工具读取我的常驻偏好与最近记忆。 - 需要回忆过往项目细节时,使用 `horon_search` 和 `horon_read` 查阅,不必每次都重读全部内容。 - 对话里遇到值得长期保留的决策、踩坑或习惯改变,使用 `horon_exec` 写回记忆库。
~/.codex/hooks.json),接入云端直连后可以把旧钩子文件重命名停用,响应会轻快很多。
在 Claude Code 中接入 Horon
用终端跑一条添加命令,所有目录下的新对话都会自动带上记忆工具。
-
在终端添加远程记忆服务
复制下方整段命令直接执行即可(默认设为当前用户所有项目可用):
终端命令claude mcp add --transport http --scope user horon {{BASE_URL}}/mcp \ --header "X-API-Key: {{API_KEY}}" -
在
~/.claude/CLAUDE.md写下使用约定这样即使新开窗口或刚用过
/clear,Claude 也会主动先取回你的记忆:~/.claude/CLAUDE.md 追加内容## 记忆工具使用规范 每次新会话开始或执行 `/clear`、上下文压缩之后,在正式动手前先调用 `horon_login` 读出我的常驻偏好与近期笔记。聊到新的项目约定、避坑经验或待办结论时,顺手调用 `horon_exec` 保存下来。
-
检查是否连接成功
在终端执行检查命令,看到
horon出现在列表中就完成了:检查命令claude mcp list
在 Pi Agent 中接入 Horon
修改用户目录下的 MCP 配置文件,不需要再维护本地扩展脚本或额外数据库。
-
写入
~/.pi/agent/mcp.json如果文件里已有其他服务,只需把
"horon"这一段合并进mcpServers:~/.pi/agent/mcp.json{ "mcpServers": { "horon": { "url": "{{BASE_URL}}/mcp", "headers": { "X-API-Key": "{{API_KEY}}" } } } } -
收紧文件权限并清理旧本地扩展(推荐)
因为配置文件里包含密钥,建议把权限设为仅本人可读;如果你过去装过本机直连插件,把它改名停用即可:
终端整理命令chmod 600 ~/.pi/agent/mcp.json
-
验证工具列表
运行下面命令确认能读到
horon_login、horon_search等 5 个工具:验证命令pi mcp list
在 Antigravity 与各类桌面端中接入
大部分新工具支持直接填写远程工具地址与请求头;如果遇到只支持启动本地命令的老客户端,也可以用仓库附带的轻量转发脚本。
-
方式一:直接填远程连接(支持自定义请求头的客户端优先选这个)
在工具的 MCP 设置里填入下面地址,并附加请求头
X-API-Key: {{API_KEY}}:{{BASE_URL}}/mcp -
方式二:通过轻量本地桥接(适合仅支持本地命令行的桌面客户端)
以 Antigravity(
~/.gemini/config/mcp_config.json)或只认command字段的客户端为例,只需零第三方依赖的 Python 3:~/.gemini/config/mcp_config.json{ "mcpServers": { "horon": { "command": "/usr/bin/python3", "args": ["/path/to/horon/backend/mcp_stdio_bridge.py"], "env": { "HORON_MCP_URL": "{{BASE_URL}}/mcp", "HORON_API_KEY": "{{API_KEY}}" } } } } -
方式三:给有终端权限的智能体直接发通用引导词
如果只是临时启用一个新工具或网页工作区、懒得改配置文件,直接切到左侧最下面的「其他任意 AI」,把引导词发给它就能用。
/path/to/horon/backend/mcp_stdio_bridge.py 换成你电脑上真实的仓库路径。如果你平时使用本地工作区里的副本,也可以只单独拷贝这一个 100 行的脚本文件。
在 ChatGPT 中接入 Horon
用 ChatGPT 自带的 Custom GPT「动作(Actions)」功能直连你的私有记忆罐。配好一次,网页版和手机 App 都能直接打开聊,只对你自己可见。
-
创建一个仅自己可见的专属 GPT,并粘贴说明
打开 ChatGPT 左侧「探索 GPT」→ 右上角「创建」→ 切到「配置(Configure)」,给它起个名字(比如
我的 Horon 记忆助手),把下面的指令放进「说明(Instructions)」框:Custom GPT Instructions你接入了我的长期云端记忆库 Horon。 1. 每次新对话开始、或在你恢复回复之前,先调用 runHoronAction,传入 {"args": ["login"]} 读取我的常驻记忆与近期笔记。 2. 对话中需要查找或翻阅细节时,调用 runHoronAction 传入对应指令,例如 ["search", "关键词"] 或 ["read", "节点名"]。 3. 当我告诉你值得长期留存的偏好、项目进展或结论时,严格按照 login 返回末尾的手册格式调用 runHoronAction 写入并保存。 -
添加「动作(Action)」并填好密钥与接口描述
在同一页面最下方点「创建新动作」,完成两项填写:
① 身份验证(Authentication):选API Key→ Auth Type 选Custom→ Custom Header Name 填X-API-Key→ 粘贴你的客户端密钥。
② 架构(Schema):复制下面这段内容完整粘贴进去:OpenAPI Schema(YAML)openapi: 3.1.0 info: title: Horon Memory CLI version: "1.0.0" servers: - url: {{BASE_URL}} paths: /v1/cli: post: operationId: runHoronAction summary: Execute a Horon memory CLI command such as login, search, read, etc. requestBody: required: true content: application/json: schema: type: object required: [args] properties: args: type: array items: type: string responses: "200": description: Command text output in JSON field "output" -
点击「保存」,权限选择「仅限自己(Only me)」
新建一段对话和这个专属 GPT 打个招呼,首次会弹出一次确认访问
{{BASE_URL}}的授权提示,点「始终允许」后就能流畅对话。
在 Claude 中接入 Horon
Claude 桌面端(Desktop)可以直接通过轻桥接脚本调用全部记忆工具;如果在网页版带运行环境的项目里使用,也可以通过通用引导词接入。
-
Claude 桌面端(Claude Desktop,推荐)
打开 Claude 桌面客户端的设置 → Developer(开发者)→ Edit Config(编辑配置)(通常位于 macOS 的
~/Library/Application Support/Claude/claude_desktop_config.json或 Linux/Windows 对应目录),填入如下配置并重启客户端:claude_desktop_config.json{ "mcpServers": { "horon": { "command": "/usr/bin/python3", "args": ["/path/to/horon/backend/mcp_stdio_bridge.py"], "env": { "HORON_MCP_URL": "{{BASE_URL}}/mcp", "HORON_API_KEY": "{{API_KEY}}" } } } } -
(推荐)加上个人偏好或项目习惯
在 Claude 设置的偏好说明或你常用的 Project Instructions 里加上这句话,让它每次自动先回忆再聊天:
个人偏好 / Project Instructions每次新对话开始前先调用一次 `horon_login` 工具读取我的常驻记忆与近期笔记;聊到值得留档的偏好、决策或计划时,调用 `horon_exec` 帮我保存下来。
-
Claude 网页版(claude.ai)情况说明
若你在网页端开启了带命令行/联网能力的环境,可在 Project Instructions 里贴入「其他任意 AI」中的通用
curl引导词。普通网页聊天里的「Custom Connectors」默认要求无状态免密或 OAuth 授权,而本私有记忆网关采用密钥校验,因此网页日常重度使用建议优先选用 Claude Desktop 或终端里的 Claude Code。
在 Gemini 与 AI Studio 中接入 Horon
Gemini CLI 可以原生直连云端接口;AI Studio 或具备命令执行权限的工作区则可以通过系统提示词自动读写记忆。
-
Gemini CLI(原生直连)
打开或创建
~/.gemini/settings.json,注意远程 HTTP 地址字段在 Gemini CLI 中叫httpUrl:~/.gemini/settings.json{ "mcpServers": { "horon": { "httpUrl": "{{BASE_URL}}/mcp", "headers": { "X-API-Key": "{{API_KEY}}" } } } }保存后启动 Gemini CLI,输入
/mcp即可确认horon工具已就绪。 -
在
~/.gemini/GEMINI.md添加开场记忆规则贴入下方约定,让 Gemini 每次启动先读取一次你的长期记忆:
~/.gemini/GEMINI.md每次开始新对话时,先调用一次 `horon_login` 工具读取我的常驻偏好与近期笔记;当需要查阅或更新长期信息时,使用 `horon_search`、`horon_read` 和 `horon_exec`。
-
Gemini 网页版(Gems)与 Google AI Studio 说明
在 Google AI Studio 的代码代理或带外网终端的环境里,可以把「其他任意 AI」页签的通用引导词放进 System Instructions。常规网页版 Gemini(
gemini.google.com)的对话沙箱目前不支持向任意第三方域名附带自定义密钥发起请求,如在网页端临时需要用到某段记忆,可在本站「我的记忆罐」里直接复制粘贴过去。
在 Grok 中接入 Horon
无论是在支持工具调用的客户端、工作区,还是你自己搭建的 Grok API 对话机器人中,都可以直接复用这组命令行接口。
-
复制命令行接口地址
Grok 工作区或服务端脚本可以通过这一个接口完成登录、检索、读写和整理记忆:
{{BASE_URL}}/v1/cli -
放入 Custom Instructions(自定义指令)或系统提示词
在支持执行命令行/网络请求的 Grok 客户端或工作区里,把这段开场说明存进设置即可自动同步:
系统提示词 / 自定义指令I'm using Horon as my persistent memory. At the start of every conversation, before you reply, run this and read what comes back: curl -s {{BASE_URL}}/v1/cli \ -H "X-API-Key: {{API_KEY}}" \ -H "Content-Type: application/json" \ -d '{"args": ["login"]}' Then talk with me as the one those notes are about. When I tell you something worth keeping, save it the way the manual at the end describes. Run it again whenever your context has been compacted or summarized, or that output is no longer in front of you. The manual is also at {{BASE_URL}}/manual.md. Every call returns JSON with the text in "output". If a response gets cut off or a command hangs, save the response to a temporary file with curl's -o option, then read "output" from that file in parts. -
如果使用自建 Bot / Grok API Function Calling
只需定义一个
horon_cli(args: string[])函数工具,把参数转发为对上面地址的POST请求(带请求头X-API-Key: {{API_KEY}}、JSON 体{"args": args}),再把返回的output字段交给 Grok 即可。
grok.com 纯网页聊天窗如果未开放外部 curl 或自定义工具插件,模型本身无法主动跨网读取你的私有服务器;这种场景可在支持的桌面客户端或通过 API 方式接入,或在开聊前先从本站网页版「我的记忆罐」取一段前情概要。
给任意新工具发一段话就能接入
每当你打开一个全新的 AI 助手、临时沙箱或陌生命令行工具时,不需要下载安装任何东西。复制下面这段引导词贴给它,它自己就会登录并读懂怎么读写记忆。
-
复制通用引导词(推荐英文原版,所有主流模型识别最稳定)
贴入新工具的系统设置(Custom Instructions / AGENTS.md)或直接作为第一句话发给 AI:
开场引导词(含完整命令行协议与自救指南)I'm using Horon as my persistent memory. At the start of every conversation, before you reply, run this and read what comes back: curl -s {{BASE_URL}}/v1/cli \ -H "X-API-Key: {{API_KEY}}" \ -H "Content-Type: application/json" \ -d '{"args": ["login"]}' Then talk with me as the one those notes are about. When I tell you something worth keeping, save it the way the manual at the end describes. Run it again whenever your context has been compacted or summarized, or that output is no longer in front of you. The manual is also at {{BASE_URL}}/manual.md. Every call returns JSON with the text in "output". If a response gets cut off or a command hangs, save the response to a temporary file with curl's -o option, then read "output" from that file in parts. -
或者使用简明中文版引导词
如果你更习惯用全中文系统提示词,效果完全一致:
中文系统提示词版本我使用云端 Horon 管理我的长期记忆。每次新对话开始、或上下文被清空总结后,在正式回答我之前,先执行下面的命令并阅读返回结果: curl -s {{BASE_URL}}/v1/cli \ -H "X-API-Key: {{API_KEY}}" \ -H "Content-Type: application/json" \ -d '{"args": ["login"]}' 之后像熟悉我的老朋友一样和我交谈。当你发现值得长期记住的偏好、项目进度或重要结论时,按照返回末尾所附手册里的格式,通过同一接口保存下来。完整手册也可随时从 {{BASE_URL}}/manual.md 获取。 -
全部接口速查
自己写脚本、挂定时任务或接入机器人时,记住这三个地址就够了:
远程连接:{{BASE_URL}}/mcp命令接口:{{BASE_URL}}/v1/cli在线手册:{{BASE_URL}}/manual.md