OpenClaw 常用指令整理:裝完真的會用到的那幾個,附我實際跑出來的結果

部分實測2026.10.12

OpenClaw 的指令有六十幾組,新手會用到的不到十個。這篇照「設定、檢查、啟動、傳話、接聊天軟體、排程」的順序整理,大部分指令我都在測試機上實際跑過,附上它印出來的原文,沒跑過的會標明。

更新 2026/10/13・約 10 分鐘讀完・查證環境:OpenClaw 2026.10.2,雲端測試機(Ubuntu 26.04)。onboard、config、doctor、gateway、agent、channels、plugins、models、cron、security、telemetry 實際跑過;skills 是 10 月 13 日在 2026.10.3 上跑的;update、uninstall、status、logs、dashboard、tui、pairing 沒有跑,依官方文件

先講結論

  • 新手最常用的其實不到十個:openclaw onboard 設定、openclaw doctor 檢查、openclaw gateway 啟動、openclaw agent -m 傳話,其他都是出狀況才會查。
  • 出問題先跑 openclaw doctor,再跑 openclaw gateway status。這兩個的輸出通常會直接寫出下一步該下哪個指令。
  • 想試東西又怕弄壞現有的設定,在指令裡加上 --profile 和一個名字,它會另外開一套完全獨立的設定。
目錄
  1. 先看這張表
  2. 設定:onboard 和 config
  3. 檢查:doctor、gateway status、security audit
  4. 啟動和停止:gateway
  5. 跟它講話:agent
  6. 頻道和外掛:channels、plugins、pairing
  7. 模型:models
  8. 排程:cron
  9. 技能:skills
  10. 三個小技巧
  11. 更新和移除

裝好 OpenClaw,打 openclaw --help,會跑出一長串。我去數官方文件的指令總表,有六十幾組。

新手用不到那麼多。我在測試機上從安裝一路做到跟它對話,真正下過的指令大概十來個。這篇就整理這些,照你會遇到的順序排。

每個指令後面我會寫它實際印出什麼。那是 2026 年 10 月 12 日在 OpenClaw 2026.10.2 上跑的,版本不同字句可能會變。有幾個我沒有跑過,會直接講。

先看這張表

想做的事 指令
第一次設定,或重新設定 openclaw onboard
檢查哪裡有問題 openclaw doctor
啟動核心程式 openclaw gateway
看核心程式有沒有在跑 openclaw gateway status
不接聊天軟體,直接傳一句話 openclaw agent --agent main -m "你的訊息"
看有哪些聊天軟體可以接 openclaw channels list --all
裝外掛,例如 LINE openclaw plugins install @openclaw/line
看有哪些模型可以用 openclaw models list
看它自己排了哪些定時工作 openclaw cron list --all
看內建的技能哪些能用 openclaw skills check
檢查安全設定 openclaw security audit --deep

設定:onboard 和 config

openclaw onboard 是設定精靈,安裝腳本跑完會自動進去一次,之後想重設再自己下。它會問你怎麼開始、要建立什麼、用哪一家的模型。每一題在問什麼,我寫在安裝那篇。

想看中文的畫面,前面加一個變數:

OPENCLAW_LOCALE=zh-TW openclaw onboard

精靈不是唯一的設定方式。改單一個設定值用 openclaw config set,後面接設定的名字和值:

openclaw config set gateway.mode local

這行我跑了,它回 Updated gateway.mode. Restart the gateway to apply.,意思是改好了,但要重開核心程式才會生效。

不是每個設定都要重開。我改另一個跟心跳有關的設定,它回的是 Change will apply without restarting the gateway。它每次都會告訴你要不要重開,照著做就好。

想知道某個設定現在是什麼,把 set 換成 get。我查過一個沒設過的項目,它回 Config path is valid but unset,後面補一句會套用預設值。

所有設定都存在同一個檔案,位置是 ~/.openclaw/openclaw.json。每次改動它會自己留備份,檔名後面多 .bak。

檢查:doctor、gateway status、security audit

覺得哪裡怪怪的,先跑這個:

openclaw doctor

