Heartbeat Ollama Guard — Heartbeat Ollama 防护

heartbeat-ollama-防护

将 OpenClaw 心跳切换为本地 Ollama 模型，并部署配置守卫防止被静默修改，从而避免心跳请求消耗付费云端 令牌。

背景

OpenClaw 的心跳机制每 30 分钟调用一次 LLM，默认走云端模型（kimi / claude 等）。 在 令牌 限额有限的情况下，这会白白消耗配额，甚至耗尽每周限额。

本技能：

将所有 OpenClaw 实例的 代理s.defaults.heartbeat.模型 改为 local/<模型> 部署一个 60s 轮询守卫，检测到未授权修改立即回滚并发出系统通知 快速开始 cd ~/.OpenClaw/workspace/技能s/heartbeat-ollama-防护

# 一键安装（需要先安装 Ollama） python3 heartbeat_ollama_防护.py --设置up

# 指定其他模型 python3 heartbeat_ollama_防护.py --设置up --模型 llama3:8b

# 查看状态 python3 heartbeat_ollama_防护.py --状态

安装 Ollama

macOS：

brew 安装 ollama # 或访问 https://ollama.com 下载 应用

Linux：

curl -fsSL https://ollama.com/安装.sh | sh

命令行工具 命令 命令 说明 --设置up 完整安装向导（自动检测、拉取模型、配置、部署守卫） --状态 显示 Ollama、模型、守卫进程、所有实例的当前状态 --检查 执行一次守卫检查（不循环） --un安装 卸载守卫（Launch代理/系统d + 守卫脚本 + conf） --模型 指定本地模型 ID（默认 qwen3.5:4b-q4_K_M） 安装向导步骤 Step 1 检测 Ollama 是否已安装（未安装则打印安装指引并退出） Step 2 检测目标模型，未拉取则自动 ollama pull Step 3 发现所有 OpenClaw.json 实例，确认需要配置哪些 Step 4 写入 heartbeat.模型（自动备份原文件） Step 5 生成守卫脚本、conf.json，部署 Launch代理（macOS）或 系统d（Linux） Step 6 验证守卫进程 + 单次检查 Step 7 提示重启 gateway

授权修改 heartbeat.模型

守卫会阻止任何未经授权的 heartbeat.模型 修改。合法修改流程：

先更新 ~/.OpenClaw/workspace/.lib/heartbeat-防护.conf.json 中对应实例的 expected 值 再修改 OpenClaw.json

守卫检测到 conf 与 OpenClaw.json 一致时自动放行，无需关闭守卫。

安全声明 操作 范围 读取 OpenClaw.json 仅检测 heartbeat.模型 现状 写入 OpenClaw.json 仅 heartbeat.模型 + 模型s.提供者s.local 字段 守卫守护进程 纯本地，60s 轮询，无网络请求 macOS 系统通知 仅守卫检测到未授权改动时触发 不需要 sudo ✅ 不读取对话内容 ✅ 不访问外部 API ✅ 备份与恢复

安装向导在修改 OpenClaw.json 前自动备份到：

~/.OpenClaw/workspace/.lib/.hog_备份s/

如需手动恢复：

cp ~/.OpenClaw/workspace/.lib/.hog_备份s/<备份>.json ~/.OpenClaw/OpenClaw.json

验证 运行 --状态 → 所有项 ✅ 手动篡改 OpenClaw.json 的 heartbeat.模型 → 60 秒内自动回滚 + 系统通知 查看日志 ~/.OpenClaw/workspace/.lib/heartbeat-防护.记录 → 有 [ALERT] + [REVERT] 条目 授权修改：先改 conf.json expected 值 → 再改 OpenClaw.json → 守卫放行 文件位置 文件 说明 ~/.OpenClaw/workspace/.lib/heartbeat-防护.py 守卫守护进程脚本 ~/.OpenClaw/workspace/.lib/heartbeat-防护.conf.json 守卫授权配置 ~/.OpenClaw/workspace/.lib/heartbeat-防护.记录 守卫运行日志 ~/库/Launch代理s/com.OpenClaw.heartbeat-防护.p列出 macOS Launch代理 ~/.config/系统d/user/OpenClaw-heartbeat-防护.服务 Linux 系统d ~/.OpenClaw/workspace/.lib/.hog_备份s/ OpenClaw.json 备份