預設 AGENTS.md

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

首次執行（建議）

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

建立工作區（如果尚未存在）：

mkdir -p ~/.openclaw/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

選用：如果您想要個人助理技能清單，請將此檔案替換 AGENTS.md：

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

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

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

安全性預設值

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

階段開始（必要）

讀取 SOUL.md、USER.md 以及 memory/ 中的今天與昨天。
當 MEMORY.md 存在時讀取它；只有在 MEMORY.md 不存在時，才改用小寫的 memory.md。
在回應之前完成此操作。

靈魂（必要）

SOUL.md 定義了身份、語氣和邊界。請保持其最新狀態。
如果您變更了 SOUL.md，請告知使用者。
您在每次會話中都是一個全新的實例；連續性存在於這些檔案中。

共享空間（建議）

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

記憶系統（建議）

每日日誌：memory/YYYY-MM-DD.md（如有需要，請建立 memory/）。
長期記憶：MEMORY.md 用於持久的事實、偏好和決策。
小寫 memory.md 僅作為舊版備援；不要故意保留這兩個根檔案。
會話開始時，讀取今天 + 昨天 + MEMORY.md（如果存在），否則讀取 memory.md。
捕捉：決策、偏好、約束、未結事項。
除非明確要求，否則避免涉及秘密。

工具與技能

工具存於技能之中；需要時請遵循各技能的 SKILL.md。
將特定環境的筆記保留在 TOOLS.md（技能筆記）中。

備份提示（建議）

如果您將此工作區視為 Clawd 的「記憶」，請將其設為 git 儲存庫（最好是私有的），以便 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 閘道 + Pi 編碼代理，讓助理可以讀寫聊天、獲取上下文，並透過主機 Mac 執行技能。
macOS 應用程式管理權限（螢幕錄製、通知、麥克風），並透過其內建的二進位檔公開 openclaw CLI。
直接聊天預設會合併到代理的 main 會話中；群組則保持隔離為 agent:<agentId>:<channel>:group:<id>（房間/頻道：agent:<agentId>:<channel>:channel:<id>）；心跳訊號讓背景任務保持運作。

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

mcporter — 用於管理外部技能後端的工具伺服器執行時/CLI。
Peekaboo — 快速的 macOS 螢幕截圖，可選擇搭配 AI 視覺分析。
camsnap — 從 RTSP/ONVIF 監視器擷取影格、片段或動作警報。
oracle — OpenAI 相容的代理 CLI，具備會話重播和瀏覽器控制功能。
eightctl — 從終端機控制您的睡眠。
imsg — 傳送、讀取、串流 iMessage 和 SMS。
wacli — WhatsApp CLI：同步、搜尋、傳送。
discord — Discord 動作：回應、貼圖、投票。請使用 user:<id> 或 channel:<id> 目標（純數字 id 易生歧義）。
gog — Google Suite CLI：Gmail、日曆、雲端硬碟、聯絡人。
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 分頁執行安裝；如果二進位檔案已存在，它會隱藏按鈕。
請保持啟用心跳，以便助理能夠排程提醒、監控收件匣並觸發相機擷取。
Canvas 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 (點擊/輸入需要快照參照；請使用 evaluate 來指定 CSS 選擇器)。