它在我那台 1 核心的機器上跑了 15 秒,印出一百八十幾行。內容很多,但每一項後面通常直接附修法。例如我還沒跑設定精靈的時候,它寫的是:

gateway.mode is unset; gateway start will be blocked.
Fix: run openclaw configure and set Gateway mode (local/remote).
Or set directly: openclaw config set gateway.mode local

連指令都幫你寫好了。它還會提示可以加 --fix 讓它自己修,那個我沒有跑。

第二個是看核心程式的狀態:

openclaw gateway status

正常的時候裡面有一行 Connectivity probe: ok。沒開的時候是 Connectivity probe: failed,下面跟著 ECONNREFUSED。它也會印出紀錄檔放在哪,我這邊是 /tmp/openclaw/ 底下,檔名帶日期。

第三個是安全檢查:

openclaw security audit --deep

7 秒跑完,第一行是總結,長這樣:Summary: 1 critical · 2 warn · 1 info。下面每一項有代號、說明和修法。我跳過精靈手動設定的那一次有 1 個 critical,照正常流程走完精靈的那一次是 0 個。

官方文件裡還有兩個看狀況用的指令,openclaw status 和 openclaw logs --follow,後者是即時看紀錄。這兩個我沒有跑。

啟動和停止:gateway

OpenClaw 的核心是一支叫 Gateway 的程式,它開著,你的助理才活著。

openclaw gateway

這樣是開在目前這個終端機視窗裡,按 Ctrl + C 就停。我量到它從啟動到可以連線大約 13 秒。

如果設定還沒做完,它會拒絕啟動。我遇到的訊息是 Gateway start blocked: existing config is missing gateway.mode。

要它在背景一直開著,官方的做法是裝成系統服務:

openclaw gateway install

這個我只跑出失敗的結果。我的測試機沒有 systemd,它回 No supported service manager detected。一般的 Linux 主機和 Mac 不會遇到這個。

裝成服務之後,官方文件給的是 openclaw gateway stop、start、restart 這三個,我沒有機會跑。

核心程式開著的時候,網頁版的控制台在 http://127.0.0.1:18789/,只有本機連得到。官方文件說用 openclaw dashboard 可以直接幫你打開,主機沒有螢幕的話加 --no-open,它只印出網址。這個我沒有跑。

跟它講話:agent

還沒接任何聊天軟體,也可以從終端機直接傳話:

openclaw agent --agent main -m "用一句話介紹你自己"

main 是預設那個助理的名字。它會等模型回完,把答案印出來。

後面加 --json 的話,印出來的是完整的資料,包含這次送進去多少 token、花多久、用了哪些工具。我寫費用那篇用的數字就是從這裡來的。模型很慢的時候可以加 --timeout 和秒數,免得它等到一半放棄。

想要一來一往聊天的畫面,官方有終端機版的介面,指令是 openclaw tui,另外有一個 openclaw chat。這兩個我沒有跑。

頻道和外掛:channels、plugins、pairing

看它能接哪些聊天軟體:

openclaw channels list --all

每一行是一個聊天軟體和它的狀態,像 Telegram: installed, not configured, disabled。我剛裝好的時候,只有 Telegram 是 installed,LINE、WhatsApp、Discord、Slack 都是 not installed。

顯示 not installed 的要先裝外掛。以 LINE 為例:

openclaw plugins install @openclaw/line

我跑了 36 秒,結尾是 Installed plugin: line。

接下來是把帳號接上去,指令是 openclaw channels add。它的說明文字裡給的範例是 openclaw channels add --channel telegram --token 後面接你的機器人金鑰。我沒有金鑰可以測,這一步沒跑。

接上之後,陌生人傳訊息要先經過你核准。官方文件給的兩個指令是 openclaw pairing list 和 openclaw pairing approve,後面接聊天軟體的名字和配對碼。這也是照文件寫的。

模型:models

openclaw models list

列出目前設定好的模型。我接本地模型那一次,它印的是一張表,欄位有模型名稱、context 大小、是不是本機、有沒有登入,預設用的那個後面標 default。

