Release and CI
Tập lệnh
scripts/ chứa các tập lệnh hỗ trợ cho quy trình làm việc cục bộ và các tác vụ vận hành. Hãy sử dụng chúng khi tác vụ rõ ràng gắn với một tập lệnh; nếu không, hãy ưu tiên CLI.
Quy ước
- Các tập lệnh là không bắt buộc, trừ khi được đề cập trong tài liệu hoặc danh sách kiểm tra phát hành.
- Ưu tiên các giao diện CLI khi có sẵn (ví dụ:
openclaw models status --check). - Giả định rằng các tập lệnh phụ thuộc vào máy chủ; hãy đọc chúng trước khi chạy trên máy mới.
Các tập lệnh giám sát xác thực
Việc xác thực mô hình nói chung được trình bày trong Xác thực. Các tập lệnh dưới đây là một hệ thống riêng biệt, không bắt buộc, dùng để giám sát mã thông báo đăng ký Claude Code CLI trên máy chủ từ xa/không giao diện và xác thực lại từ điện thoại:
scripts/setup-auth-system.sh- thiết lập một lần: kiểm tra trạng thái xác thực hiện tại, hỗ trợ tạoclaude setup-tokencó thời hạn dài và in các bước cài đặt systemd/Termux.scripts/claude-auth-status.sh [full|json|simple]- kiểm tra trạng thái xác thực của Claude Code và OpenClaw.scripts/auth-monitor.sh- thăm dò trạng thái và gửi thông báo (qua chức năng gửi của OpenClaw và/hoặc ntfy.sh) khi mã thông báo sắp hết hạn. Biến môi trường:WARN_HOURS(mặc định2),NOTIFY_PHONE,NOTIFY_NTFY. Chạy theo lịch bằngscripts/systemd/openclaw-auth-monitor.{service,timer}đi kèm (30 phút một lần).scripts/mobile-reauth.sh- chạy lạiclaude setup-tokenvà in các URL để mở trên điện thoại, dùng qua SSH từ Termux.scripts/termux-quick-auth.sh,scripts/termux-auth-widget.sh,scripts/termux-sync-widget.sh- các tập lệnh Termux:Widget kết nối SSH tới máy chủ, hiển thị thông báo nhanh về trạng thái và mở bảng điều khiển/hướng dẫn xác thực lại khi thông tin xác thực đã hết hạn.
Trình hỗ trợ đọc GitHub
Sử dụng scripts/gh-read khi bạn muốn gh dùng mã thông báo cài đặt GitHub App cho các lệnh gọi đọc trong phạm vi kho lưu trữ, đồng thời vẫn giữ gh thông thường đăng nhập bằng tài khoản cá nhân của bạn để thực hiện các thao tác ghi.
Các biến môi trường bắt buộc:
OPENCLAW_GH_READ_APP_IDOPENCLAW_GH_READ_PRIVATE_KEY_FILE
Các biến môi trường không bắt buộc:
OPENCLAW_GH_READ_INSTALLATION_IDkhi bạn muốn bỏ qua việc tra cứu bản cài đặt dựa trên kho lưu trữOPENCLAW_GH_READ_PERMISSIONSlàm giá trị ghi đè được phân tách bằng dấu phẩy cho tập hợp con quyền đọc cần yêu cầu
Thứ tự phân giải kho lưu trữ:
gh ... -R owner/repoGH_REPOgit remote origin
Ví dụ:
scripts/gh-read pr view 123scripts/gh-read run list -R openclaw/openclawscripts/gh-read api repos/openclaw/openclaw/pulls/123
Khi thêm tập lệnh
- Giữ cho các tập lệnh tập trung vào một mục đích và có tài liệu hướng dẫn.
- Thêm một mục ngắn vào tài liệu liên quan (hoặc tạo tài liệu nếu chưa có).