如何使用專案中的 Scripts 簡化維運任務

寫程式時最討厭的就是重複處理那些繁瑣的本地工作流或維運雜事。雖然我們都希望所有功能都內建在 CLI 裡，但有時候一些靈活的輔助工具能幫你更快完成任務，不需要每次都手動輸入一長串指令。

如果你發現某些重複性的工作還沒被整合進正式工具，這就是 scripts/ 目錄派上用場的時候。

需要準備的東西

• 專案中的 scripts/ 目錄
• 已安裝並配置好的 openclaw CLI

快速開始

要在 5 分鐘內開始使用這些輔助工具，請遵循以下步驟：

1. 優先使用 CLI 如果某個功能已經有 CLI 支援，請優先使用它。例如，如果你要檢查 Auth 監控狀態，直接執行：

   openclaw models status --check

2. 定位與檢查 Script 在 scripts/ 目錄中尋找對應的檔案。除非文件或發佈清單（release checklists）有特別要求，否則這些 script 都是選用的。

3. 確認主機環境 這些 script 通常是針對特定主機（host-specific）編寫的。在你的新機器執行任何 script 前，請務必先打開檔案閱讀內容，確保邏輯符合你的環境。

4. 新增自定義 Script 如果你需要加入新的工具，請保持功能單一並加上文件說明。記得在相關文件中加入簡短的入口介紹。

疑難排解

• Script 在新機器上執行失敗 這些 script 假設了特定的主機環境。如果你更換了執行環境，請先閱讀 script 程式碼，確認路徑或環境變數是否需要調整。

• 不知道該用 CLI 還是 Script 規則很簡單：只要 CLI 存在對應功能，就用 CLI。只有在任務與特定 script 明確綁定時，才使用 scripts/ 資料夾下的內容。

如果你在設定過程遇到任何困難，可以隨時諮詢 AI Setup Assistant。

下一步

• Auth Monitoring 自動化文件
• CLI 指令完整參考