跳轉到主要內容

​
使用 OpenClaw 建立個人助理

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

​
⚠️ 安全優先

你正在讓一個代理程式處於可以：
  • 在你的機器上執行指令（取決於你的 Pi 工具設定）
  • 讀取／寫入你工作區中的檔案
  • 透過 WhatsApp／Telegram／Discord／Mattermost（外掛）向外傳送訊息
從保守開始：
  • 一律設定 channels.whatsapp.allowFrom（切勿在你的個人 Mac 上對全世界開放）。
  • 為助理使用專用的 WhatsApp 號碼。
  • 心跳現在預設為每 30 分鐘一次。 心跳現在預設為每 30 分鐘一次。 心跳目前預設為每 30 分鐘一次。在你信任此設定之前，請透過設定 agents.defaults.heartbeat.every: "0m" 停用。

​
先決條件

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

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

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

​
5 分鐘快速開始

  1. 配對 WhatsApp Web（顯示 QR；用助理手機掃描）：
openclaw channels login
  1. 啟動 Gateway 閘道器（保持執行）：
openclaw gateway --port 18789
  1. 在 ~/.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。 BOOTSTRAP.md 只會在工作區全新時建立（刪除後不應再次出現）。 MEMORY.md 是選用的（不會自動建立）；存在時，會在一般工作階段中載入。 子代理工作階段只會注入 AGENTS.md 和 TOOLS.md。 提示：將此資料夾視為 OpenClaw 的「記憶」，並將其設為 git repo（理想情況下為私有），以便備份你的 AGENTS.md 與記憶檔案。若已安裝 git，全新的工作區會自動初始化。 如果已安裝 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）。

​
後續步驟