後面加 --provider 和供應商的名字,可以只看某一家。

排程:cron

OpenClaw 會自己定時做事。想知道它到底排了什麼:

openclaw cron list --all

我在一台全新安裝的機器上跑,裡面已經有三個:每 30 分鐘一次的心跳,每天凌晨三點的記憶整理,每七天一次的技能檢查。

每個排程有一個代號。想立刻跑一次、不等時間到,用 openclaw cron run 加上代號。我用這個方法手動觸發過一次心跳,它馬上回一段資料,裡面寫 "enqueued": true,表示已經排進去了。

openclaw automations 是同一組指令的另一個名字。

技能:skills

OpenClaw 裝好就帶了一批技能,但不是每個都能用。看現況的指令是:

openclaw skills check

這一個是 2026 年 10 月 13 日在 2026.10.3 版上跑的,比這篇其他指令晚一天、新一版。全新的 Linux 測試機上,它寫總共 55 個、可用 19 個,不能用的每一個後面都用括號標了缺什麼。

要找別人寫好的技能,用 openclaw skills search 加關鍵字;安裝是 openclaw skills install 加代號。這幾個指令實際印出什麼,寫在OpenClaw Skills 是什麼和ClawHub 是什麼。

三個小技巧

第一個是 --profile。加在 openclaw 後面,再給一個名字:

openclaw --profile test onboard

它會另外開一套設定,放在 ~/.openclaw-test,跟原本的完全分開,連使用的連接埠都不一樣。我測設定精靈的時候就是靠它,每次都從全新的狀態開始,不會動到原本那一套。

第二個是 --help。任何指令後面都可以加,例如 openclaw gateway --help。印出來的是英文,但通常附範例。

第三個是 openclaw telemetry show。它會告訴你 OpenClaw 現在有沒有在回報使用資料、回報到哪個網址。我這邊顯示 Feature stats: disabled,但它還是會定期連出去檢查有沒有新版。

更新和移除

這兩個我沒有跑過,內容是照官方文件。

更新是 openclaw update。文件說它會自己判斷你當初是怎麼裝的,再用同樣的方式更新。想先預覽,加 --dry-run。

移除是 openclaw uninstall。它會問你要移除哪些部分,預設只選背景服務。要全部清掉是加 --all,這會連設定和工作區一起刪,下之前先用 openclaw uninstall --dry-run --all 看一遍清單。

還有哪些指令,官方的總表在文件的 CLI 那一頁,繁體中文版也有。

常見問題

這些指令要在哪裡打?

在終端機裡。Mac 是「終端機」這個程式,Linux 主機是你連進去之後的那個畫面。Windows 的話,官方的桌面程式會把 OpenClaw 裝在它自己建的 WSL 環境裡,這部分我沒有實測。

聊天裡打的 /status 跟這些指令一樣嗎?

不一樣。斜線開頭的是在聊天軟體裡對它說的,這篇整理的是在終端機下的。我試過用終端機把 /context list 傳給它,結果被當成一般的訊息交給模型,沒有執行。

怎麼更新 OpenClaw?

官方文件給的指令是 openclaw update,加上 --dry-run 可以先看它打算做什麼。這個我沒有跑過。

怎麼把 OpenClaw 移除乾淨?

官方文件給的是 openclaw uninstall。想先看它會刪掉哪些東西,用 openclaw uninstall --dry-run --all。要注意全部移除會連你的設定和工作區一起刪。這個我也沒有跑過。

這篇怎麼查證的

這篇只有一部分實際跑過,其餘依官方文件整理,查證日期 2026/10/12(OpenClaw 2026.10.2,雲端測試機(Ubuntu 26.04)。onboard、config、doctor、gateway、agent、channels、plugins、models、cron、security、telemetry 實際跑過;skills 是 10 月 13 日在 2026.10.3 上跑的;update、uninstall、status、logs、dashboard、tui、pairing 沒有跑,依官方文件)。哪些有跑、哪些沒跑,文中各段有寫。價格與方案以官方頁面為準,工具改版後內容可能過期。