OpenClaw CLI核心子命令完整手冊2026：onboard / doctor / sessions / logs 每個指令詳細說明
說明：OpenClaw 除了在聊天視窗中使用的斜線指令（如 /model、/think），還有一套完整的 CLI（命令列介面）子命令系統，用於管理和診斷 OpenClaw 本身的運行。本文是這些 CLI 子命令的完整中文手冊，幫助你掌握每個指令的用途和正確使用方式。
OpenClaw CLI 指令架構概覽
安裝 OpenClaw 後，在終端機中輸入 openclaw --help 可以看到所有可用的子命令。整體架構如下：
$ openclaw --help
Usage: openclaw [command] [options]
Commands:
onboard 初始化設定，引導完成首次配置
gateway 管理 gateway 後台服務
doctor 診斷系統問題並自動修復
sessions 管理多個對話 Session
memory 查看和管理持久記憶
logs 查看執行日誌
skills 安裝和管理技能插件
models 查看和切換 AI 模型
update 更新 OpenClaw 至最新版本
uninstall 解除安裝 OpenClaw
Options:
--version 顯示目前版本號
--help 顯示說明文件
--verbose 詳細輸出模式
openclaw onboard — 初始化與重新設定
openclaw onboard 是你和 OpenClaw 的「第一次見面」——這個指令會引導你完成 AI 模型配置、通訊平台連接、個人喜好設定等所有初始化步驟。但它不只是給新用戶用的，熟悉之後你也會需要重新執行它。
基本用法
# 完整引導流程（新用戶使用）
openclaw onboard
# 只重新設定特定部分
openclaw onboard --model # 只重新選擇 AI 模型
openclaw onboard --platform # 只重新設定通訊平台
openclaw onboard --persona # 只重新設定 AI 人格
# 靜默模式（使用現有設定，不互動）
openclaw onboard --yes
onboard 引導流程的每個步驟
AI 模型選擇
選擇主要使用的 AI 模型（Claude / OpenAI GPT / 本地 Ollama 模型），並輸入相對應的 API Key 或 OAuth Token。
通訊平台連接
選擇你要用來和 AI 對話的平台（Telegram / Discord / WhatsApp / iMessage 等），並完成相對應的 Bot Token 或 API 設定。
AI 人格設定
為你的 AI 助理命名（如 Jarvis、Claudia、Ema），設定它的性格特質和溝通風格，這些設定會寫入 SOUL.md。
Gateway 啟動
自動啟動 gateway 後台服務，建立 AI 助理和通訊平台之間的橋接。完成後可以發送第一條訊息測試。
⚠️ 什麼時候需要重新執行 onboard？
- ✅ 更換主要 AI 模型（如從 Claude 切換到 GPT）
- ✅ 更換通訊平台（如從 Telegram 換到 Discord）
- ✅ API Key 過期或變更
- ✅ 從舊電腦遷移到新電腦
- ✅ 設定損壞想要從頭開始
openclaw doctor — 自動診斷與修復
openclaw doctor 是 OpenClaw 的「健康檢查工具」，可以自動掃描系統配置、連線狀態、API 認證等各個環節，找出問題並提供修復建議或自動修復。這是遇到任何問題時最應該第一時間執行的指令。
基本用法
# 執行完整健康檢查（顯示報告，不修復）
openclaw doctor
# 自動修復所有可修復的問題
openclaw doctor --fix
# 只檢查特定項目
openclaw doctor --check gateway # 只檢查 gateway
openclaw doctor --check api # 只檢查 API 連線
openclaw doctor --check memory # 只檢查記憶系統
openclaw doctor --check platform # 只檢查通訊平台連線
# 詳細模式（顯示更多診斷資訊）
openclaw doctor --verbose
doctor 檢查的項目
Gateway 狀態
- • Gateway 程序是否在運行
- • 埠號是否被佔用
- • Token 是否同步（1008 錯誤源頭）
- • 開機自啟動設定是否正常
API 認證狀態
- • Claude / OpenAI API Key 是否有效
- • OAuth Token 是否過期
- • Copilot 代理設定是否正常
- • 本地模型（Ollama）是否可連線
通訊平台連線
- • Telegram Bot Token 是否有效
- • Discord Bot 權限是否足夠
- • WhatsApp / iMessage 連線狀態
- • 接收和傳送測試訊息
記憶系統
- • 持久記憶文件是否完整
- • SOUL.md 格式是否正確
- • 記憶資料庫是否損壞
- • 向量索引是否需要重建
doctor 輸出範例
$ openclaw doctor
OpenClaw Health Check v2026.3.1
================================
[✅] Gateway: Running (PID: 12847, uptime: 3d 14h)
[✅] Gateway Token: Synchronized
[✅] Claude API: Connected (claude-3-5-sonnet-20241022)
[⚠️] OpenAI API: Key not configured (fallback unavailable)
[✅] Telegram: Connected (@YourBotName)
[✅] Memory System: 247 memories, no corruption detected
[❌] SOUL.md: Parse warning - timezone not specified (defaulting to UTC)
[✅] Skills: 8 installed, 8 active
[✅] Node.js: v22.14.0 (compatible)
Issues found: 2
- WARNING: OpenAI API key not configured. No fallback if Claude fails.
- ERROR: SOUL.md timezone missing. Heartbeat may trigger at wrong time.
Run 'openclaw doctor --fix' to attempt automatic repair.
openclaw sessions — 多 Session 管理
openclaw sessions 讓你管理多個平行的對話 Session。可以想像成不同的「工作桌面」——工作任務、個人事務、創意寫作可以分別在不同的 Session 中進行，各自有獨立的上下文和焦點，不會互相干擾。
基本用法
# 列出所有 Session
openclaw sessions list
# 建立新的 Session
openclaw sessions new work # 建立名為 "work" 的 Session
openclaw sessions new personal # 建立名為 "personal" 的 Session
# 切換到特定 Session
openclaw sessions switch work
# 查看目前 Session 資訊
openclaw sessions current
# 刪除 Session
openclaw sessions delete [session名稱]
# 將 Session 匯出備份
openclaw sessions export work --output work-backup.json
# 重新命名 Session
openclaw sessions rename work "work-project-2026"
sessions list 輸出範例
$ openclaw sessions list
Active Sessions:
================
* default (active) Messages: 342 Size: 128K Last: 2 min ago
work Messages: 89 Size: 45K Last: 3 hours ago
personal Messages: 156 Size: 67K Last: yesterday
side-project Messages: 23 Size: 12K Last: 3 days ago
Total: 4 sessions, 610 messages
(* = currently active)
💡 什麼時候應該用多個 Session？
- ✅ 工作 / 個人分開：避免工作上的程式碼討論和個人行程混在一起，讓 AI 在各自的情境下給出更精準的建議
- ✅ 長期項目管理：為每個重要項目建立獨立 Session，保持完整的項目脈絡
- ✅ 實驗性任務：嘗試新設定或測試時建立臨時 Session，不影響主要的對話歷史
- ✅ 分擔上下文負擔：當某個 Session 的上下文太大時，開新 Session 從輕量狀態繼續，而不是一直 /compact
openclaw memory — 持久記憶管理
openclaw memory 讓你直接查看和管理 OpenClaw 的持久記憶——那些跨 Session 保存的重要資訊，例如你的名字、偏好、過去的重要決策等。
# 列出所有持久記憶
openclaw memory list
# 搜尋特定記憶
openclaw memory search "API key"
# 查看某條記憶的詳細內容
openclaw memory show [記憶ID]
# 手動新增記憶
openclaw memory add "偏好：程式碼使用 TypeScript，不用 JavaScript"
# 刪除特定記憶
openclaw memory delete [記憶ID]
# 匯出全部記憶（備份用）
openclaw memory export --output my-memories.json
# 匯入記憶（從備份還原）
openclaw memory import my-memories.json
openclaw logs — 查看執行日誌
openclaw logs 是排查問題的重要工具。當 OpenClaw 出現異常行為、排程沒有觸發、或者某個 Skill 執行失敗時，第一步都應該查看日誌。
基本用法
# 查看最新的 50 條日誌
openclaw logs
# 查看最近 N 條
openclaw logs --last 100
# 查看過去 N 小時的日誌
openclaw logs --last 24h
openclaw logs --last 1h
# 按類型篩選
openclaw logs --filter error # 只顯示錯誤
openclaw logs --filter warning # 只顯示警告
openclaw logs --filter heartbeat # 只顯示心跳記錄
openclaw logs --filter skill # 只顯示 Skill 執行記錄
openclaw logs --filter api # 只顯示 API 呼叫記錄
# 即時追蹤日誌（類似 tail -f）
openclaw logs --follow
# 輸出到文件
openclaw logs --last 24h > debug.log
# 清除日誌文件
openclaw logs --clear
如何用 logs 診斷問題？
🔍 排程沒觸發？
openclaw logs --filter heartbeat --last 24h
# 查看心跳日誌，確認是否有記錄
🔍 API 呼叫失敗？
openclaw logs --filter error --last 1h
# 查看最近 1 小時的錯誤
🔍 Skill 執行失敗？
openclaw logs --filter skill --last 2h
# 查看 Skill 執行記錄，找出失敗原因
openclaw gateway — Gateway 服務管理
雖然上面提到了 gateway，但它值得更詳細的說明。openclaw gateway 是管理 OpenClaw 後台橋接服務的核心指令：
# 查看 gateway 狀態
openclaw gateway status
# 啟動 gateway
openclaw gateway start
# 停止 gateway
openclaw gateway stop
# 重新啟動 gateway
openclaw gateway restart
# 設定開機自動啟動（Linux systemd）
openclaw gateway enable --autostart
# 查看 gateway 日誌
openclaw gateway logs --follow
# Token 管理
openclaw gateway token status # 查看 Token 狀態
openclaw gateway token rotate # 輪換（更新）Token
# 診斷 gateway 問題
openclaw gateway diagnose
其他重要子命令速查
openclaw update
openclaw update # 更新到最新版
openclaw update --check # 只查看是否有更新
openclaw update --beta # 安裝測試版
openclaw skills
openclaw skills list # 列出已安裝技能
openclaw skills install [名稱] # 安裝技能
openclaw skills remove [名稱] # 移除技能
openclaw skills enable [名稱] # 啟用技能
openclaw models
openclaw models list # 查看已設定的模型
openclaw models switch claude # 切換到 Claude
openclaw models add openai # 添加 OpenAI 模型
openclaw uninstall
openclaw uninstall # 完全移除
openclaw uninstall --keep-data # 保留記憶，只移除程式
常用組合工作流：把指令串起來用
🔧 遇到任何問題時的標準流程
openclaw doctor # 1. 先診斷
openclaw logs --filter error # 2. 看錯誤日誌
openclaw gateway status # 3. 確認 gateway
openclaw doctor --fix # 4. 自動修復
🔄 遷移到新電腦的流程
# 舊電腦：備份
openclaw memory export --output memories.json
openclaw sessions export --all --output sessions.json
# 新電腦：安裝後還原
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard
openclaw memory import memories.json
openclaw sessions import sessions.json
📊 每天早上的健康確認
# 建立一個 alias，每天早上一鍵檢查
alias claw-check='openclaw gateway status && openclaw doctor && openclaw logs --filter error --last 12h'
常見問題 Q&A
Q：openclaw doctor --fix 說已修復，但問題還在？
A：doctor --fix 只能修復它「知道怎麼修」的問題。有些問題需要手動介入，例如重設 API Key、重新設定 Telegram Bot 等。此時查看 doctor 輸出的「Manual action required」部分，按照指示手動操作。
Q：執行 openclaw sessions new 後如何在聊天中切換到新 Session？
A：在聊天視窗中輸入 /sessions [session名稱] 就可以切換。或者也可以在 CLI 中執行 openclaw sessions switch [名稱]，下次開啟的對話就會在該 Session 中進行。
Q：logs 文件會越來越大嗎？有多大？
A：OpenClaw 的日誌默認保留 30 天，超過 30 天的會自動刪除。你也可以用 openclaw logs --clear 手動清除。日常使用下，30 天的日誌大約在 50-200MB 之間，不會佔用太多空間。
Q：openclaw memory list 顯示的記憶太多，怎麼整理？
A：先用 openclaw memory search [關鍵字] 找出相關記憶，再用 openclaw memory delete [ID] 刪除不需要的。或者直接在聊天視窗告訴 OpenClaw「請幫我清理不重要的記憶」，它會自動整理。
VPN07 - OpenClaw 指令穩定執行的保障
千兆頻寬 · 1000Mbps · API 呼叫不超時 · 指令順暢執行
OpenClaw 的所有 CLI 子命令在執行時，都需要穩定的網路連線來和 Claude API、OpenAI API 及各通訊平台保持連線。使用劣質網路時，doctor --fix 可能因連線超時而失敗，sessions 同步可能中斷，logs 顯示大量網路錯誤。VPN07 提供 1000Mbps 千兆頻寬和超過十年的穩定運營，讓你的每一條 OpenClaw 指令都能順暢執行，月費僅 $1.5，30 天退款保證。