個人助理設定

OpenClaw 是一個自託管的閘道，將 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等連接到 AI 代理。本指南涵蓋「個人助理」設定：一個專用的 WhatsApp 號碼，其行為就像您隨時待命的 AI 助理。

⚠️ 安全第一

您將代理置於能夠執行以下操作的位置：

在您的機器上執行指令（視您的工具原則而定）
讀取/寫入您工作區中的檔案
透過 WhatsApp/Telegram/Discord/Mattermost 和其他捆綁頻道傳送訊息

從保守開始：

請務必設定 channels.whatsapp.allowFrom（切勿在您的個人 Mac 上對全世界開放執行）。
為助理使用專用的 WhatsApp 號碼。
心跳預設現在設定為每 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 分鐘快速入門

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

openclaw channels login

啟動閘道（保持其運行）：

openclaw gateway --port 18789

將最簡設定放入 ~/.openclaw/openclaw.json：

{
  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 工作區，並會在設定/首次 Agent 執行時自動建立它（以及初始的 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md）。BOOTSTRAP.md 僅在工作區是全新時建立（您刪除它後不應該再次出現）。MEMORY.md 是可選的（不會自動建立）；當存在時，它會被載入用於一般工作階段。子 Agent 工作階段僅會注入 AGENTS.md 和 TOOLS.md。

openclaw setup

完整的工作區佈局與備份指南：Agent workspace 記憶體工作流程：Memory

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

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

如果您已經從儲存庫部署自己的工作區檔案，您可以完全停用引導檔案的建立：

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

將其變成「助理」的設定

OpenClaw 預設為良好的助理設定，但您通常會想要調整：

SOUL.md 中的 persona/instructions
thinking 預設值（如果需要的話）
heartbeats（一旦您信任它）

範例：

{
  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,
    },
  },
}

會話與記憶體

Session 檔案：~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
Session 中繼資料（token 使用量、最後路由等）：~/.openclaw/agents/<agentId>/sessions/sessions.json（舊版：~/.openclaw/sessions/sessions.json）
/new 或 /reset 會為該聊天啟動一個新的 session（可透過 resetTriggers 設定）。如果單獨發送，OpenClaw 將確認重置而不調用模型。
/compact [instructions] 會壓縮 session 語境並報告剩餘的語境預算。

Heartbeats（主動模式）

預設情況下，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 呼叫。
如果檔案不存在，心跳檢測仍會執行，由模型決定要做什麼。
如果 agent 回覆 HEARTBEAT_OK（可選擇性帶有短填充；請參見 agents.defaults.heartbeat.ackMaxChars），OpenClaw 將抑制該心跳的傳出傳送。
預設情況下，允許將心跳傳送至 DM 樣式的 user:<id> 目標。設定 agents.defaults.heartbeat.directPolicy: "block" 以抑制直接目標的傳送，同時保持心跳執行處於啟用狀態。
心跳檢測會執行完整的代理週期——較短的間隔會消耗更多的 tokens。

{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

媒體輸入與輸出

傳入的附件（圖片/音訊/文件）可以透過模板顯示給您的指令：

{{MediaPath}}（本機暫存檔案路徑）
{{MediaUrl}}（偽 URL）
{{Transcript}}（如果啟用了音訊轉錄）

來自 agent 的傳出附件使用訊息工具或回覆酬載上的結構化媒體欄位，例如 media、mediaUrl、mediaUrls、path 或 filePath。訊息工具引數範例：

{
  "message": "Here's the screenshot.",
  "mediaUrl": "https://example.com/screenshot.png"
}

OpenClaw 會隨文字一起發送結構化媒體。為了相容性，舊版的最終助手回覆可能仍會被正規化，但工具輸出、瀏覽器輸出、串流區塊和訊息動作不會將文字解析為附件指令。

本機路徑行為遵循與 agent 相同的檔案讀取信任模型：

如果 tools.fs.workspaceOnly 為 true，輸出的本地媒體路徑將僅限於 OpenClaw 暫存根目錄、媒體快取、代理工作區路徑以及沙箱生成的檔案。
如果 tools.fs.workspaceOnly 為 false，輸出的本地媒體可以使用代理已有權限讀取的主機本地檔案。
本地路徑可以是絕對路徑、相對於工作區的路徑，或是使用 ~/ 的相對於使用者家目錄的路徑。
主機本機傳送仍僅允許媒體和安全的文件類型（圖片、音訊、視訊、PDF、Office 文件，以及已驗證的文字文件，例如 Markdown/MD、TXT、JSON、YAML 和 YML）。這是現有主機讀取信任邊界的擴充，並非秘密掃描器：如果 Agent 可以讀取主機本機的 secret.txt 或 config.json，且副檔名和內容驗證相符，它就能附加該文件。

這意味著當您的 fs 原則已允許讀取時，工作區外部生成的圖片/檔案現在可以發送，而任意的主機本機文字副檔名仍然被阻止。請將敏感檔案放在 Agent 可讀取的檔案系統之外，或者保持 tools.fs.workspaceOnly=true 以啟用更嚴格的本機路徑發送。

操作檢查清單

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 supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

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

下一步

WebChat：WebChat
閘道操作：Gateway runbook
Cron + 喚醒：Cron jobs
macOS 選單列伴隨應用程式：OpenClaw macOS app
iOS 節點應用程式：iOS app
Android 節點應用程式：Android app
Windows 狀態：Windows (WSL2)
Linux 狀態：Linux app
安全性：Security