> ## Documentation Index
> Fetch the complete documentation index at: https://claw-tw.jackle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Default AGENTS.md（預設 AGENTS.md）

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

## 首次執行（建議）

OpenClaw 為 Agent 使用專用的 Workspace 目錄。預設：`~/.openclaw/workspace`（可透過 `agents.defaults.workspace` 設定）。

1. 建立 Workspace（如果尚未存在）：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
mkdir -p ~/.openclaw/workspace
```

2. 將預設 Workspace 範本複製到 Workspace：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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. 選用：如果想要個人助手技能清單，請將此檔案替換 AGENTS.md：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
```

4. 選用：透過設定 `agents.defaults.workspace` 選擇不同的 Workspace（支援 `~`）：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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` 和記憶檔案被備份。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`）。