Guides
個人助理設定
OpenClaw 是一個自託管 Gateway，可將 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等連接到 AI agent。本指南涵蓋「個人助理」設定：一個專用的 WhatsApp 號碼，行為像是你隨時在線的 AI 助理。
⚠️ 安全第一
你正把一個 agent 放在可以執行下列操作的位置：
- 在你的機器上執行命令（取決於你的工具政策）
- 讀取/寫入工作區中的檔案
- 透過 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)
</b>
Your WhatsApp
+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)
</b>
Assistant WA
+1-555-ASSIST"]
B -- linked via QR --> C["<b>Your Mac (openclaw)
</b>
AI agent"]
如果你將個人 WhatsApp 連結到 OpenClaw，傳給你的每則訊息都會變成「agent 輸入」。這通常不是你想要的。
5 分鐘快速開始
- 配對 WhatsApp Web（顯示 QR；用助理手機掃描）：
openclaw channels login
- 啟動 Gateway（保持執行）：
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。
給 agent 一個工作區（AGENTS）
OpenClaw 會從其工作區目錄讀取操作指示與「記憶」。
預設情況下，OpenClaw 使用 ~/.openclaw/workspace 作為 agent 工作區，並會在設定/第一次 agent 執行時自動建立它（以及起始的 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md）。BOOTSTRAP.md 只會在工作區全新時建立（刪除後不應再次出現）。MEMORY.md 是選用的（不會自動建立）；存在時會在一般工作階段載入。Subagent 工作階段只會注入 AGENTS.md 和 TOOLS.md。
openclaw setup
完整工作區配置與備份指南：Agent 工作區 記憶工作流程：記憶
選用：使用 agents.defaults.workspace 選擇不同的工作區（支援 ~）。
{
agents: {
defaults: {
workspace: "~/.openclaw/workspace",
},
},
}
如果你已經從 repo 提供自己的工作區檔案，可以完全停用 bootstrap 檔案建立：
{
agents: {
defaults: {
skipBootstrap: true,
},
},
}
將它變成「助理」的設定
OpenClaw 預設已有良好的助理設定，但你通常會想調整：
SOUL.md中的人設/指示- 思考預設值（如有需要）
- Heartbeat（一旦你信任它）
範例：
{
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 - 工作階段中繼資料（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 仍會執行，並由模型決定要做什麼。
- 如果 agent 回覆
HEARTBEAT_OK（可選擇附帶短填充；參見agents.defaults.heartbeat.ackMaxChars），OpenClaw 會抑制該 Heartbeat 的對外傳送。 - 預設允許將 Heartbeat 傳送到 DM 風格的
user:<id>目標。設定agents.defaults.heartbeat.directPolicy: "block"可在保持 Heartbeat 執行啟用的同時，抑制直接目標傳送。 - Heartbeat 會執行完整的 agent 回合；較短的間隔會消耗更多 token。
{
agent: {
heartbeat: { every: "30m" },
},
}
媒體輸入與輸出
傳入附件（圖片/音訊/文件）可透過範本提供給你的命令：
{{MediaPath}}（本機暫存檔路徑）{{MediaUrl}}（偽 URL）{{Transcript}}（如果已啟用音訊轉錄）
來自 agent 的傳出附件：在獨立一行加入 MEDIA:<path-or-url>（不可有空格）。範例：
Here's the screenshot.
MEDIA:https://example.com/screenshot.png
OpenClaw 會擷取這些內容，並將它們作為媒體與文字一併傳送。
本機路徑行為遵循與 agent 相同的檔案讀取信任模型：
- 如果
tools.fs.workspaceOnly為true，傳出的MEDIA:本機路徑會受限於 OpenClaw 暫存根目錄、媒體快取、agent 工作區路徑，以及 sandbox 產生的檔案。 - 如果
tools.fs.workspaceOnly為false，傳出的MEDIA:可以使用 agent 已被允許讀取的主機本機檔案。 - 本機路徑可以是絕對路徑、工作區相對路徑，或使用
~/的家目錄相對路徑。 - 主機本機傳送仍然只允許媒體與安全文件類型（圖片、音訊、影片、PDF 與 Office 文件）。純文字與類似機密的檔案不會被視為可傳送媒體。
這表示當你的 fs 政策已允許讀取時，工作區外產生的圖片/檔案現在也可以傳送，而不會重新開啟任意主機文字附件外洩的風險。
操作檢查清單
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 操作：Gateway 執行手冊
- Cron + 喚醒：Cron 作業
- macOS 選單列搭配應用程式：OpenClaw macOS app
- iOS node 應用程式：iOS app
- Android node 應用程式：Android app
- Windows 狀態：Windows (WSL2)
- Linux 狀態：Linux app
- 安全性：安全性