首次啟動與驗證

安裝完成後的健康檢查、診斷工具、以及出問題時的 60 秒急救流程

恭喜，OpenClaw 已經裝好了。但「裝好」和「穩定運作」之間還有一段距離。這篇帶你走完健康檢查，確認所有元件都正常，然後教你出問題時怎麼快速診斷。

安裝完成後你擁有的

走完前面的安裝流程後，你的環境應該有以下東西在運作：

元件	說明	驗證方式
OpenClaw Gateway	在背景持續運作的核心服務	`openclaw status`
Web Dashboard	透過瀏覽器管理 Agent 和頻道的介面	打開 `http://127.0.0.1:18789/`
Cloudflare Tunnel	讓外部服務能連到你的 Gateway	從手機打開 `https://agent.yourdomain.com`
開機自啟	macOS launchd 或 Linux systemd	重新開機後檢查 `openclaw status`

如果你跳過了 Cloudflare Tunnel 設定，Gateway 仍然可以在本機正常運作。但外部服務（LINE Webhook、Telegram Bot 等）無法連到你的 Gateway — 這代表你的 Agent 只能透過 Dashboard 手動互動。

健康檢查清單

OpenClaw 提供幾個不同層級的狀態檢查指令，從快速概覽到完整報告都有。

快速概覽

openclaw status

這是你最常用的指令。它會顯示 Gateway 是否在運作、已連接的頻道數量、以及基本的健康狀態。

完整報告

openclaw status --all

輸出所有元件的詳細狀態，包含：

Gateway 版本和運行時間
已設定的 AI Provider 和模型
各頻道的連線狀態
API Key 的有效性
系統資源使用量

openclaw status --all 的輸出格式設計成可以直接複製貼上。如果你需要在社群或客服中尋求協助，貼上這段輸出能大幅加快排查速度。

Daemon 和 Port 狀態

openclaw gateway status

專門檢查 Gateway daemon 的狀態 — daemon 是否在運作、port 18789 是否正常監聽、PID 是多少。

Gateway 快照（JSON 格式）

openclaw health --json

輸出機器可讀的 JSON 格式健康報告。適合用於自動化監控腳本，或是需要程式解析狀態時使用。

出了問題？60 秒診斷法

當你的 Agent 沒有回應、Dashboard 打不開、或是收到錯誤通知時，按照這四個步驟走。大部分問題在 60 秒內可以定位到原因。

第 1 步：看狀態

openclaw status

正常情況：Gateway 顯示 running，各頻道顯示 connected。

如果 Gateway 不在運作：

# Mac mini
launchctl list | grep openclaw

# VPS
sudo systemctl status openclaw

第 2 步：看日誌

openclaw logs --follow

即時追蹤日誌輸出。送一條測試訊息給你的 Agent，觀察日誌中是否有錯誤訊息。

常見錯誤模式：

API key invalid — API Key 過期或額度用完
Connection refused — 目標服務（LINE、Telegram 等）連線失敗
Rate limited — 請求頻率超過 AI Provider 限制

按 Ctrl+C 停止追蹤。

第 3 步：自動診斷

openclaw doctor

doctor 指令會自動檢查常見問題：

Node.js 版本是否符合要求
設定檔格式是否正確
API Key 是否有效
Gateway port 是否可用
網路連線是否正常

它會輸出每項檢查的結果，以及建議的修復方式。

第 4 步：深度檢查

openclaw status --deep

這是最完整的診斷指令。除了基本狀態外，還會：

主動測試每個 AI Provider 的 API 連線
驗證每個頻道的 Webhook URL 是否可達
檢查磁碟空間和記憶體使用量
驗證 SSL 憑證狀態

--deep 檢查會實際發送測試請求到各個外部服務，所以會花比較長的時間（通常 10-30 秒）。不要在正式環境頻繁使用 — 日常監控用 openclaw status 就夠了。

環境變數參考

如果你需要自訂 OpenClaw 的儲存位置或設定檔路徑，可以透過以下環境變數：

