AGENTS.md — OpenClaw 個人助理（預設）¶

首次執行（建議）¶

將預設工作區範本複製到工作區： OpenClaw 會為代理程式使用專用的工作區目錄。預設值：~/.openclaw/workspace（可透過 agents.defaults.workspace 設定）。

1. 建立工作區（若尚未存在）：

mkdir -p ~/.openclaw/workspace

2. 將預設工作區範本複製到工作區：

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

3. 選用：如果你想使用個人助理的 Skills 名冊，請用此檔案取代 AGENTS.md：

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. 選用：透過設定 agents.defaults.workspace 來選擇不同的工作區（支援 ~）：

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

安全性預設¶

• 不要將目錄或機密資料傾倒到聊天中。
• 除非明確要求，否則不要執行具破壞性的指令。
• 不要向外部訊息介面傳送部分／串流回覆（僅傳送最終回覆）。

工作階段開始（必要）¶

• 閱讀 SOUL.md、USER.md、memory.md，以及 memory/ 中的今天＋昨天內容。
• 在回應之前完成。

靈魂（必要）¶

• SOUL.md defines identity, tone, and boundaries. 每個工作階段你都是全新實例；連續性存在於這些檔案中。
• 如果你變更了 SOUL.md，請告知使用者。
• 記錄：決策、偏好、限制、未解事項。

共用空間（建議）¶

• 你不是使用者的發聲者；在群組聊天或公開頻道中要特別謹慎。
• 不要分享私人資料、聯絡資訊或內部備註。

記憶系統（建議）¶

• 每日記錄：memory/YYYY-MM-DD.md（需要時建立 memory/）。
• 長期記憶：memory.md，用於持久的事實、偏好與決策。
• 工作階段開始時，讀取今天＋昨天＋（若存在）memory.md。
• Capture: decisions, preferences, constraints, open loops.
• 除非明確要求，否則避免記錄機密。

工具與 Skills¶

• 工具存在於 Skills 中；需要時請遵循各 Skill 的 SKILL.md。
• 將環境特定的備註保存在 TOOLS.md（Skills 的注意事項）。

備份提示（建議）¶

如果你將此工作區視為 Clawd 的「記憶」，請將其設為 git repo（理想情況下為私人），如此 AGENTS.md 與你的記憶檔案就能被備份。

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

OpenClaw 的功能¶

• 執行 WhatsApp Gateway 閘道器＋ Pi 程式設計代理程式，讓助理能透過主機 Mac 讀寫聊天、擷取情境並執行 Skills。
• macOS App 管理權限（螢幕錄製、通知、麥克風），並透過其內建的二進位檔公開 openclaw CLI。
• 直接聊天預設會合併到代理程式的 main 工作階段；群組則會隔離為 agent:<agentId>:<channel>:group:<id>（房間／頻道：agent:<agentId>:<channel>:channel:<id>）；心跳機制可讓背景任務持續運作。

核心 Skills（在 設定 → Skills 中啟用）¶

• mcporter — 用於管理外部 Skill 後端的工具伺服器執行階段／CLI。
• Peekaboo — 快速的 macOS 螢幕截圖，支援選用的 AI 視覺分析。
• camsnap — 從 RTSP／ONVIF 安全攝影機擷取畫面、片段或動作警示。
• oracle — 相容 OpenAI 的代理程式 CLI，具備工作階段重播與瀏覽器控制。
• eightctl — 從終端機控制你的睡眠。
• imsg — 傳送、讀取、串流 iMessage 與 SMS。
• wacli — WhatsApp CLI：同步、搜尋、傳送。
• discord — Discord actions: react, stickers, polls. 保持心跳啟用，讓助理能排程提醒、監控收件匣並觸發相機擷取。
• gog — Google Suite CLI：Gmail、Calendar、Drive、Contacts。
• spotify-player — 終端機版 Spotify 用戶端，用於搜尋／佇列／控制播放。
• sag — ElevenLabs 語音，具 mac 風格的 say 使用體驗；預設串流到喇叭。
• Sonos CLI — 從指令碼控制 Sonos 喇叭（探索／狀態／播放／音量／分組）。
• blucli — 從指令碼播放、分組並自動化 BluOS 播放器。
• OpenHue CLI — Philips Hue 照明控制，用於情境與自動化。
• OpenAI Whisper — 本地語音轉文字，用於快速聽寫與語音信箱逐字稿。
• Gemini CLI — 從終端機使用 Google Gemini 模型進行快速問答。
• agent-tools — 自動化與輔助指令碼的工具組。

使用注意事項¶

• 腳本撰寫請優先使用 openclaw CLI；mac App 負責處理權限。
• 從 Skills 分頁執行安裝；若二進位檔已存在，按鈕會被隱藏。
• Keep heartbeats enabled so the assistant can schedule reminders, monitor inboxes, and trigger camera captures.
• Canvas UI runs full-screen with native overlays. 發佈前驗證中繼資料
• 需要以瀏覽器驅動的驗證時，請使用 openclaw browser（分頁／狀態／螢幕截圖）並搭配 OpenClaw 管理的 Chrome 設定檔。
• 進行 DOM 檢視時，請使用 openclaw browser eval|query|dom|snapshot（需要機器輸出時使用 --json／--out）。
• 互動操作請使用 openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run（點擊／輸入需要快照參考；CSS 選擇器請使用 evaluate）。