#OpenClaw 上手实战

本章用一个完整例子把前面所学串起来：从安装到搭建一个会自主运行的 Telegram 个人助理。

#目标

搭建一个 OpenClaw 助理，做到：

1. 在 Dashboard 正常对话、执行任务
2. 接入 Telegram，可远程指挥
3. 用 Heartbeat 每天早上 8 点主动推送待办与邮件摘要
4. 开启工具策略审批、保持安全更新

#第 1 步：安装（Node 22+）

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

确认 Node 版本满足 22+。安装后做安全更新检查，确保版本 ≥ 2026.1.29（见 安全章节）。

#第 2 步：初始化与 Dashboard

openclaw onboard --install-daemon   # 引导配置 + 安装守护进程
openclaw gateway status             # 确认网关在跑
openclaw dashboard                  # 打开控制台

浏览器访问 http://127.0.0.1:18789/，在对话框里试一句：

你好，告诉我你现在能用哪些工具。

#第 3 步：配置模型

在 onboard 流程或 openclaw.json 中设置 Provider 与模型，并配置回退链：

{
  "model": {
    "primary": "anthropic:claude-...",
    "fallback": ["openai:gpt-..."]
  }
}

把密钥放进环境变量：

ANTHROPIC_API_KEY=sk-ant-...

#第 4 步：收紧工具策略（安全第一）

在 openclaw.json 把工具策略调到最紧：

• 读操作自动放行
• 发送 / 删除 / 写入 / Shell 写一律需审批

先用一个低风险任务在 Dashboard 验证策略生效：

在工作区新建 notes/README.md，写一句话说明用途。

观察它是否在写文件前请求审批。

#第 5 步：接入 Telegram

用 @BotFather 创建 Bot 拿到 Token，在 onboard/Dashboard 中接入 Telegram 通道，并把 Token 放进环境变量：

TELEGRAM_BOT_TOKEN=123456:ABC-...

设置用户白名单，只允许你自己的账号指挥它。

在 Telegram 给 Bot 发条消息确认连通：

你好，确认能收到我的消息吗？

#第 6 步：用 Heartbeat 实现每日早报

在工作区创建/编辑 HEARTBEAT.md：

# 每次心跳检查
- 现在是否到了早上 8:00？
  是 → 汇总今日日程 + 未读重要邮件（不超过 5 条），发我 Telegram
- 是否有标记为紧急的新邮件？有则立即提醒
# 若都无需行动，回应 HEARTBEAT_OK

确认 Heartbeat 已启用（默认约每 30 分钟唤醒一次）。这样无需你提问，助理也会到点主动汇报。

#第 7 步：沉淀为技能

把多步流程固化为可复用技能 SKILL.md：

---
name: daily-brief
description: 汇总日程与未读邮件并推送 Telegram
---
1. 读取今日日程
2. 汇总未读重要邮件（≤5 条）
3. 生成要点并发送 Telegram

之后让心跳或你手动调用它即可。

#第 8 步：用 Git 备份记忆

cd ~/.openclaw
git init && git add . && git commit -m "snapshot"   # 注意排除密钥

#验证清单

[ ] Dashboard 对话正常，工具可用
[ ] 版本 ≥ 2026.1.29，端口仅绑定 127.0.0.1
[ ] 模型已配置，含回退链
[ ] 工具策略收紧：写操作会触发审批
[ ] Telegram 连通，已设用户白名单
[ ] HEARTBEAT.md 生效，每日 8 点推送
[ ] 流程已沉淀为 daily-brief 技能
[ ] ~/.openclaw 已 Git 备份（不含密钥）

#进一步玩法

• 加 Webhook：CI 失败实时告警
• 加 浏览器技能：自动抓取并整理资料
• 建第二个工作区专做运维，配独立 HEARTBEAT.md
• 需要更强的向量记忆/自我进化？可迁移到同源的 Hermes Agent

#下一步

• 典型落地场景 — 更多可复制玩法
• CLI 命令与自动化 — 深入自治
• 参考资源 — 官方与社区