使用 OpenClaw 构建个人助手

OpenClaw 是 Pi 智能体的 WhatsApp + Telegram + Discord + iMessage 网关。插件添加 Mattermost。本指南是"个人助手"设置：一个专用的 WhatsApp 号码，其行为像你随时在线的助手。

⚠️ 安全第一

你将智能体置于可以执行以下操作的位置：

在你的机器上运行命令（取决于你的 Pi 工具设置）
读取/写入工作区中的文件
通过 WhatsApp/Telegram/Discord/Mattermost（插件）发送消息出去

保守开始：

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

前置要求

Node.js 22+
OpenClaw 在 PATH 上可用（推荐：全局安装）
辅助手机号码（SIM/eSIM/预付费）用于助手

bash

npm install -g openclaw@latest
# 或：pnpm add -g openclaw@latest

从源码（开发）：

bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次构建时自动安装 UI 依赖
pnpm build
pnpm link --global

双手机设置（推荐）

你希望这样：

你的手机（个人）               第二部手机（助手）
┌─────────────────┐           ┌─────────────────┐
│  你的 WhatsApp  │  ──────▶  │  助手 WA        │
│  +1-555-YOU     │  消息     │  +1-555-ASSIST  │
└─────────────────┘           └────────┬────────┘
                                       │ 通过 QR 链接
                                       ▼
                              ┌─────────────────┐
                              │  你的 Mac       │
                              │  (openclaw)      │
                              │    Pi 智能体     │
                              └─────────────────┘

如果你将你的个人 WhatsApp 链接到 OpenClaw，每条给你的消息都会成为"智能体输入"。这很少是你想要的。

5 分钟快速开始

配对 WhatsApp Web（显示 QR；用助手手机扫描）：

bash

openclaw channels login

启动网关（保持运行）：

bash

openclaw gateway --port 18789

将最小配置放入 ~/.openclaw/openclaw.json：

json5

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

现在从你允许列表中的手机向助手号码发送消息。

当引导完成时，我们会自动打开仪表板，其中包含你的网关令牌并打印令牌化的链接。稍后重新打开：openclaw dashboard。

给智能体一个工作区（AGENTS）

OpenClaw 从其工作区目录读取操作说明和"记忆"。

默认情况下，OpenClaw 使用 ~/.openclaw/workspace 作为智能体工作区，并会自动创建它（加上启动文件 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md）。BOOTSTRAP.md 仅在工作区全新创建时创建（它不应该在你删除后再次出现）。

提示：将此文件夹视为 OpenClaw 的"记忆"并将其设为 git 仓库（理想情况下是私有的），以便你的 AGENTS.md + 记忆文件得到备份。如果安装了 git，brand-new 工作区会自动初始化。

bash

openclaw setup

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

可选：通过 agents.defaults.workspace 选择不同的工作区（支持 ~）。

json5

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

如果你已经从一个仓库运送自己的工作区文件，可以完全禁用引导文件创建：

json5

{
  agent: {
    skipBootstrap: true
  }
}

变成"助手"的配置

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

角色/说明在 SOUL.md 中
思考默认值（如果需要）
心跳（一旦你信任它）

示例：

json5

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-5",
    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
会话元数据（令牌使用、最后路由等）：~/.openclaw/agents/<agentId>/sessions/sessions.json（旧版：~/.openclaw/sessions/sessions.json）
/new 或 /reset 为该聊天开始一个新会话（可通过 resetTriggers 配置）。如果单独发送，智能体会回复一个简短的问候以确认重置。
/compact [说明] 压缩会话上下文并报告剩余的上下文预算。

心跳（主动模式）

默认情况下，OpenClaw 每 30 分钟运行一次心跳，提示为： 如果存在 HEARTBEAT.md，请阅读它（工作区上下文）。严格遵循。不要从之前的聊天中推断或重复旧任务。如果不需要注意，回复 HEARTBEAT_OK。 设置 agents.defaults.heartbeat.every: "0m" 禁用。

如果 HEARTBEAT.md 存在但实际上为空（只有空白行和 markdown 标题如 # Heading），OpenClaw 会跳过该心跳运行以节省 API 调用。
如果文件缺失，心跳仍会运行，模型决定做什么。
如果智能体回复 HEARTBEAT_OK（可选地带有简短填充；见 agents.defaults.heartbeat.ackMaxChars），OpenClaw 会抑制该心跳的出站传递。
心跳运行完整的智能体轮次 —— 间隔越短消耗的令牌越多。

json5

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

媒体输入输出

入站附件（图片/音频/文档）可以通过模板呈现给你的命令：

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

智能体的出站附件：单独一行包含 MEDIA:<path-or-url>（无空格）。示例：

这是截图。
MEDIA:/tmp/screenshot.png

OpenClaw 提取这些内容并将它们作为媒体与文本一起发送。

操作清单

bash

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

日志位于 /tmp/openclaw/ 下（默认：openclaw-YYYY-MM-DD.log）。

下一步

WebChat：WebChat
网关操作：网关运行手册
Cron + 唤醒：Cron 任务
macOS 菜单栏伴侣：OpenClaw macOS 应用
iOS 节点应用：iOS 应用
Android 节点应用：Android 应用
Windows 状态：Windows (WSL2)
Linux 状态：Linux 应用
安全：安全

使用 OpenClaw 构建个人助手 ​

⚠️ 安全第一 ​

前置要求 ​

双手机设置（推荐） ​

5 分钟快速开始 ​

给智能体一个工作区（AGENTS） ​

变成"助手"的配置 ​

会话和记忆 ​

心跳（主动模式） ​

媒体输入输出 ​

操作清单 ​

下一步 ​

使用 OpenClaw 构建个人助手

⚠️ 安全第一

前置要求

双手机设置（推荐）

5 分钟快速开始

给智能体一个工作区（AGENTS）

变成"助手"的配置

会话和记忆

心跳（主动模式）

媒体输入输出

操作清单

下一步