English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

指南

个人助理设置

OpenClaw 是一个自托管 Gateway 网关，可将 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等连接到 AI 智能体。本指南涵盖“个人助理”设置：一个专用 WhatsApp 号码，行为类似你的常驻 AI 助手。

⚠️ 安全优先

你会把智能体放在一个可以执行以下操作的位置：

  • 在你的机器上运行命令（取决于你的工具策略）
  • 读写你工作区中的文件
  • 通过 WhatsApp/Telegram/Discord/Mattermost 和其他内置渠道发回消息

从保守配置开始：

  • 始终设置 channels.whatsapp.allowFrom（切勿在你的个人 Mac 上以面向全网开放的方式运行）。
  • 为助手使用专用 WhatsApp 号码。
  • Heartbeat 现在默认每 30 分钟运行一次。在信任该设置之前，请通过设置 agents.defaults.heartbeat.every: "0m" 将其禁用。

前提条件

  • 已安装并完成新手引导的 OpenClaw - 如果你还没有完成，请参阅入门指南
  • 助手使用的第二个电话号码（SIM/eSIM/预付费）

双手机设置（推荐）

你需要这样的设置：

flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]

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

5 分钟快速开始

  1. 配对 WhatsApp Web（显示二维码；用助手手机扫描）：
bash
openclaw channels login
  1. 启动 Gateway 网关（保持运行）：
bash
openclaw gateway --port 18789
  1. 在 ~/.openclaw/openclaw.json 中放入最小配置：
json5
{  gateway: { mode: "local" },  channels: { whatsapp: { allowFrom: ["+15555550123"] } },}

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

新手引导完成后，OpenClaw 会自动打开仪表板，并打印一个干净的（非 token 化的）链接。如果仪表板提示认证，请将配置的共享密钥粘贴到 Control UI 设置中。新手引导默认使用 token（gateway.auth.token），但如果你已将 gateway.auth.mode 切换为 password，密码认证也可以使用。稍后重新打开：openclaw dashboard。

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

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

默认情况下，OpenClaw 使用 ~/.openclaw/workspace 作为 Agent 工作区，并会在设置/首次智能体运行时自动创建它（以及入门用的 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md）。BOOTSTRAP.md 只会在工作区全新时创建（删除后不应再次出现）。MEMORY.md 是可选的（不会自动创建）；存在时，会为普通会话加载。子智能体会话只注入 AGENTS.md 和 TOOLS.md。

bash
openclaw setup

完整工作区布局 + 备份指南：Agent 工作区 记忆工作流：Memory

可选：使用 agents.defaults.workspace 选择不同工作区（支持 ~）。

json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

如果你已经从某个仓库分发自己的工作区文件，可以完全禁用启动文件创建：

json5
{  agents: {    defaults: {      skipBootstrap: true,    },  },}

将它变成“助手”的配置

OpenClaw 默认提供良好的助手设置，但你通常会想要调整：

  • SOUL.md 中的人设/说明
  • 思考默认值（如需要）
  • Heartbeat（在你信任它之后）

示例：

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

会话和记忆

  • 会话文件：~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
  • 会话元数据（token 使用量、上次路由等）：~/.openclaw/agents/<agentId>/sessions/sessions.json（旧版：~/.openclaw/sessions/sessions.json）
  • /new 或 /reset 会为该聊天启动一个全新会话（可通过 resetTriggers 配置）。如果单独发送，OpenClaw 会确认重置，而不会调用模型。
  • /compact [instructions] 会压缩会话上下文，并报告剩余上下文预算。

Heartbeat（主动模式）

默认情况下，OpenClaw 每 30 分钟运行一次 Heartbeat，并使用以下提示： Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. 设置 agents.defaults.heartbeat.every: "0m" 可禁用。

  • 如果 HEARTBEAT.md 存在但实际上为空（只有空行和类似 # Heading 的 markdown 标题），OpenClaw 会跳过 Heartbeat 运行以节省 API 调用。
  • 如果文件缺失，Heartbeat 仍会运行，由模型决定要做什么。
  • 如果智能体回复 HEARTBEAT_OK（可选带有少量填充；参见 agents.defaults.heartbeat.ackMaxChars），OpenClaw 会抑制该 Heartbeat 的对外发送。
  • 默认情况下，允许将 Heartbeat 发送到私信风格的 user:<id> 目标。设置 agents.defaults.heartbeat.directPolicy: "block" 可在保持 Heartbeat 运行激活的同时抑制直接目标发送。
  • Heartbeat 会运行完整智能体轮次 - 更短的间隔会消耗更多 token。
json5
{  agents: {    defaults: {      heartbeat: { every: "30m" },    },  },}

媒体输入和输出

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

  • {{MediaPath}}（本地临时文件路径）
  • {{MediaUrl}}（伪 URL）
  • {{Transcript}}（如果已启用音频转录）

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

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

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

本地路径行为遵循与智能体相同的文件读取信任模型：

  • 如果 tools.fs.workspaceOnly 为 true，出站 MEDIA: 本地路径仍限制在 OpenClaw 临时根目录、媒体缓存、Agent 工作区路径和沙箱生成的文件中。
  • 如果 tools.fs.workspaceOnly 为 false，出站 MEDIA: 可以使用智能体已被允许读取的主机本地文件。
  • 本地路径可以是绝对路径、工作区相对路径，或使用 ~/ 的主目录相对路径。
  • 主机本地发送仍只允许媒体和安全文档类型（图片、音频、视频、PDF 和 Office 文档）。纯文本和类似密钥的文件不会被视为可发送媒体。

这意味着，当你的文件系统策略已允许这些读取时，工作区外生成的图片/文件现在也可以发送，而不会重新打开任意主机文本附件外泄通道。

运维检查清单

bash
openclaw status          # local status (creds, sessions, queued events)openclaw status --all    # full diagnosis (read-only, pasteable)openclaw status --deep   # asks the gateway for a live health probe with channel probes when supportedopenclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

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

后续步骤

相关

Was this useful?