官方教程15 分钟中级

个人助手设置

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 22+
  • PATH 中可用的 OpenClaw（推荐：全局安装）
  • 助手的第二个电话号码（SIM/eSIM/预付费）
npm install -g openclaw@latest
# 或： pnpm add -g openclaw@latest

从源代码安装（开发）：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build  # auto-installs UI deps on first run
pnpm build
pnpm link --global

双手机设置（推荐）

你需要这样：

你的手机 (个人)
WhatsApp +1-555-YOU
第二部手机 (助手)
Assistant WA +1-555-ASSIST
你的 Mac
(openclaw) Pi agent

如果你将个人 WhatsApp 链接到 OpenClaw，发给你的每条消息都会变成「智能体输入」。这通常不是你想要的。

5 分钟快速开始

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

openclaw channels login

2. 启动网关（保持运行）

openclaw gateway --port 18789

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

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

4. 现在从你的允许列表电话向助手号码发送消息

当入职完成后，我们会自动打开仪表板，显示你的网关令牌并打印令牌化链接。稍后重新打开：

openclaw dashboard

为智能体提供工作区（AGENTS）

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

默认情况下，OpenClaw 使用 ~/.openclaw/workspace 作为智能体工作区，并在设置/首次智能体运行时自动创建它（以及启动器 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md）。只有在工作区是全新时才创建 BOOTSTRAP.md（删除后不应恢复）。

提示:将此文件夹视为 OpenClaw 的「记忆」，并使其成为 git 仓库（理想情况下是私有的），以便你的 AGENTS.md + 内存文件被备份。如果安装了 git，新工作区会自动初始化。

openclaw setup

完整工作区布局 + 备份指南： Agent workspace | 内存工作流: Memory

可选：选择不同的工作区

使用 agents.defaults.workspace（支持 ~）

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

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

{
  agent: {
    skipBootstrap: true,
  },
}

将其转换为「助手」的配置

OpenClaw 默认为良好的助手设置，但你通常需要调整：

  • SOUL.md 中的persona/instructions
  • 思考默认值（如果需要）
  • 心跳（一旦你信任它）
{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-5",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    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/{SessionId}.jsonl

会话元数据（令牌使用、最后路由等）： ~/.openclaw/agents/<agentId>/sessions/sessions.json(遗留： ~/.openclaw/sessions/sessions.json)

  • /new
    或 /reset 为该聊天启动一个新会话（可通过 resetTriggers 配置）。如果单独发送，智能体会用简短的你好回复以确认重置。
  • /compact [instructions]
    压缩会话上下文并报告剩余的上下文预算。

心跳（主动模式）

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

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

媒体输入输出

入站附件

(图像/音频/文档)可以通过模板显示到你的命令：

  • {{MediaPath}}
  • {{MediaUrl}}
  • {{Transcript}} (如果启用了音频转录)

来自智能体的出站附件

在其自己的行中包含 MEDIA:<path-or-url>（无空格）。示例：

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

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

操作检查清单

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

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

下一步

现在你已经设置了个人助手，探索更多 OpenClaw 功能和配置选项。

配对和安全安全指南