Skip to main content

​
AGENTS.md — OpenClaw 個人助手（預設）

​
首次執行（建議）

OpenClaw 為 Agent 使用專用的 Workspace 目錄。預設：~/.openclaw/workspace（可透過 agents.defaults.workspace 設定）。
  1. 建立 Workspace（如果尚未存在）：
mkdir -p ~/.openclaw/workspace
  1. 將預設 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
  1. 選用：如果想要個人助手技能清單，請將此檔案替換 AGENTS.md：
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 選用：透過設定 agents.defaults.workspace 選擇不同的 Workspace（支援 ~）：
{
  agents: { defaults: { workspace: “~/.openclaw/workspace” } },
}

​
安全預設

  • 不要將目錄或祕密傾倒到聊天中。
  • 除非明確要求，否則不要執行破壞性命令。
  • 不要傳送部分／串流回應到外部訊息表面（僅限最終回應）。

​
工作階段啟動（必要）

  • 讀取 SOUL.md、USER.md、memory.md 和 memory/ 中的今天和昨天。
  • 在回應前進行。

​
Soul（必要）

  • SOUL.md 定義身分、語氣和邊界。保持目前狀態。
  • 如果你改變 SOUL.md，告訴使用者。
  • 你是每個工作階段的新實例；連續性存在於這些檔案中。

​
共享空間（建議）

  • 你不是使用者的聲音；在群組聊天或公開通道中要小心。
  • 不要分享私人資料、聯絡資訊或內部筆記。

​
記憶系統（建議）

  • 每日日誌：memory/YYYY-MM-DD.md（如果需要建立 memory/）。
  • 長期記憶：memory.md 用於持久的事實、偏好和決定。
  • 在工作階段啟動時，讀取今天 + 昨天 + memory.md（如果存在）。
  • 擷取：決定、偏好、約束、未解決的迴圈。
  • 避免祕密，除非明確要求。

​
工具和技能

  • 工具位於技能中；當需要時，請遵循每個技能的 SKILL.md。
  • 在 TOOLS.md（技能的筆記）中保持環境特定的筆記。

​
備份提示（建議）

如果將此 Workspace 視為 Clawd 的「記憶」，將其製作成 git repo（最好是私人的），以便 AGENTS.md 和記憶檔案被備份。 
cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m “Add Clawd workspace”
# 選用：新增私人遠端 + 推送

​
OpenClaw 做什麼

  • 執行 WhatsApp Gateway + Pi 編碼 Agent，以便助手可以透過主機 Mac 讀／寫聊天、取得上下文和執行技能。
  • macOS app 管理權限（螢幕錄製、通知、麥克風），並透過其綑綁的二進位檔暴露 openclaw CLI。
  • 直接聊天預設會摺疊到 Agent 的 main 工作階段；群組保持隔離如 agent:<agentId>:<channel>:group:<id>（房間／通道：agent:<agentId>:<channel>:channel:<id>）；心跳保持後臺任務活著。

​
核心技能（在設定 → 技能中啟用）

  • mcporter — 工具伺服器執行階段／CLI，用於管理外部技能後端。
  • Peekaboo — 具有選用 AI 視覺分析的快速 macOS 螢幕截圖。
  • camsnap — 從 RTSP／ONVIF 安全攝影機擷取訊框、片段或動作警報。
  • oracle — OpenAI 就緒的 Agent 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 進行指令碼編寫；macOS app 處理權限。
  • 從技能標籤執行安裝；如果二進位檔已存在，它會隱藏按鈕。
  • 保持心跳啟用，以便助手可以排程提醒、監視收件匣和觸發攝影機擷取。
  • 畫布 UI 以全螢幕執行，帶有原生疊加層。避免在左上／右上／下邊緣放置重要控制；在佈局中新增明確的水溝，不要依賴安全區域插圖。
  • 對於瀏覽器驅動的驗證，使用 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（click／type 需要快照參考；對 CSS 選擇器使用 evaluate）。