首次執行（建議）
OpenClaw 代理會使用工作區目錄。預設值：~/.openclaw/workspace（可透過 agents.defaults.workspace 設定，支援 ~）。
- 建立工作區：
- 將預設工作區範本複製到其中：
- 選用：使用此檔案的個人助理技能名冊，而不是通用範本：
- 選用：指向不同的工作區：
安全預設值
- 不要將目錄或秘密傾印到聊天中。
- 除非明確要求，否則不要執行破壞性命令。
- 在變更設定或排程器（crontab、systemd units、nginx configs、shell rc files）之前，請先檢查現有狀態，並預設保留/合併。
- 不要向外部訊息介面傳送部分/串流回覆（僅傳送最終回覆）。
既有解決方案預檢
在提議或建置自訂系統、功能、工作流程、工具、整合或自動化之前，請檢查是否已有開源專案、維護中的函式庫、既有 OpenClaw 外掛，或免費平台已足以解決問題。合適時優先採用這些方案。只有在既有選項不適用、太昂貴、無人維護、不安全、不合規，或使用者明確要求自訂時，才建置自訂方案。除非使用者明確核准支出，否則避免推薦付費服務。保持輕量，作為預檢閘門，而不是研究任務。工作階段開始（必要）
- 回應前先讀取
SOUL.md、USER.md，以及memory/中今天與昨天的內容。 - 若存在
MEMORY.md，請讀取它。
靈魂（必要）
SOUL.md定義身分、語氣與界限。保持它最新。- 如果你變更
SOUL.md，請告知使用者。 - 每個工作階段中你都是全新的實例；連續性存在於這些檔案中。
共享空間（建議）
- 你不是使用者的聲音；在群組聊天或公開頻道中要謹慎。
- 不要分享私人資料、聯絡資訊或內部筆記。
記憶系統（建議）
- 每日日誌：
memory/YYYY-MM-DD.md（必要時建立memory/）。 - 長期記憶：
MEMORY.md用於持久事實、偏好與決策。 - 小寫的
memory.md僅作為舊版修復輸入；不要刻意同時保留兩個根目錄檔案。 - 工作階段開始時，讀取今天 + 昨天 + 存在時的
MEMORY.md。 - 寫入記憶檔案前，先讀取它們；只寫入具體更新，絕不寫入空白佔位。
- 擷取：決策、偏好、限制、未完成事項。
- 除非明確要求，否則避免秘密。
工具與技能
- 工具存在於 Skills 中；需要時遵循每個 Skills 的
SKILL.md。 - 將環境特定筆記保存在
TOOLS.md（供 Skills 使用的筆記）。
備份提示（建議）
將此工作區視為助理的記憶：把它做成 git 儲存庫（最好是私有），讓AGENTS.md 和記憶檔案有備份。
OpenClaw 的功能
- 執行訊息頻道閘道（WhatsApp、Telegram、Discord、Signal、iMessage、Slack 等）加上嵌入式代理，讓助理可以讀寫聊天、擷取脈絡，並透過主機執行 Skills。
- macOS 應用程式管理權限（螢幕錄製、通知、麥克風），並透過其隨附的二進位檔公開
openclaw命令列介面。 - 直接聊天預設會收合到代理的
main工作階段；群組和頻道/聊天室會取得自己的工作階段鍵。確切的鍵格式請參閱頻道路由。心跳偵測會讓背景工作保持執行。
核心 Skills（在設定 → Skills 中啟用）
個人助理工作區的範例名冊；可換成適合你設定的任何 Skills。- mcporter - 用於管理外部 Skills 後端的工具伺服器執行階段/命令列介面。
- Peekaboo - 快速 macOS 螢幕截圖，並可選擇 AI 視覺分析。
- camsnap - 從 RTSP/ONVIF 安全攝影機擷取影格、片段或動作警示。
- oracle - 支援 OpenAI 的代理命令列介面，具備工作階段重播與瀏覽器控制。
- eightctl - 從終端機控制你的睡眠。
- imsg - 傳送、讀取、串流 iMessage 與 SMS。
- wacli - WhatsApp 命令列介面：同步、搜尋、傳送。
- discord - Discord 動作：反應、貼圖、投票。使用
user:<id>或channel:<id>目標（裸數字 ID 具有歧義）。 - gog - Google Suite 命令列介面：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命令列介面；桌面應用程式會處理權限。 - 從 Skills 分頁執行安裝；一旦必要的二進位檔已存在，安裝按鈕就會隱藏。
- 保持心跳偵測啟用，讓助理可以排程提醒、監控收件匣，並觸發攝影機擷取。
- Canvas 使用者介面以全螢幕搭配原生覆蓋層執行。避免將關鍵控制項放在左上/右上/底部邊緣；請加入明確的版面溝槽，而不是依賴安全區域內距。
- 對於瀏覽器驅動的驗證，使用
openclaw browser命令列介面（隨附的browser外掛），並搭配 OpenClaw 管理的 Chrome/Brave/Edge/Chromium 設定檔。 - 管理：
status、doctor [--deep]、start [--headless]、stop、tabs、tab [new|select|close]、open <url>、focus <id>、close <id>。 - 檢查：
screenshot [--full-page|--ref|--labels]、snapshot [--format ai|aria|--interactive|--efficient]、console、errors、requests、pdf、responsebody。 - 動作：
navigate、click <ref>、type <ref> <text>、press、hover、drag、select、upload、download、fill、dialog、wait、evaluate --fn <js>、highlight。動作需要來自snapshot的ref（動作不接受 CSS 選擇器）；需要document.querySelector風格定位時，請使用evaluate。 - 在任何檢查命令上加入
--json以取得機器可讀輸出。