指令碼

scripts/ 目錄包含用於本機工作流程和維運工作的輔助指令碼。 當工作明確與某個指令碼相關時，請使用這些指令碼；否則優先使用 CLI。

# 慣例

• 除非文件或發布檢查清單中有引用，否則指令碼都是選用的。
• 有 CLI 介面時，請優先使用 CLI 介面（範例：身分驗證監控使用 openclaw models status --check）。
• 假設指令碼與主機相關；在新機器上執行前請先閱讀它們。

# 身分驗證監控指令碼

身分驗證監控涵蓋於身分驗證。scripts/ 下的指令碼是 systemd/Termux 手機工作流程的選用額外工具。

# GitHub 讀取輔助工具

當你希望 gh 使用 GitHub App 安裝權杖來進行儲存庫範圍的讀取呼叫，同時保留一般 gh 使用你的個人登入來執行寫入動作時，請使用 scripts/gh-read。

必要環境變數：

• OPENCLAW_GH_READ_APP_ID
• OPENCLAW_GH_READ_PRIVATE_KEY_FILE

選用環境變數：

• 當你想跳過以儲存庫為基礎的安裝查詢時，使用 OPENCLAW_GH_READ_INSTALLATION_ID
• OPENCLAW_GH_READ_PERMISSIONS 作為要請求之讀取權限子集的逗號分隔覆寫值

儲存庫解析順序：

• gh ... -R owner/repo
• GH_REPO
• git remote origin

範例：

• scripts/gh-read pr view 123
• scripts/gh-read run list -R openclaw/openclaw
• scripts/gh-read api repos/openclaw/openclaw/pulls/123

# 新增指令碼時

• 保持指令碼聚焦且有文件說明。
• 在相關文件中新增一則簡短項目（若缺少則建立一份）。

# 相關

• 測試
• 即時測試