變數	預設值	說明
`OPENCLAW_HOME`	`~/.openclaw`	OpenClaw 主目錄
`OPENCLAW_STATE_DIR`	`~/.openclaw/state`	運行狀態儲存目錄
`OPENCLAW_CONFIG_PATH`	`~/.openclaw/config.json5`	設定檔路徑

OpenClaw 的設定檔格式是 JSON5 — 支援註解和尾隨逗號，比標準 JSON 寫起來舒服。

安裝後必做：讓 Agent 變成「你的」

技術上跑起來只是一半。如果你跳過這一步，你的 Agent 會像一個客服機器人 — 能用，但沒有靈魂。

安裝 QMD Skill（強烈建議第一時間做）

QMD（Quick Memory Dump）是 OpenClaw 的記憶管理 skill。在你開始大量對話之前就裝好它，否則 Agent 容易在對話中途 reset 或遺忘先前的上下文。

直接在對話中告訴你的 Agent：

「請安裝 QMD skill」

Agent 會自動完成安裝。

很多使用者在跟 Agent 聊了一週之後才裝 QMD，結果發現 Agent 經常忘記之前的對話。先裝好，省得回頭。

SOUL.md / USER.md — 你的 Agent 人格檔案

OpenClaw 用三個檔案定義 Agent 的個性和記憶：

檔案	位置	用途
`SOUL.md`	`agents/<agentId>/agent/`	Agent 的性格、說話風格、關注的事
`USER.md`	`agents/<agentId>/agent/`	你的個人資訊 — 姓名、職業、偏好、習慣
`MEMORY.md`	`agents/<agentId>/agent/`	長期記憶，Agent 自動更新

你可以手動編輯這些檔案，但更聰明的做法是讓 Agent 採訪你。在第一次對話中，發送類似這樣的訊息：

「你剛上線，我希望你問我一些問題來認識我 — 我的名字、工作、目標、喜歡你怎麼跟我說話、每天用什麼工具、需要什麼幫助。一次問一個問題，然後用我的回答來填寫 SOUL.md 和 USER.md。」

Agent 會問你 10-15 個問題。誠實回答。告訴它你的真實情況 — 工作、副業、行程、你想要多隨性的對話風格。

Pro tip：用語音訊息回答，比打字更自然、更快、內容更豐富。

完成之後，你的 Agent 就有了完整的上下文。它知道你是誰、記得你的偏好。這是「通用聊天機器人」和「你的 AI 助手」之間的本質差距。

加入 Brave Search 和 Groq

如果你在安裝前準備階段取得了這些 Key，現在直接告訴 Agent：

「設定 Brave Search，這是我的 API Key：[貼上 Key]」

「設定 Groq，這是我的 API Key：[貼上 Key]」

Agent 會自動完成後續安裝。你的 Agent 現在能搜尋網頁、聽懂語音訊息了。

下一步

安裝、驗證、和人格設定都完成了。現在你的 OpenClaw Agent 不只在跑，還知道你是誰。接下來：

連接你的第一個通訊頻道 — LINE、Telegram、WhatsApp... 選一個開始。前往通訊頻道設定
認識操作介面 — Dashboard、CLI、API 三種操作方式，了解各自適合什麼場景。前往操作介面總覽

GetClaw 觀點

「裝好」只是起點。真正的挑戰從你開始日常使用的那天才開始 — Agent 為什麼突然不回了？日誌裡那串紅字什麼意思？上週還好好的怎麼今天就壞了？

這就是我們把「60 秒診斷法」放在這麼前面的原因。你不需要一開始就理解 OpenClaw 的每個元件，但你需要知道出問題時怎麼快速找到原因。openclaw status → openclaw logs → openclaw doctor — 把這三個指令記住，能解決你 90% 的問題。

剩下的 10%？那就是經驗的價值所在。而這正是 GetClaw 存在的意義。

首次啟動與驗證

On this page