使用 OpenClaw 建立個人助理¶

OpenClaw 是一個用於 Pi 代理程式的 WhatsApp + Telegram + Discord + iMessage Gateway 閘道器。外掛可加入 Mattermost。本指南說明「個人助理」設定：一個專用的 WhatsApp 號碼，其行為就像你隨時在線的代理程式。外掛會新增 Mattermost。本指南是「個人助理」設定：一個專用的 WhatsApp 號碼，表現得就像你隨時在線的代理。

⚠️ 安全優先¶

你正在讓一個代理程式處於可以：

在你的機器上執行指令（取決於你的 Pi 工具設定）
讀取／寫入你工作區中的檔案
透過 WhatsApp／Telegram／Discord／Mattermost（外掛）向外傳送訊息

從保守開始：

一律設定 channels.whatsapp.allowFrom（切勿在你的個人 Mac 上對全世界開放）。
為助理使用專用的 WhatsApp 號碼。
心跳現在預設為每 30 分鐘一次。心跳目前預設為每 30 分鐘一次。在你信任此設定之前，請透過設定 agents.defaults.heartbeat.every: "0m" 停用。

先決條件¶

已安裝並完成 OpenClaw 入門引導 — 若尚未完成，請參閱 Getting Started
第二個電話號碼（SIM／eSIM／預付卡）供助理使用

兩支手機的設定（建議）¶

你想要的是這樣：

39. %%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#ffffff',
    'primaryTextColor': '#000000',
    'primaryBorderColor': '#000000',
    'lineColor': '#000000',
    'secondaryColor': '#f9f9fb',
    'tertiaryColor': '#ffffff',
    'clusterBkg': '#f9f9fb',
    'clusterBorder': '#000000',
    'nodeBorder': '#000000',
    'mainBkg': '#ffffff',
    'edgeLabelBackground': '#ffffff'
  }
}}%%
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>Pi agent"]

如果你將個人的 WhatsApp 連結到 OpenClaw，所有傳給你的訊息都會變成「代理程式輸入」。這通常不是你想要的。 21. 那通常不是你想要的。

5 分鐘快速開始¶

配對 WhatsApp Web（顯示 QR；用助理手機掃描）：

openclaw channels login

啟動 Gateway 閘道器（保持執行）：

openclaw gateway --port 18789

在 ~/.openclaw/openclaw.json 放入最小設定：

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

現在，從你的允許清單手機向助理號碼傳送訊息。

當新手引導完成時，我們會自動開啟儀表板並列印一個乾淨的（未包含 token）連結。如果它提示進行驗證，請將 gateway.auth.token 中的 token 貼到 Control UI 設定中。稍後重新開啟：openclaw dashboard。

為代理程式提供工作區（AGENTS）¶

OpenClaw 會從其工作區目錄讀取操作指示與「記憶」。

預設情況下，OpenClaw 使用 ~/.openclaw/workspace 作為代理程式工作區，並會在設定／首次代理程式執行時自動建立（以及起始的 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md）。BOOTSTRAP.md 僅在工作區全新時建立（刪除後不應再出現）。MEMORY.md 為選用（不會自動建立）；存在時，會在一般工作階段載入。子代理程式工作階段只會注入 AGENTS.md 與 TOOLS.md。 BOOTSTRAP.md 只會在工作區全新時建立（刪除後不應再次出現）。 MEMORY.md 是選用的（不會自動建立）；存在時，會在一般工作階段中載入。子代理工作階段只會注入 AGENTS.md 和 TOOLS.md。

提示：將此資料夾視為 OpenClaw 的「記憶」，並將其設為 git repo（理想情況下為私有），以便備份你的 AGENTS.md 與記憶檔案。若已安裝 git，全新的工作區會自動初始化。如果已安裝 git，全新的工作區會自動初始化。

openclaw setup

完整的工作區配置與備份指南：Agent workspace 記憶工作流程：Memory

選用：使用 agents.defaults.workspace 選擇不同的工作區（支援 ~）。

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

如果你已從 repo 發佈自有的工作區檔案，可以完全停用啟動時建立檔案：

{
  agent: {
    skipBootstrap: true,
  },
}

將其變成「助理」的設定¶

OpenClaw 預設即是良好的助理設定，但你通常會想調整：

SOUL.md 中的 persona／指示
思考預設（如有需要）
心跳（在你信任之後）

範例：

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    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 設定）。若單獨傳送，代理程式會以簡短問候回覆以確認重置。 30. 若單獨傳送，代理會以簡短的問候回覆以確認重設。
/compact [instructions] 會壓縮工作階段內容，並回報剩餘的內容預算。

心跳（主動模式）¶

預設情況下，OpenClaw 每 30 分鐘執行一次心跳，提示為： 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 會略過心跳執行以節省 API 呼叫。
若檔案不存在，心跳仍會執行，並由模型決定要做什麼。
若代理程式回覆 HEARTBEAT_OK（可選擇性加上簡短填充；見 agents.defaults.heartbeat.ackMaxChars），OpenClaw 會抑制該次心跳的對外傳送。
心跳會執行完整的代理程式回合 — 較短的間隔會消耗更多權杖。

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

32. 媒體輸入與輸出¶

傳入的附件（圖片／音訊／文件）可透過樣板呈現在你的指令中：

{{MediaPath}}（本機暫存檔路徑）
{{MediaUrl}}（偽 URL）
{{Transcript}}（若已啟用音訊轉錄）

代理程式的傳出附件：在單獨一行中包含 MEDIA:<path-or-url>（不可有空格）。範例：範例：

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

OpenClaw 會擷取這些內容，並將其作為媒體與文字一併傳送。

操作檢查清單¶

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # adds gateway health probes (Telegram + Discord)
openclaw health --json   # gateway health snapshot (WS)

日誌位於 /tmp/openclaw/（預設：openclaw-YYYY-MM-DD.log）。

後續步驟¶

WebChat：WebChat
Gateway 營運：Gateway runbook
Cron + 喚醒：Cron jobs
macOS 選單列配套應用程式：OpenClaw macOS app
iOS 節點應用程式：iOS app
Android 節點應用程式：Android app
Windows 狀態：Windows (WSL2)
Linux 狀態：Linux app
安全性：Security

Home

Overview

Core concepts

First steps

Guides

Personal Assistant Setup