設定你的 OpenClaw 個人助理

你是不是也常遇到這種情況：每次開啟新的 AI 對話，都要重新解釋你的工作流程、偏好設定，甚至連常用的 API 格式都要再講一遍？這種缺乏「持久記憶」的開發體驗真的很讓人挫折，就像每天都在跟一個患了失憶症的同事溝通，效率大打折扣。

OpenClaw 的設計就是為了打破這種循環。它讓 AI 助理擁有自己的 Workspace，能讀取你的歷史記憶、了解你的個性（Soul），並直接在你的 macOS 環境中執行具體的 Skill。

需要準備的東西

macOS 環境：用於執行 OpenClaw 應用程式與管理權限
OpenClaw CLI：透過應用程式內建的 binary 暴露
WhatsApp Gateway：如果你需要助理處理通訊軟體訊息

快速開始

只要 5 分鐘，你就能讓助理在本地端跑起來。OpenClaw 預設使用 ~/.openclaw/workspace 作為助理的工作目錄。

建立 Workspace 目錄：
Terminal window
```
mkdir -p ~/.openclaw/workspace
```

複製預設模板：將必要的設定檔放入 Workspace。

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

啟用個人助理 Skill 清單（選填）：如果你想要預設的技能組合，可以用這個檔案取代：
Terminal window
```
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
```
設定 Git 備份（推薦）：將 Workspace 變成 Git repo，確保你的記憶與設定不會遺失。
Terminal window
```
cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
```

如果你想更改 Workspace 路徑，可以在設定中修改 agents.defaults.workspace：

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

核心機制

靈魂與記憶 (Soul & Memory)

助理在每一節對話開始前，必須讀取 SOUL.md、USER.md、memory.md 以及最近兩天的記憶日誌。

SOUL.md：定義助理的身分、語氣與邊界。
Memory 系統：日誌存放在 memory/YYYY-MM-DD.md。助理會記錄你的偏好、決策與待辦事項。

安全規範

助理不會擅自將你的 secrets 或目錄內容傾倒至對話中。
除非你明確要求，否則助理不會執行具破壞性的指令。
對於外部訊息平台（如 WhatsApp），助理僅發送最終回覆，不發送中間的串流內容。

強大技能清單

你可以在 Settings → Skills 中啟用這些工具：

mcporter: 管理外部 Skill 後端的 runtime。
Peekaboo: 快速擷取 macOS 螢幕截圖並進行 AI 視覺分析。
camsnap: 從 RTSP/ONVIF 攝影機擷取畫面或動作偵測。
oracle: 具備瀏覽器控制能力的 Agent CLI。
wacli & imsg: 操控 WhatsApp 與 iMessage。
gog: 整合 Google Suite（Gmail, Calendar, Drive）。
spotify-player: 在終端機控制 Spotify 播放。
OpenHue & Sonos CLI: 控制智慧燈光與音響系統。

使用技巧

對於腳本自動化，建議優先使用 openclaw CLI。如果你需要進行瀏覽器操作，可以使用以下指令：

驗證與狀態：openclaw browser (tabs/status/screenshot)
DOM 檢查：openclaw browser eval|query|dom|snapshot
互動操作：openclaw browser click|type|hover|drag|navigate

疑難排解

找不到 Skill 安裝按鈕：如果你已經手動安裝了該 Skill 的 binary，OpenClaw 會自動隱藏安裝按鈕。
自動化任務失效：請檢查是否啟用了 Heartbeats，這是助理排程提醒、監控收件匣與觸發攝影機擷取的關鍵。
Canvas UI 顯示異常：由於 Canvas 採用全螢幕原生疊加，請避免將關鍵控制項放在螢幕的四個角落，並在佈局中手動加入 gutter，不要依賴 safe-area insets。

如果你在設定過程中遇到任何問題，可以詢問 AI Setup Assistant 獲取即時協助。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。