Personal Assistant Setup

将 OpenClaw 配置为个人 AI 助手（专用 WhatsApp 号码）的端到端指南。

安全注意事项

Agent 可以：

在机器上执行命令（取决于工具策略）
读写工作区文件
通过 WhatsApp/Telegram/Discord 等发送消息

保守起步：

始终设置 channels.whatsapp.allowFrom（不要对外开放）
使用专用 WhatsApp 号码
初期禁用心跳：agents.defaults.heartbeat.every: "0m"

双手机方案（推荐）

你的手机（个人）+1-555-YOU
    ↓ 发消息
助手手机（专用）+1-555-ASSIST
    ↓ QR 扫码关联
你的 Mac（openclaw）AI Agent

不要将个人 WhatsApp 关联到 OpenClaw。

5 分钟快速启动

# 1. 配对 WhatsApp Web（扫码）
openclaw channels login
 
# 2. 启动 Gateway
openclaw gateway --port 18789

最小配置 ~/.openclaw/openclaw.json：

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

完整配置示例

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      heartbeat: { every: "0m" },  // 初期禁用
    },
    list: [{ id: "main", default: true }],
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: { mode: "daily", atHour: 4, idleMinutes: 10080 },
  },
}

心跳（主动模式）

默认每 30 分钟运行一次心跳，提示词：

“Read HEARTBEAT.md if it exists. Follow it strictly. If nothing needs attention, reply HEARTBEAT_OK.”

HEARTBEAT.md 为空（仅空行/标题）→ 跳过心跳节省 API 调用
Agent 回复 HEARTBEAT_OK → 抑制出站投递
heartbeat.directPolicy: "block" → 抑制 DM 投递但保持心跳运行

媒体收发

入站模板变量：

{{MediaPath}} — 本地临时文件路径
{{MediaUrl}} — 伪 URL
{{Transcript}} — 音频转录（若启用）

出站媒体：在消息中单独一行写 MEDIA:<path-or-url>

运维命令

openclaw status          # 本地状态（凭证/会话/队列事件）
openclaw status --all    # 完整诊断
openclaw status --deep   # 实时健康探测
openclaw health --json   # Gateway 健康快照

日志：/tmp/openclaw/openclaw-YYYY-MM-DD.log

Wiki AI

目录