用 OpenClaw 搭建个人助手

OpenClaw 是一个自托管的 gateway，将 WhatsApp、Telegram、Discord、iMessage 等消息平台连接到 AI 智能体。本指南介绍"个人助手"配置：一个专用号码，充当你的 7×24 AI 助手。

安全第一

你正在把一个智能体放在如下位置：

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

从保守配置开始：

• 始终设置 channels.whatsapp.allowFrom（永远不要在你的个人 Mac 上对全世界开放）。
• 为助手使用一个专用 WhatsApp 号码。
• 心跳默认每 30 分钟一次。在信任配置之前，通过设置 agents.defaults.heartbeat.every: "0m" 禁用它。

前置条件

• OpenClaw 已安装并完成 onboarding — 如果还没做，请参见 快速入门
• 一个第二手机号（SIM/eSIM/预付费）用于助手

双手机方案（推荐）

你希望达到这样的效果：

flowchart TB
    A["<b>你的手机（个人）</b><br>你的 WhatsApp<br>+1-555-你的号码"] -- 发消息 --> B["<b>第二台手机（助手）</b><br>助手 WhatsApp<br>+1-555-助手号码"]
    B -- 扫码关联 --> C["<b>你的 Mac（OpenClaw）</b><br>AI 智能体"]

如果把你的个人 WhatsApp 关联到 OpenClaw，发给你的每条消息都会变成"智能体输入"，这几乎不是你想要的结果。

5 分钟快速启动

1. 配对 WhatsApp Web（显示二维码；用助手手机扫描）：

openclaw channels login

2. 启动 Gateway（保持运行）：

openclaw gateway --port 18789

3. 在 ~/.openclaw/openclaw.json 中放入最简配置：

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

现在用白名单手机给助手号码发消息试试吧——你的龙虾应该已经活了。

onboarding 完成后，会自动打开仪表盘并显示无 token 的链接。如果提示认证，把 gateway.auth.token 中的 token 粘贴到 Control UI 设置中。之后重新打开：openclaw dashboard。

给智能体配置工作区（AGENTS）

OpenClaw 从工作区目录读取操作指令和"记忆"。

默认工作区为 ~/.openclaw/workspace，会在安装/首次运行时自动创建（包含 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md）。BOOTSTRAP.md 仅在工作区全新时创建（删除后不会重新出现）。MEMORY.md 是可选的（非自动创建）；存在时会在普通会话中加载。子智能体会话仅注入 AGENTS.md 和 TOOLS.md。

提示：把这个文件夹当作 OpenClaw 的"记忆"，并把它做成一个 git 仓库（最好是私有），备份你的 AGENTS.md 和记忆文件。如果已安装 git，全新工作区会自动初始化为 git 仓库。

openclaw setup

完整工作区布局 + 备份指南：智能体工作区 记忆工作流：记忆（Memory）

可选：通过 agents.defaults.workspace 选择其他工作区（支持 ~）。

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

如果你已经有自己的工作区文件仓库，可以完全禁用 bootstrap 文件创建：

{
  agent: {
    skipBootstrap: true,
  },
}

把它变成"助手"的配置

OpenClaw 默认就是一个不错的助手配置，但你通常会想调整：

• SOUL.md 中的角色/指令
• 思考模式默认值（如需要）
• 心跳（在你信任之后再开启）

示例配置：

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // 先设为 0；之后再开启
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

会话与记忆

• 会话文件：~/.openclaw/agents/<agentId>/sessions/.jsonl
• 会话元数据（token 用量、最后路由等）：~/.openclaw/agents/<agentId>/sessions/sessions.json
• /new 或 /reset 为该对话开启新会话（可通过 resetTriggers 配置）。单独发送时，智能体会回复简短问候确认重置。
• /compact [指令] 压缩会话上下文并报告剩余上下文额度。

心跳（主动模式）

默认情况下，OpenClaw 每 30 分钟运行一次心跳，提示词为： 如果存在则读取 HEARTBEAT.md（工作区上下文）。严格遵循它。不要从之前的对话中推断或重复旧任务。如果没有需要关注的事项，回复 HEARTBEAT_OK。

设置 agents.defaults.heartbeat.every: "0m" 可禁用。

• 如果 HEARTBEAT.md 存在但实际上为空（只有空行和 Markdown 标题），OpenClaw 会跳过心跳运行以节省 API 调用。
• 如果文件缺失，心跳仍会运行，由模型决定做什么。
• 如果智能体回复 HEARTBEAT_OK（可选带简短内容；参见 agents.defaults.heartbeat.ackMaxChars），OpenClaw 会抑制该次心跳的出站消息。
• 默认情况下，心跳向 DM 风格的 user:<id> 目标的投递是允许的。设置 agents.defaults.heartbeat.directPolicy: "block" 可在保持心跳运行的同时抑制直接目标投递。
• 心跳运行完整的智能体轮次——间隔越短，消耗 token 越多。

{
  agent: {
    heartbeat: { every: "30m" },
  },
}

媒体收发

入站附件（图片/音频/文档）可通过模板变量暴露：

• （本地临时文件路径）
• （伪 URL）
• （如果启用了音频转录）

智能体发出附件：在回复中单独成行包含 MEDIA:<路径或URL>（不加空格）。示例：

这是截图。
MEDIA:https://example.com/screenshot.png

OpenClaw 会提取这些内容，并将媒体与文本一起发送。

对于本地路径，默认白名单范围较窄：OpenClaw 临时根目录、媒体缓存、智能体工作区路径和沙箱生成的文件。如需更广泛的本地文件附件根目录，请配置明确的频道/插件白名单，而不是依赖任意主机路径。

运维检查命令

openclaw status          # 本地状态（凭证、会话、排队事件）
openclaw status --all    # 完整诊断（只读，可粘贴分享）
openclaw status --deep   # 增加 Gateway 健康探测（Telegram + Discord）
openclaw health --json   # Gateway 健康快照（WS）

日志存储在 /tmp/openclaw/ 下（默认：openclaw-YYYY-MM-DD.log）。

下一步

• WebChat：WebChat
• Gateway 运维：Gateway 运维手册
• 定时任务：定时任务
• macOS 菜单栏伴侣：OpenClaw macOS 应用
• iOS 节点应用：iOS 应用
• Android 节点应用：Android 应用
• Windows 状态：Windows（WSL2）
• Linux 状态：Linux 应用
• 安全配置：安全配置