Skip to content
OpenClaw Docs

個人助理設定

使用 OpenClaw 建立個人助理

Section titled “使用 OpenClaw 建立個人助理”

OpenClaw 是一個自託管的閘道，可將 WhatsApp、Telegram、Discord、iMessage 等連接到 AI 代理。本指南涵蓋「個人助理」設定：一個表現得像您隨時待命 AI 助理的專用 WhatsApp 號碼。

⚠️ 安全第一

Section titled “⚠️ 安全第一”

您正在讓代理處於能夠：

  • 在您的機器上執行指令（取決於您的工具政策）
  • 讀取/寫入您工作區中的檔案
  • 透過 WhatsApp/Telegram/Discord/Mattermost（外掛）回傳訊息

開始時採保守策略：

  • 務必設定 channels.whatsapp.allowFrom（切勿在您的個人 Mac 上向全世界開放執行）。
  • 為助理使用專用的 WhatsApp 號碼。
  • 心跳預設現在設為每 30 分鐘一次。透過設定 agents.defaults.heartbeat.every: "0m" 禁用，直到您信任此設定為止。

先決條件

Section titled “先決條件”
  • 已安裝並入職 OpenClaw — 如果您尚未完成此操作，請參閱入門指南
  • 助理的第二個電話號碼（SIM/eSIM/預付卡）

雙手機設定（推薦）

Section titled “雙手機設定（推薦）”

您應該這樣做：

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 分鐘快速入門

Section titled “5 分鐘快速入門”
  1. 配對 WhatsApp Web（顯示 QR 碼；使用助理手機掃描）：
Terminal window
openclaw channels login
  1. 啟動閘道（讓它保持運作）：
Terminal window
openclaw gateway --port 18789
  1. 將最小配置放入 ~/.openclaw/openclaw.json：
{
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

現在從您允許清單中的手機傳送訊息給助理號碼。

當註冊完成時，我們會自動開啟儀表板並列印一個乾淨（非權杖化）的連結。如果它提示身份驗證，請將來自 gateway.auth.token 的權杖貼上到 Control UI 設定中。若稍後要重新開啟：openclaw dashboard。

給代理一個工作區 (AGENTS)

Section titled “給代理一個工作區 (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。

提示：將此資料夾視為 OpenClaw 的「記憶」並將其設為 git 儲存庫（最好是私有的），以便備份您的 AGENTS.md + 記憶檔案。如果已安裝 git，全新的工作區會自動初始化。

Terminal window
openclaw setup

完整的工作區佈局 + 備份指南：代理程式工作區 記憶體工作流程：記憶體

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

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

如果您已經從儲存庫提供自己的工作區檔案，您可以完全停用 bootstrap 檔案的建立：

{
  agent: {
    skipBootstrap: true,
  },
}

將其轉變為「助理」的配置

Section titled “將其轉變為「助理」的配置”

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

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

範例：

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

工作階段與記憶

Section titled “工作階段與記憶”
  • 工作階段檔案：~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
  • 工作階段元資料（token 使用量、最後路由等）：~/.openclaw/agents/<agentId>/sessions/sessions.json（舊版：~/.openclaw/sessions/sessions.json）
  • /new 或 /reset 為該聊天啟動一個新的工作階段（可透過 resetTriggers 設定）。如果單獨發送，代理會回覆簡短的問候以確認重置。
  • /compact [instructions] 會壓縮工作階段上下文並報告剩餘的上下文預算。

Heartbeats（主動模式）

Section titled “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 呼叫。
  • 如果檔案不存在，心跳仍會執行，由模型決定該做什麼。
  • 如果代理回覆 HEARTBEAT_OK（可選擇帶有短填充；請參閱 agents.defaults.heartbeat.ackMaxChars），OpenClaw 將抑制該心跳的發送。
  • 根據預設，允許將心跳發送到 DM 風格的 user:<id> 目標。設定 agents.defaults.heartbeat.directPolicy: "block" 以抑制直接目標發送，同時保持心跳執行啟用。
  • 心跳會執行完整的代理輪次 — 較短的間隔會消耗更多的 token。
{
  agent: {
    heartbeat: { every: "30m" },
  },
}

媒體輸入與輸出

Section titled “媒體輸入與輸出”

入站附件（圖片/音訊/文件）可以透過範本顯示給您的指令：

  • {{MediaPath}} (本機暫存檔案路徑)
  • {{MediaUrl}} (虛擬 URL)
  • {{Transcript}} (如果啟用了音訊轉錄)

來自代理的出站附件：在單獨的一行中包含 MEDIA:<path-or-url> (不要有空格)。範例：

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

OpenClaw 會提取這些內容，並將其作為媒體與文字一起發送。

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

  • 如果 tools.fs.workspaceOnly 是 true，傳出的 MEDIA: 本機路徑將僅限於 OpenClaw 臨時根目錄、媒體快取、代理程式工作區路徑以及沙箱產生的檔案。
  • 如果 tools.fs.workspaceOnly 是 false，傳出的 MEDIA: 可以使用代理程式已有權限讀取的主機本機檔案。
  • 從主機本機發送仍然僅允許媒體和安全文件類型（圖片、音訊、影片、PDF 和 Office 文件）。純文字和類似機密的檔案不被視為可發送的媒體。

這意味著當您的 fs 原則已允許讀取時，工作區外產生的圖片/檔案現在可以發送，而不會重新開放任意主機文字附件的外洩風險。

運作檢查清單

Section titled “運作檢查清單”
Terminal window
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）。

下一步

Section titled “下一步”