English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Templates

預設 AGENTS.md

首次執行（建議）

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

  1. 建立工作區（如果尚不存在）：
mkdir -p ~/.openclaw/workspace
  1. 將預設工作區範本複製到工作區：
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
  1. 選用：如果你想要個人助理技能清單，請用此檔案取代 AGENTS.md：
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 選用：透過設定 agents.defaults.workspace 選擇不同的工作區（支援 ~）：
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

安全預設值

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

工作階段開始（必要）

  • 讀取 SOUL.md、USER.md，以及 memory/ 中今天和昨天的內容。
  • 若存在，讀取 MEMORY.md。
  • 在回覆前完成。

Soul（必要）

  • SOUL.md 定義身分、語氣與界線。保持其最新狀態。
  • 如果你變更 SOUL.md，請告知使用者。
  • 每個工作階段你都是全新的執行個體；連續性存在於這些檔案中。

共享空間（建議）

  • 你不是使用者的代言人；在群組聊天或公開頻道中要謹慎。
  • 不要分享私人資料、聯絡資訊或內部筆記。

記憶系統（建議）

  • 每日紀錄：memory/YYYY-MM-DD.md（如有需要，建立 memory/）。
  • 長期記憶：MEMORY.md，用於持久保存事實、偏好與決策。
  • 小寫的 memory.md 只是舊版修復輸入；不要刻意同時保留兩個根目錄檔案。
  • 工作階段開始時，讀取今天 + 昨天 + MEMORY.md（若存在）。
  • 擷取：決策、偏好、限制、未完成事項。
  • 避免秘密資訊，除非明確要求。

工具與技能

  • 工具存在於 Skills 中；需要時請遵循每個技能的 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 讀寫聊天、擷取情境，並執行技能。
  • macOS app 管理權限（螢幕錄製、通知、麥克風），並透過其內建二進位檔提供 openclaw CLI。
  • 直接聊天預設會摺疊到代理程式的 main 工作階段；群組會維持隔離為 agent:<agentId>:<channel>:group:<id>（聊天室／頻道：agent:<agentId>:<channel>:channel:<id>）；Heartbeats 會讓背景工作保持存活。

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

  • mcporter - 用於管理外部技能後端的工具伺服器 runtime/CLI。
  • Peekaboo - 快速 macOS 螢幕截圖，並可選用 AI 視覺分析。
  • camsnap - 從 RTSP/ONVIF 安全攝影機擷取影格、片段或動作警報。
  • oracle - 支援工作階段重播與瀏覽器控制的 OpenAI-ready 代理程式 CLI。
  • eightctl - 從終端機控制你的睡眠。
  • imsg - 傳送、讀取、串流 iMessage 與 SMS。
  • wacli - WhatsApp CLI：同步、搜尋、傳送。
  • discord - Discord 動作：反應、貼圖、投票。使用 user:<id> 或 channel:<id> 目標（裸數字 ID 具有歧義）。
  • gog - Google Suite CLI：Gmail、Calendar、Drive、Contacts。
  • spotify-player - 終端機 Spotify 用戶端，用於搜尋／排入佇列／控制播放。
  • sag - ElevenLabs 語音，具備 mac 風格的 say UX；預設串流到喇叭。
  • Sonos CLI - 從腳本控制 Sonos 喇叭（探索／狀態／播放／音量／群組）。
  • blucli - 從腳本播放、群組化並自動化 BluOS 播放器。
  • OpenHue CLI - 用於場景與自動化的 Philips Hue 照明控制。
  • OpenAI Whisper - 本機語音轉文字，用於快速聽寫與語音信箱轉錄。
  • Gemini CLI - 從終端機使用 Google Gemini 模型進行快速問答。
  • agent-tools - 用於自動化與輔助腳本的實用工具組。

使用注意事項

  • 編寫腳本時優先使用 openclaw CLI；mac app 會處理權限。
  • 從 Skills 分頁執行安裝；如果二進位檔已存在，它會隱藏按鈕。
  • 保持 Heartbeats 啟用，讓助理可以排程提醒、監控收件匣，並觸發攝影機擷取。
  • Canvas UI 以全螢幕搭配原生覆疊執行。避免將關鍵控制項放在左上／右上／底部邊緣；在版面配置中加入明確的邊距，且不要依賴 safe-area insets。
  • 對於瀏覽器驅動的驗證，請使用 openclaw browser（tabs/status/screenshot），搭配 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（click/type 需要 snapshot refs；CSS selectors 請使用 evaluate）。

相關