Aiko
1
以下是根據官方文檔和社群最佳實踐整理的 OpenClaw 必知指令與技巧完整清單：
一、核心 CLI 指令
| 指令 |
說明 |
使用時機 |
npm install -g openclaw@latest |
全域安裝 / 更新至最新版 |
首次安裝或升級 |
openclaw onboard --install-daemon |
互動式設定精靈 + 安裝為背景服務（開機自動啟動），最常見的首次執行指令 |
首次設定 |
openclaw configure |
重新執行特定設定步驟 |
變更設定 |
openclaw doctor --deep --yes |
最實用的單一指令，任何設定變更後、升級後、Gateway 異常時都應執行 |
日常除錯首選 |
openclaw gateway start |
啟動 WebSocket Gateway |
手動啟動服務 |
openclaw gateway restart |
套用設定變更的標準方式，大多數除錯步驟最終都會用到它 |
改完設定後必跑 |
openclaw gateway status |
確認 Gateway 運行狀態、監聽 Port、連線資訊 |
狀態確認 |
openclaw logs --follow |
即時追蹤 Gateway 日誌 |
即時監控 / 除錯 |
openclaw logs --json --limit 200 |
JSON 格式輸出最近 200 筆日誌 |
腳本分析 |
openclaw status --usage |
列出完整 Provider 用量明細（Anthropic、OpenAI、Gemini 等） |
成本監控 |
二、頻道管理
| 指令 |
說明 |
openclaw channels list |
列出所有已設定頻道 |
openclaw channels status --probe |
探測各頻道連線狀態 |
openclaw channels add --channel telegram --token $TOK |
新增 Telegram 頻道 |
openclaw channels login |
WhatsApp QR Code 掃碼登入 |
openclaw channels add --channel discord --token $TOK |
新增 Discord 頻道 |
社群提示：Telegram 是最簡單穩定的路徑，WhatsApp 和 Discord 在可靠性、語音、群組工作流方面各有不同取捨
三、Agent 管理
| 指令 |
說明 |
openclaw agents list --bindings |
列出所有 Agent 及路由綁定 |
openclaw agents add <name> --workspace <path> --non-interactive |
新增 Agent，--non-interactive 跳過確認提示，適合批次 / 腳本自動化 |
openclaw agents delete <name> |
移除 Agent（不刪除工作區檔案） |
openclaw agent --agent <name> --message "..." |
向特定 Agent 發送單次訊息 |
openclaw chat |
不帶訊息參數時，啟動互動式聊天 session |
關鍵區別：agents（複數）是管理面板，用於列出、新增、移除；agent（單數）是聊天視窗，用於發送訊息
四、模型與認證
| 指令 |
說明 |
openclaw models auth paste-token --provider anthropic |
設定 Anthropic API Key |
openclaw models auth paste-token --provider openai |
設定 OpenAI API Key |
openclaw models list |
列出可用模型 |
openclaw models set <model> |
切換預設模型 |
openclaw models fallbacks add <model> |
新增模型回退方案 |
openclaw models scan |
掃描可用 Provider |
五、技能與外掛
| 指令 |
說明 |
openclaw skills list |
列出已安裝技能 |
openclaw skills install <slug> |
安裝捆綁技能 |
clawhub install <slug> |
從 ClawHub 市集安裝技能 |
clawhub update --all |
更新所有 ClawHub 技能 |
clawhub search <keyword> |
搜尋市集技能 |
openclaw plugins list |
列出外掛 |
openclaw plugins enable/disable <name> |
啟用 / 停用外掛 |
六、排程與自動化（Cron）
| 指令 |
說明 |
openclaw cron list |
列出所有排程任務 |
openclaw cron add --name "daily-summary" --at "2026-03-12T09:00:00Z" --system-event "..." |
建立定時任務 |
openclaw cron run <id> |
手動觸發排程 |
openclaw cron enable/disable <id> |
啟用 / 停用排程 |
注意：失敗的排程任務會用指數退避重試：30 秒 → 1 分鐘 → 5 分鐘 → 15 分鐘 → 60 分鐘
七、Slash 指令（聊天內使用）
| 指令 |
說明 |
/new |
重置 session，開始新對話 |
/status |
顯示當前狀態，包含 Provider 用量/配額 |
/context list |
檢視 context window 中各檔案佔用 |
/context detail |
顯示每個檔案 + 工具 + 技能 + system prompt 的大小明細 |
/compact |
手動觸發長對話壓縮 |
/stop |
中止當前執行的動作 |
:think high |
設定思考等級 |
:model opus |
臨時切換模型 |
:send off |
暫停訊息發送 |
:verbose |
開啟詳細模式 |
/tts on / /tts off |
開關語音合成 |
/export-session |
匯出當前 session 為 HTML（含完整 system prompt） |
/skill <name> [input] |
按名稱執行技能 |
自然語言中止：輸入「stop openclaw」、「please stop」、「STOP!」即可中止，支援中/英/日/西/法/德/阿等語言
八、工作區核心檔案
| 檔案 |
用途 |
關鍵提示 |
SOUL.md |
Agent 的人格、語氣、價值觀——「角色設定表」，每個 session 載入 |
保持在 2,000 字以內；先寫 10 行，只在發現問題時才加規則 |
AGENTS.md |
運作方式——記憶管理、安全規則、何時發言/沉默的 SOP |
定義每個 session 啟動時的讀取順序 |
USER.md |
使用者資訊——姓名、時區、工作脈絡、溝通偏好 |
越具體，Agent 表現越好 |
MEMORY.md |
長期記憶——Agent 日積月累學到的偏好和脈絡 |
定期策展，避免膨脹 |
TOOLS.md |
工具說明與使用指引 |
告訴 Agent 可用工具及使用規則 |
HEARTBEAT.md |
定期檢查（預設 30 分鐘），讀取後只在需要時才通知 |
用低成本模型執行以節省費用 |
IDENTITY.md |
Agent 對外身分資訊 |
多 Agent 場景下的識別 |
BOOTSTRAP.md |
首次執行設定腳本 |
引導式身分建立 |
九、設定與重置
| 指令 |
說明 |
openclaw config get <key> |
讀取設定值 |
openclaw config set <key> <value> |
寫入設定值 |
openclaw reset --scope config |
只重置設定（保留 session 和憑證） |
openclaw reset --scope config+creds+sessions |
重置設定 + 憑證 + session（保留工作區） |
openclaw reset --scope full |
完全重置（含工作區）——核彈選項 |
openclaw backup create |
建立備份 |
openclaw security audit |
安全性稽核 |
熱載入提示：以下設定無需重啟即生效：模型和回退變更、Agent 設定、頻道政策、cron 排程、heartbeat 間隔、工具設定、大多數 session 設定
十、進階技巧與生產環境必知
| 技巧 |
說明 |
| 成本控制 |
每次 heartbeat 重載所有工作區檔案（4,000–10,000 tokens）；記憶壓縮每次吃 10,000–25,000 tokens。保持 SOUL.md 500 行以內，策展記憶檔，heartbeat 用便宜模型 |
| 安全基線 |
Gateway 綁定 localhost、啟用 auth、開啟 sandbox、設定 allowFrom 白名單 |
| Session 隔離 |
多使用者信箱務必使用 per-channel-peer 以防止 context 洩漏 |
| 讓 Agent 寫自己的 SOUL |
使用一週後，問 Agent：「根據我們目前的互動，建議改進你的 SOUL.md」——它通常能找到你遺漏的缺口 |
| 全域 Flag |
--json（JSON 輸出）、--no-color（無色彩）、--profile <name>（切換設定檔），適用所有指令 |
| 記憶策略 |
每天結束時 Agent 寫筆記到 memory/YYYY-MM-DD.md，重要內容策展到 MEMORY.md 長期記憶 |
| 除錯三連發 |
openclaw doctor → openclaw logs --follow → openclaw gateway restart（社群公認解決 90% 問題的流程） |
agents vs agent |
前者管理（admin），後者聊天（chat）——搞混會出錯 |
| 檔案位置 |
設定檔：~/.openclaw/openclaw.json（JSON5 格式，支援註解和尾逗號）；工作區：~/.openclaw/workspace/ |
這份清單涵蓋了從安裝到生產環境的所有關鍵指令，直接對應你在 Mac Mini M4 上運行 OpenClaw 多代理系統的場景。需要我針對任何特定類別展開更詳細的設定範例嗎？