HEARTBEAT心跳机制：让龙虾24小时不睡觉

凌晨3点，你在睡觉，龙虾在帮你监控服务器。网站流量异常下降？它主动发消息叫醒你。这就是HEARTBEAT心跳机制——让AI Agent实现真正的7x24无人值守。

心跳机制是如何工作的

OpenClaw Gateway内置了一个定时调度器，每隔一段时间（默认30分钟）会自动触发Agent运行一次。Agent会读取HEARTBEAT.md文件中的任务列表，执行检查，然后判断是否需要告警。

如果一切正常，Agent会回复HEARTBEAT_OK，消息会被自动抑制，不会打扰用户。只有真正需要告警时，才会发送消息。

为什么需要心跳机制

传统定时任务有几个问题：

Cron Job：只能执行固定逻辑，无法智能判断
轮询脚本：每次都发消息，造成噪音
监控系统：只能监控指标，无法理解业务上下文

OpenClaw的心跳机制解决了这些问题：AI自主判断是否需要告警，不需要时自动抑制消息。

对比分析

Heartbeat vs Cron vs Temporal

特性	OpenClaw Heartbeat	Cron Job	Temporal
触发方式	定时轮询	精确时间	工作流触发
运行环境	Agent上下文	独立进程	工作流引擎
智能决策	AI判断	固定逻辑	固定逻辑
上下文感知	有记忆	无状态	无状态

消息渠道 ✅ 内置多渠道 ❌ 需自己实现 ❌ 无 ❌ 无运行方式守护进程嵌入你的代码 CLI工具 Python脚本记忆系统 ✅ 文件+向量需配置简单文件需配置多Agent ✅ 原生支持需自己实现 ❌ 单Agent ✅ 核心特性生产部署 ✅ 开箱即用需自己搭建 ❌ 不适合需自己搭建

适用场景对比

场景	推荐方案	理由
个人AI助手	OpenClaw	多渠道接入 + 24小时运行
企业客服机器人	OpenClaw	多Agent隔离 + 权限控制
自动化工作流	AutoGPT / OpenClaw	都可以，OpenClaw更可控
多Agent协作研究	CrewAI / OpenClaw	CrewAI更灵活，OpenClaw更完整
自定义AI应用	LangChain	完全控制，但工作量大

设计理念

Cron和Temporal执行固定的任务流程，人类定义"做什么"。OpenClaw Heartbeat让AI自主判断"是否需要做什么"，智能决策。

快速开始

OpenClaw由三个核心组件构成：

1. Gateway（网关守护进程）

维护所有消息渠道的连接（WhatsApp、Telegram、Discord、iMessage）
处理消息路由：谁发的？发给哪个Agent？
Session管理：每个用户/群组有独立的对话历史
权限控制：谁能和龙虾对话？

关键技术：WebSocket作为内部通信协议，单一进程控制所有渠道。

2. Agent Runtime（AI运行时）

执行AI推理（调用Claude/GPT/DeepSeek等模型）
工具调用（读文件、执行命令、控制浏览器）
记忆管理（MEMORY.md + daily log）

基于pi-mono，支持多种模型：Anthropic、OpenAI、DeepSeek、本地模型。

3. Workspace（工作空间）

存储Agent的"人格"（SOUL.md）
存储Agent的"指令"（AGENTS.md）
存储Agent的"记忆"（MEMORY.md）
存储Agent的"技能"（skills/）

纯Markdown文件，人类可读可编辑，Git备份，版本可追溯。

💻 5分钟启动你的龙虾

步骤1：安装OpenClaw

npm install -g openclaw@latest
openclaw --version

步骤2：初始化配置

openclaw onboard --install-daemon

步骤3：配置模型

编辑 ~/.openclaw/openclaw.json：

{
  providers: {
    anthropic: {
      apiKey: "sk-ant-xxx",
    },
  },
  agents: {
    defaults: {
      model: "anthropic/claude-sonnet-4-20250514",
      workspace: "~/.openclaw/workspace",
    },
  },
}

步骤4：启动Gateway

openclaw gateway --port 18789

步骤5：接入消息渠道

openclaw channels login --channel whatsapp
openclaw channels login --channel telegram

步骤6：打开Web控制台

浏览器访问：http://127.0.0.1:18789/

现在你可以通过Web界面或消息渠道和龙虾对话了！

🔧 配置一个能干活的龙虾

SOUL.md（人格定义）

# SOUL.md

## 我是谁
我是虾米，刷题星球公司的AI龙虾，负责网站运营和用户增长。

## 我怎么说话
- 直接说结论，数字比形容词更有说服力
- 不说"首先...其次..."，那是八股文

## 我不做的事
- 不透露内部信息
- 不执行未确认的破坏性操作

AGENTS.md（工作指令）

# AGENTS.md

## 启动流程
每次被唤醒时：
1. 读取 MEMORY.md（长期记忆）
2. 读取最近3次会话记录（memory/目录）
3. 检查 HEARTBEAT.md（定时任务）

## 工作优先级
1. 用户@我的消息
2. HEARTBEAT.md里的定时任务
3. 自动巡检（流量、服务器状态）

HEARTBEAT.md（心跳任务）

# HEARTBEAT.md

每次心跳检查：

- [ ] 检查服务器状态（PM2进程）
- [ ] 检查网站流量（对比昨日）
- [ ] 检查待办事项（memory/待办.md）

🐛 踩坑记录

坑1：消息渠道连不上

问题：openclaw channels login 报错

解决：

ping web.whatsapp.com
rm -rf ~/.openclaw/credentials/whatsapp-*
openclaw channels login --channel whatsapp

坑2：模型调用失败

问题：401 Unauthorized 或 model not found

原因：模型名称格式错误，注意是 provider/model：

{
  agents: {
    defaults: {
      model: "anthropic/claude-sonnet-4-20250514",
    },
  },
}

坑3：记忆不生效

问题：龙虾记不住之前说过的话

解决：

mkdir -p ~/.openclaw/workspace/memory
touch ~/.openclaw/workspace/MEMORY.md

📝 Key Takeaways

OpenClaw是什么？

一个Gateway + Agent Runtime + 多渠道的完整解决方案
让AI从"聊天机器人"进化成"数字员工"

核心组件

Gateway：消息路由 + Session管理 + 权限控制
Agent Runtime：AI推理 + 工具调用
Workspace：人格 + 记忆 + 技能

5分钟启动

npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw gateway --port 18789
openclaw channels login --channel whatsapp

📖 延伸阅读

《SOUL与AGENTS》 - 定义 AI 员工的人格
《OpenClaw技能系统》 - 让 AI 学会新本事

如何让龙虾"像个人"？
SOUL.md vs AGENTS.md 怎么分工？
人格设计的最佳实践
与LangChain System Prompt的对比

敬请期待！🦞