OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Templates

預設 AGENTS.md

首次執行（建議）

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

  1. 建立工作區：
bash
mkdir -p ~/.openclaw/workspace
  1. 將預設工作區範本複製至其中：
bash
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md
  1. 選用：使用此檔案的個人助理技能清單，而非通用範本：
bash
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 選用：指定其他工作區：
json5
{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

預設安全設定

  • 不要將目錄內容或機密資訊傾印至聊天中。
  • 除非明確要求，否則不要執行具破壞性的命令。
  • 變更設定或排程器（crontab、systemd 單元、nginx 設定、shell rc 檔案）之前，請先檢查現有狀態，並預設保留或合併既有內容。
  • 不要將部分或串流中的回覆傳送至外部訊息介面（僅傳送最終回覆）。

現有解決方案預檢

在提議或建置自訂系統、功能、工作流程、工具、整合或自動化之前，請檢查是否已有能充分解決需求的開放原始碼專案、持續維護的函式庫、現有 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 的 SKILL.md。
  • 將環境特定的備註保存在 TOOLS.md（供 Skills 使用的備註）。

備份提示（建議）

將此工作區視為助理的記憶：把它建立為 git 儲存庫（最好設為私人），以便備份 AGENTS.md 與記憶檔案。

bash
cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Add workspace"# 選用：新增私人遠端儲存庫並推送

OpenClaw 的功能

  • 執行訊息頻道閘道（WhatsApp、Telegram、Discord、Signal、iMessage、Slack 等）及內嵌代理程式，讓助理可讀寫聊天內容、擷取上下文，並透過主機執行 Skills。
  • macOS 應用程式管理權限（螢幕錄製、通知、麥克風），並透過其隨附的二進位檔提供 openclaw 命令列介面。
  • 直接聊天預設會合併至代理程式的 main 工作階段；群組與頻道／聊天室則各自使用獨立的工作階段金鑰。確切的金鑰格式請參閱頻道路由。心跳偵測會讓背景工作持續運作。

核心 Skills（在 Settings → Skills 中啟用）

以下是個人助理工作區的清單範例；請替換為適合你設定的 Skills。

  • mcporter - 用於管理外部 Skill 後端的工具伺服器執行環境／命令列介面。
  • Peekaboo - 快速擷取 macOS 螢幕畫面，並可選用 AI 視覺分析。
  • camsnap - 從 RTSP/ONVIF 安全攝影機擷取影格、短片或動態警示。
  • oracle - 支援 OpenAI 的代理程式命令列介面，具備工作階段重播與瀏覽器控制功能。
  • eightctl - 從終端機控制你的睡眠。
  • imsg - 傳送、讀取及串流 iMessage 與 SMS。
  • wacli - WhatsApp 命令列介面：同步、搜尋、傳送。
  • discord - Discord 操作：回應、貼圖、投票。請使用 user:<id> 或 channel:<id> 目標（單獨的數字識別碼會有歧義）。
  • gog - Google Suite 命令列介面：Gmail、Calendar、Drive、Contacts。
  • spotify-player - 終端機 Spotify 用戶端，可搜尋、加入佇列及控制播放。
  • sag - ElevenLabs 語音工具，提供類似 macOS 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，即可取得機器可讀的輸出。

相關內容

Was this useful?
On this page

On this page