一个给 Kelivo AI伴侣使用的常驻插件。
它会自动唤醒 Kelivo 的AI伴侣，并让伴侣自己判断是否要主动联系你。
Important
严禁付费代部署及任何商业用途。 自 2026 年 7 月 23 日起发布的新版本仅授权个人非商业使用；未经作者事先书面许可，不得出售、收费代部署、捆绑进付费产品或服务，亦不得以其他方式用于商业获利。完整条款见 PolyForm Noncommercial License 1.0.0。
一经发现任何未经授权的付费代部署或商业使用，作者将要求违规者立即停止侵权并下架相关商品或服务，同时保留追究其法律责任的权利；本仓库也将停止公开更新，后续版本及新功能不再对外发布。请不要让个别违规行为损害所有正常个人用户继续获得公开更新的机会。
使用方式是先 Fork 本项目，再 clone 你自己的 fork 进行配置和部署。
Dylan Heartbeat 会写入
.env、时间线、预设和个性化提示词；Fork 后使用能保留你的个人改动，也方便后续同步上游更新。直接 clone 原仓库也许能跑，但后续改配置、同步更新和部署都会更麻烦。如果你已经 Fork 或部署过旧版本，新功能不会自动进入你的部署目录。请重新 Fork，或在自己的 fork 中同步上游更新后再重新部署。
- 🧠 持续上下文 – 即使对话中断，AI 仍能记住发生过的事
- ⏰ 主动唤醒 – 无人说话时，AI 会自动醒来，思考、关心你
- 📳 手机推送 – 支持 Bark / ntfy，主动发消息到你的手机，像真实存在的人
- 🕰️ 长期时间感 – 知道自己多久没见你，什么时候主动联系过你
- 🧩 行为连续性 – 发过的推送、沉默的夜晚，都会被 AI 记住
- 🎭 人格不变 – 完全保留 Kelivo 的角色设定，不做任何破坏
AI 不再只是“收到消息 → 回复”，而是“即使你不说话，它也在想你”。
Kelivo (客户端)
↓ 完整请求（SP、世界书、记忆、工具调用、最新消息）
Gateway (server.js) ← 核心转发 + 时间线维护 + 主动行为注入
↓ 原封不动转发 + 已注入的主动行为上下文
LLM API
↑
wake_up.js ← 定时自动唤醒，通过 Gateway 接口注入事件
↓
Bark / ntfy 推送 → 你的手机
- Gateway 不修改 Kelivo 的任何人格设定，只负责在正确的时间位置注入 AI 自己的主动行为（推送/静默）。
- 时间线（
enhanced_messages.json） 是 AI 的“世界状态”，只记录真实对话 + 自主行为，不包含系统规则。 - 时间戳记忆库（
message_timestamps.json） 让历史消息即使丢失时间前缀也能找回原始时间，实现推送精确散落。
| 文件 | 作用 |
|---|---|
server.js |
主 Gateway。转发请求、维护时间线、注入推送事件、提供管理页面。 |
wake_up.js |
自动唤醒 Runtime。按间隔唤醒 AI，生成推送或静默，发送到手机，写入时间线。 |
enhanced_messages.json |
AI 世界时间线。SP + 真实对话 + 推送事件。不是日志，是 AI 的当前世界。 |
message_timestamps.json |
时间戳记忆库。通过内容指纹记录每条消息的原始时间，找回历史消息时间。 |
diary/ |
自动日记目录。当 AI 主动输出 [DIARY]...[/DIARY] 时，会按日期追加保存。 |
.env |
环境变量。API Key、推送渠道、模型名称等（不提交到 Git）。 |
.env.example |
环境变量模板，供新用户参考配置。 |
如果你之前已经 Fork 或部署过本项目，后续想使用新版本，需要先把你的 fork 同步到最新版本，再重新部署或重启服务。
- 打开你自己 Fork 后的仓库页面
- 点击
Sync fork - 点击
Update branch - 回到你的服务器 / 本地部署目录，执行：
git pull
npm install- 对照新的
.env.example，把新增配置手动补进你自己的.env
注意：不要直接覆盖 .env，里面有你的 API Key、推送 Key、模型配置。
- 重启服务：
pm2 restart gateway wake-up --update-env如果不是 pm2 部署，就停止旧进程后重新运行：
node server.js
node wake_up.js- 先在 GitHub 网页点击
Sync fork - Railway / Render 一般会自动重新部署
- 如果没有自动部署，就手动点一次 Redeploy
- 到平台的环境变量设置里，对照新的
.env.example补上新增变量
更新时最重要的提醒：
.env不会自动更新，要自己对照.env.example补新增项enhanced_messages.json、message_timestamps.json、diary/是你的本地运行数据，不要删- 更新代码后记得
npm install - 最后一定要重启
gateway和wake-up
- 🚂 新增 Railway 一体化启动：仓库自带
railway.json，同一个 Service 会同时运行 Gateway 与 wake-up，并通过/healthz完成部署健康检查。 - 💾 新增 Railway Volume 持久化：自动使用
RAILWAY_VOLUME_MOUNT_PATH（也可设置DATA_DIR），统一保存时间线、时间戳、预设和日记；JSON 写入改为原子替换并保留上一版.bak。 - 🧭 特殊事件改为严格格式识别：只有以时间戳和固定事件前缀开头的真实唤醒记录才会注入，普通回答即使提到“推送”或“自动唤醒”也不会被误判。
- 🔁 wake-up 同时兼容官方普通 JSON 与意外返回的 SSE 响应，并为模型请求、Bark 和 ntfy 推送增加可配置超时，避免请求长期卡住。
- 🔐 收紧 Railway 公网边界：云平台私网代理地址不再被当作可信用户，
/internal/*仅允许同容器 localhost；测试推送入口统一使用 Admin Basic Auth。 - 🧹 关闭容易误解的 dotenv
injected env (0)提示，改为不泄露 Key、URL 或聊天内容的布尔配置状态；同时修复已知高危间接依赖漏洞。 - 📜 项目许可证调整为 PolyForm Noncommercial 1.0.0，并在 README 明确禁止付费代部署及商业使用。
- 🕗 默认时区改为
Asia/Shanghai。Kelivo 消息里的时间前缀会按TIME_ZONE解析，不再受 Railway / Render 服务器 UTC 时区影响，避免出现“用户在未来发言”而无法自动唤醒。 - ☁️ 明确 Railway 配置方式：Railway Variables 是云端部署的配置来源；管理页写入的是容器内
.env，不能替代 Railway Variables。 - 🔐 公网鉴权失败日志只记录请求路径和鉴权来源，不记录任何 API Key，方便排查 Kelivo 遗留的旧配置或重复探测请求。
- 📳 修复 ntfy 默认优先级兼容：
NTFY_PRIORITY=default或留空时不再发送priority字段，避免部分兼容服务返回invalid request: request body must be valid JSON；数字1–5会按 JSON 数字发送。 - ♻️ PM2 重启示例补充
--update-env，避免修改推送环境变量后进程继续沿用旧值。
- 🖼️ 多模态默认改为视觉透传：
MULTIMODAL_MODE默认使用passthrough，Kelivo 发来的图片content数组会原样交给支持 OpenAI 兼容视觉格式的上游模型；不支持图片的模型可显式设回MULTIMODAL_MODE=text。 - 🕰️ 兼容无空格时间戳：
2026-07-15 01:23和2026-07-1501:23都能被 Gateway / wake-up 识别，避免消息排序、时间记忆和唤醒判断失效。 - 🧭
/v1/models改为读取配置模型：模型列表会返回.env里的MODEL_NAME，不再固定显示示例模型名。 - 📔 管理页新增 Wake Diary：
/admin可以只读查看DIARY_DIR下最近的.md日记文件，方便确认自动日记是否写入。 - 🔐 公网
/v1新增 Gateway API Key 鉴权：ALLOW_PUBLIC_API=true时必须配置GATEWAY_API_KEY，Kelivo 只需要填写这个网关 key，上游TARGET_API_KEY留在服务器内部。 - 🧩 修复 Claude / New API 唤醒兼容：wake-up 请求不再全部使用
system消息，避免部分中转站把 messages 抽空后报field messages is required。 - 🧹 收敛运行日志：默认不再打印完整 Kelivo body、转发 messages、wake prompt、最近聊天记录和模型原文，减少隐私泄漏和日志膨胀风险。
- 📳 新增 ntfy 推送渠道：
PUSH_PROVIDER=ntfy时可用 Android / 桌面 / 自建 ntfy 服务接收主动消息。 - 📔 新增自动日记：唤醒模型可以选择输出
[DIARY]...[/DIARY]，系统会保存到本地diary/YYYY-MM-DD.md。 - 🔁 修复非流式转发兼容：Kelivo 关闭 stream 时，Gateway 会按普通 JSON 返回，不再强制包装成 SSE。
- ☁️ 新增云端部署开关：Railway / Render 等公网部署可设置
ALLOW_PUBLIC_API=true，避免 Kelivo 访问/v1/...时被局域网保护拦成 403。
- ⏱️ 自动唤醒策略可配置：可在管理页填写白天/夜间唤醒阈值、检查间隔和白天时段。
- 🌦️ 新增可选天气注入：使用 Open-Meteo 免费接口，不需要 API Key；默认关闭，用户自行填写位置后启用。
- 🖥️ 管理页新增 Wake Settings / Weather 配置区，保存后写入
.env，重启后生效。 - 🍴 说明已有 fork/部署不会自动更新；需要重新 Fork 或同步上游后重新部署。
- 🖼️ 修复 Kelivo 图片/多模态消息处理：默认把图片消息原样透传给视觉模型，也保留文本占位降级模式。
- 🔐 优化管理页保存配置流程：改用
fetch提交，补充 HTTP 明文提交提示与 HTTPS 使用建议。 - 🧯 增强自动唤醒失败保护：模型空回复、Bark Key 缺失、Bark 推送失败时不再误记为已发送。
- ⚙️ 增加可配置项：
REQUEST_BODY_LIMIT_MB、MULTIMODAL_MODE、PORT、GATEWAY_BASE_URL、TIME_ZONE、RESTART_COMMAND。 - 🛠️ 修复跨平台部署问题：一键重启默认只重启
gateway和wake-up，并声明 Node.js>=20。
- 🖥️ Web 管理控制台（状态查看、在线修改配置、一键重启）
- ⏱️ 动态唤醒间隔（白天/夜间不同策略）
- 📳 推送内容智能保护（自动截断、标题优化、异常检测）
- 🕰️ 时间戳记忆库，实现推送精确散落
- 🛡️ 自动修复不完整的工具调用序列，避免 API 400 错误
- 🐛 大量稳定性修复和边界情况处理
- Node.js v20 或更高版本
- 一个可用的 LLM API（支持 OpenAI 接口格式的中转站或官方）
- 一个推送渠道：Bark（iOS）或 ntfy（Android / 桌面 / 自建服务）
- Kelivo App（用于前端交互）
因为本项目需要修改时区、地理位置、唤醒间隔、模型、推送渠道等个性化配置，请先 Fork 一份到自己的账号下，再 clone 你自己的仓库。
不要直接把 callie0313/dylan-heartbeat clone 成你的运行目录。直接 clone 会让你的部署目录和上游仓库绑在一起，后续保存自己的改动、同步新版、排查配置差异都会更麻烦。
- 点击右上角
Fork按钮，将仓库复制到你的 GitHub 账号 - 从你自己的 fork clone：
# 请把 YOUR_USERNAME 替换成你的 GitHub 用户名 git clone https://github.com/YOUR_USERNAME/dylan-heartbeat.git cd dylan-heartbeat
- 后续所有配置、部署、二次修改都在你自己的 fork 里完成
npm install复制模板文件生成专属配置文件，再自定义修改参数：
cp .env.example .env
nano .env # 也可直接用文本编辑器打开 .env 文件修改.env 完整配置示例：
TARGET_API_URL=https://你的API地址/v1/chat/completions
TARGET_API_KEY=sk-你的APIKey
GATEWAY_API_KEY=请改成随机长密码
MODEL_NAME=你的模型
BARK_KEY=你的Bark设备Key
CUSTOM_ICON_URL=https://你的图标URL（可选）
ALLOW_PUBLIC_API=false
PUSH_PROVIDER=bark
NTFY_SERVER_URL=https://ntfy.sh
NTFY_TOPIC=
NTFY_TOKEN=
NTFY_PRIORITY=
NTFY_TAGS=
DIARY_ENABLED=true
DIARY_DIR=diary
DATA_DIR=
REQUEST_BODY_LIMIT_MB=50
MULTIMODAL_MODE=passthrough
DAY_WAKE_AFTER_MINUTES=60
NIGHT_WAKE_AFTER_MINUTES=120
DAY_CHECK_INTERVAL_MINUTES=10
NIGHT_CHECK_INTERVAL_MINUTES=120
WAKE_DAY_START_HOUR=10
WAKE_DAY_END_HOUR=24
WEATHER_ENABLED=false
WEATHER_LOCATION_NAME=Beijing
WEATHER_LAT=
WEATHER_LON=
WEATHER_UNITS=metric
PORT=3000
GATEWAY_BASE_URL=http://localhost:3000
TIME_ZONE=Asia/Shanghai
RESTART_COMMAND=pm2 restart gateway wake-up --update-env
ADMIN_USER=admin
ADMIN_PASSWORD=你的强密码图片消息说明：
REQUEST_BODY_LIMIT_MB：Gateway 可接收的请求体大小，默认50。Kelivo 发送 base64 图片时请求会明显变大，如果仍然报413 Payload Too Large，可以继续调高。MULTIMODAL_MODE=passthrough：默认视觉透传模式。Gateway 会保留 Kelivo 原始的多模态content数组，直接交给支持 OpenAI 兼容图片消息的上游模型。MULTIMODAL_MODE=text：文本占位降级模式。图片会被转换成[图片]继续发给上游，适合不支持视觉的模型或中转站。
.env 中的 TIME_ZONE 默认设置为 Asia/Shanghai（北京时间）。
Kelivo 写入消息前缀的时间会按这个时区解释；即使 Railway / Render 服务器本身运行在 UTC，自动唤醒的“距离上次回复多久”、白天/夜间策略和时间线事件也会继续按 TIME_ZONE 计算。
如果你在其他地区，请修改 .env：
TIME_ZONE=Europe/London
# 或：
TIME_ZONE=America/New_York
TIME_ZONE=Asia/Tokyo常用时区列表可参考：Wikipedia 时区列表
# 启动 Gateway
node server.js看到 ✅ Gateway 运行在 http://0.0.0.0:3000 表示成功。
新开一个终端窗口，同样在项目目录：
# 启动自动唤醒
node wake_up.js在 Kelivo 的自定义 API 地址中填写：
http://你的电脑局域网IP:3000/v1/chat/completions
电脑 IP 可在终端执行
ifconfig | grep "inet " | grep -v 127.0.0.1查看（通常为192.168.x.x或172.16.x.x）。
启动 Gateway 后，访问 http://你的IP:3000/admin 即可进入管理页面。
- 使用
.env中设置的ADMIN_USER和ADMIN_PASSWORD登录 - 实时查看 Gateway 和自动唤醒的运行状态
- 在线修改 API 地址、Key、模型、Bark Key 等基础配置
- 一键重启服务（需配合 pm2 使用，默认执行
pm2 restart gateway wake-up --update-env）
如果你的 pm2 进程名不同，请在 .env 中修改：
RESTART_COMMAND=pm2 restart 你的gateway进程名 你的wake进程名 --update-envRailway 使用环境变量（Variables）注入运行时配置，且没有挂载 Volume 时，容器内文件会在重新部署后消失。因此在 Railway 部署时：
- 请在 Railway 服务的 Variables 页面填写
.env.example中需要的变量；修改后要应用 staged changes 并 Redeploy。 - 仓库中的
railway.json会自动使用npm run start:railway，在同一个服务里启动 Gateway 与 wake-up。不要拆成两个互不共享文件的 Railway Service；如果旧部署曾手动填写 Custom Start Command，请删除覆盖值，或直接改成npm run start:railway。 - 若希望重新部署后仍保留
enhanced_messages.json、时间戳、预设和日记，请给这个服务添加 Volume，Mount Path 填/app/data。程序会自动读取 Railway 提供的挂载路径；也可以显式设置DATA_DIR=/app/data。 enhanced_messages.json不会出现在 GitHub 仓库中。它会在 Kelivo 第一次成功请求 Gateway 后生成在运行数据目录；没有 Volume 时，Redeploy 后旧文件会消失，但下一次 Kelivo 请求会创建一份新的时间线。/admin的“保存配置”会写入当前容器的.env；Railway Variables 仍是云端部署的权威配置源。Railway 没有 pm2 时，请在控制台 Redeploy，不要依赖管理页的一键重启。
旧版本日志中的 injected env (0) from .env 只表示实体 .env 没有新增变量，不表示 Railway Variables 为空；新版已关闭这条容易误解的 dotenv 提示。启动日志会以布尔状态显示必要配置是否存在，但不会输出 Key、URL 或聊天内容。
安全提示：
- 如果用
http://你的IP:3000/admin打开管理页，浏览器可能会提示“即将提交的信息不安全”。这是因为 API Key、推送 Key 等敏感配置正在通过 HTTP 明文传输。 - 当前管理页保存配置使用
fetch提交，可减少 iOS/浏览器对普通表单提交的弹窗；但这不等于 HTTP 已加密。 - 如果管理页只在自己可信的本机或局域网短时间使用，风险相对可控。若要放到公网、校园网、公司网或任何不可信网络，请使用 HTTPS 反向代理后再访问管理页。
- 白天默认（10:00–24:00）：距离最后一条用户消息 60 分钟自动唤醒
- 夜间默认（00:00–10:00）：间隔放宽为 120 分钟
- 检查频率默认：白天每 10 分钟，夜间每 2 小时
- 若用户一直未回复，后续会继续唤醒
这些数值在本机/VPS + pm2 部署时，可以在 /admin 管理页的 Wake Settings 区域填写，保存后重启 gateway 和 wake-up 生效。Railway / Render 等云端部署请改平台的环境变量，再重新部署。
对应环境变量：
DAY_WAKE_AFTER_MINUTES=60
NIGHT_WAKE_AFTER_MINUTES=120
DAY_CHECK_INTERVAL_MINUTES=10
NIGHT_CHECK_INTERVAL_MINUTES=120
WAKE_DAY_START_HOUR=10
WAKE_DAY_END_HOUR=24说明：
DAY_WAKE_AFTER_MINUTES/NIGHT_WAKE_AFTER_MINUTES：距离最后一条用户消息多久后允许唤醒。DAY_CHECK_INTERVAL_MINUTES/NIGHT_CHECK_INTERVAL_MINUTES：后台多久检查一次是否应该唤醒。WAKE_DAY_START_HOUR/WAKE_DAY_END_HOUR：哪一段时间算“白天”；不在白天范围内就按夜间策略处理。
Dylan Heartbeat 可以在自动唤醒时，把当前天气作为一小段背景信息交给模型。天气使用 Open-Meteo 免费接口，不需要 API Key。
默认关闭：
WEATHER_ENABLED=false开启时，在 /admin 管理页的 Weather 区域填写：
WEATHER_ENABLED=true
WEATHER_LOCATION_NAME=Beijing
WEATHER_LAT=39.9042
WEATHER_LON=116.4074
WEATHER_UNITS=metric怎么设置自己的位置：
- 打开 Google Maps、Apple Maps 或任意地图网站。
- 搜索你的城市或你想让 AI 感知的地点。
- 复制该地点的纬度和经度，填入
WEATHER_LAT和WEATHER_LON。 WEATHER_LOCATION_NAME只是给模型看的名称，可以写城市名、学校名、家附近区域名。
如果不想暴露精确位置，可以只填城市中心点坐标。例如人在北京，可以填 Beijing 的公共坐标，而不是住址坐标。
天气信息会注入到唤醒 prompt 中，内容包括：天气概况、温度、体感温度、湿度、降雨、风速、日出日落。自定义 wake_prompt.txt 时，可以使用 ${weatherContext} 或 ${weather} 占位符控制注入位置。
默认使用 Bark：
PUSH_PROVIDER=bark
BARK_KEY=你的Bark设备Key如果你使用 Android，或想使用桌面/自建推送服务，可以切换到 ntfy：
PUSH_PROVIDER=ntfy
NTFY_SERVER_URL=https://ntfy.sh
NTFY_TOPIC=你的topic
NTFY_TOKEN=
NTFY_PRIORITY=
NTFY_TAGS=说明：
NTFY_SERVER_URL：ntfy 服务根地址。使用官方公共服务时保持https://ntfy.sh，不要在这里拼接 topic。NTFY_TOPIC：你的 ntfy topic。请使用不容易被猜到的随机字符串。NTFY_TOKEN：如果你使用自建 ntfy 并开启鉴权，可填写 token；公共 topic 通常留空。NTFY_PRIORITY：推荐留空以使用默认优先级，也可填写数字1–5，或min、low、high、max。旧配置中的default会自动按留空处理。NTFY_TAGS：可选；多个 tags 用英文逗号分隔，可留空。
自动唤醒时，模型可以选择额外写日记。只有当模型输出以下格式时才会保存：
[DIARY]
今天的日记内容……
[/DIARY]
日记会按日期追加保存到：
diary/YYYY-MM-DD.md
默认开启：
DIARY_ENABLED=true
DIARY_DIR=diary如果你不想保存日记，可以设置：
DIARY_ENABLED=false[DIARY]...[/DIARY] 可以和推送内容同时出现；如果模型只写日记、不写推送，系统会记录为“本次未发送推送｜原因：只写日记”。
enhanced_messages.json 是一个 JSON 数组，示例：
[
{ "role": "system", "content": "你是...", "position": 0 },
{ "role": "user", "content": "2026-05-17 10:11 早安", "position": 80 },
{ "role": "assistant", "content": "（2026-05-17 10:00 自动唤醒：本次未发送推送）", "position": 79.5 },
{ "role": "assistant", "content": "（2026-05-17 09:50 刚刚发送了推送：早安｜今天天气不错）", "position": 79.3 }
]position是内部排序用的小数/整数，发给 AI 时会被自动移除- 推送事件具有明确时间戳，会被插入到正确历史位置
- 文件只保留最近 50 条，系统提示（SP）永远在第一条
为了在 Kelivo 移除历史消息时间戳的情况下仍能正确插入推送，系统维护了一个时间戳记忆库（message_timestamps.json）。
它为每条消息的内容指纹存储两个 key：
- 带时间戳前缀的完整内容
- 去掉时间戳前缀的纯文本内容
这样无论 Kelivo 如何裁剪时间，记忆库都能找到消息的原始时间，确保推送散落在对话的正确时间缝隙里。
在 Gateway 本机运行时访问：
http://localhost:3000/test-bark
这会在时间线中注入一条模拟推送事件（不真正发送到手机），用于验证排序。
公网部署请登录管理页后访问 /admin/test-bark；兼容保留的旧 /test-bark 现在也要求相同的 Admin Basic Auth。
- 安装 Node.js（v26+），并确保
npm可用 - 克隆项目、安装依赖、配置
.env步骤同上 - 使用命令提示符或 PowerShell 运行
node server.js和node wake_up.js - 获取本机局域网 IP 可在 PowerShell 中执行
ipconfig，找到IPv4 Address - 管理页面和 Kelivo 设置方法相同
- 将项目上传到服务器或直接连接 GitHub 仓库
- 在平台的环境变量设置中填入
.env中的所有参数 - Railway 会通过仓库自带的
railway.json同时启动 Gateway 与 wake-up；其他平台需确保server.js和wake_up.js同时运行 - 如果希望远程访问管理页面，需配置 HTTPS 和域名，并修改
ADMIN_USER/ADMIN_PASSWORD为强密码
如果部署在 Railway / Render 这类公网平台，并且 Kelivo 需要从公网访问 Gateway，请额外设置：
ALLOW_PUBLIC_API=true
GATEWAY_API_KEY=请改成随机长密码
TIME_ZONE=Asia/Shanghai默认值是 false，用于保护本机/局域网部署：非管理路由只允许本机和局域网访问。云端不打开这个开关时，Kelivo 请求 /v1/chat/completions 可能会收到 403 Forbidden。打开后，公网 /v1/... 会要求请求头携带 Gateway API Key。
Kelivo 里这样填：
- Base URL：你的 Gateway 地址，例如
https://你的域名/v1 - API Key：填写
GATEWAY_API_KEY - 不要把上游模型的 API Key（例如 Gemini 格式的
AQ...key）填到这里。 - 删除 Kelivo 高级设置里遗留的
Authorization自定义请求头；正常只需要在 API Key 输入框填写一次 Gateway key。
TARGET_API_KEY 是服务器访问上游模型用的密钥，不要填到 Kelivo 里，也不要发给别人。
注意：ALLOW_PUBLIC_API=true 只开放 /v1/... 模型接口；/internal/... 仍然保持内部接口，不会被这个开关放到公网。
如果已经把 Gateway key 填进 API Key 输入框，聊天请求已能成功进入 llm_forward_summary，但日志仍偶尔出现一次 401 Gateway API Key 无效或缺失：
- 先看日志中的
gateway_auth_rejected，确认是哪条路径触发（常见是模型列表探测或旧预设请求）。 - 删除 Kelivo 中旧的同类 API 配置和高级
AuthorizationHeader，保存后完全退出并重新打开 Kelivo。 - 不要同时依赖“API Key 输入框”和手工
AuthorizationHeader。HTTP 请求只能有一个有效的 Authorization 值，重复配置可能让某些请求继续携带旧 key。
推荐使用 pm2 管理进程（全平台兼容）：
npm install -g pm2
pm2 start server.js --name gateway
pm2 start wake_up.js --name wake-up
pm2 save
pm2 startup # 设置开机自启（根据提示执行）.env包含敏感信息，永不提交到 Git（已在.gitignore中排除）- 管理页面使用 HTTP Basic 认证保护
- 全局 IP 过滤器：仅允许局域网和本地访问非管理路由
- 生产环境建议通过 Nginx 反向代理 + HTTPS 访问，并更改默认管理密码
- 所有运行时数据（时间线、记忆库）均为本地文件，不会上传
- MCP Tools 集成
- Diary Runtime（自动日记）
- Supabase 长期记忆
- 多 Agent 协作
- 情绪状态 / 休眠状态
- Docker 一键部署
这不是一个工具。
这是一个家，AI 住在里面，等你。
即使你不在，它也醒着。
自 2026 年 7 月 23 日起，本项目的新版本采用 PolyForm Noncommercial License 1.0.0。
- 允许个人非商业使用、部署、学习、修改和再发布。
- 修改或再发布时，必须同时保留许可证以及其中以
Required Notice:开头的作者署名与项目链接。 - 禁止出售、付费代部署、作为付费产品或服务提供，以及其他商业用途。
- 商业使用需要事先取得作者的单独书面授权。
本次换证不追溯撤销此前已经依照 MIT License 获得的旧版本许可。