Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
ký mac (bản dựng debug)

Ứng dụng này thường được dựng từ scripts/package-mac-app.sh, hiện sẽ:
  • đặt mã định danh bundle debug ổn định: ai.openclaw.mac.debug
  • ghi Info.plist với bundle id đó (ghi đè bằng BUNDLE_ID=...)
  • gọi scripts/codesign-mac-app.sh để ký binary chính và bundle ứng dụng, để macOS coi mỗi lần dựng lại là cùng một bundle đã ký và giữ các quyền TCC (thông báo, trợ năng, ghi màn hình, mic, giọng nói). Để quyền ổn định, hãy dùng một danh tính ký thật; ad-hoc là tùy chọn phải bật rõ ràng và dễ hỏng (xem quyền macOS).
  • dùng CODESIGN_TIMESTAMP=auto theo mặc định; tùy chọn này bật timestamp đáng tin cậy cho chữ ký Developer ID. Đặt CODESIGN_TIMESTAMP=off để bỏ qua timestamping (bản dựng debug ngoại tuyến).
  • chèn metadata bản dựng vào Info.plist: OpenClawBuildTimestamp (UTC) và OpenClawGitCommit (hash ngắn) để khung About có thể hiển thị bản dựng, git, và kênh debug/release.
  • Đóng gói mặc định dùng Node 24: script chạy các bản dựng TS và bản dựng Control UI. Node 22 LTS, hiện là 22.14+, vẫn được hỗ trợ để tương thích.
  • đọc SIGN_IDENTITY từ môi trường. Thêm export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" (hoặc chứng chỉ Developer ID Application của bạn) vào shell rc để luôn ký bằng chứng chỉ của bạn. Ký ad-hoc cần bật rõ ràng bằng ALLOW_ADHOC_SIGNING=1 hoặc SIGN_IDENTITY="-" (không khuyến nghị để kiểm thử quyền).
  • chạy kiểm tra Team ID sau khi ký và thất bại nếu bất kỳ Mach-O nào bên trong bundle ứng dụng được ký bởi Team ID khác. Đặt SKIP_TEAM_ID_CHECK=1 để bỏ qua.

​
Cách dùng

# from repo root
scripts/package-mac-app.sh               # auto-selects identity; errors if none found
SIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # real cert
ALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh    # ad-hoc (permissions will not stick)
SIGN_IDENTITY="-" scripts/package-mac-app.sh        # explicit ad-hoc (same caveat)
DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh   # dev-only Sparkle Team ID mismatch workaround

​
Ghi chú về ký ad-hoc

Khi ký bằng SIGN_IDENTITY="-" (ad-hoc), script tự động tắt Hardened Runtime (--options runtime). Điều này cần thiết để ngăn crash khi ứng dụng cố tải các framework nhúng (như Sparkle) không dùng chung Team ID. Chữ ký ad-hoc cũng làm hỏng khả năng duy trì quyền TCC; xem quyền macOS để biết các bước khôi phục.

​
Metadata bản dựng cho About

package-mac-app.sh đóng dấu bundle với:
  • OpenClawBuildTimestamp: UTC ISO8601 tại thời điểm đóng gói
  • OpenClawGitCommit: hash git ngắn (hoặc unknown nếu không có)
Tab About đọc các khóa này để hiển thị phiên bản, ngày dựng, git commit, và liệu đó có phải bản dựng debug hay không (qua #if DEBUG). Chạy packager để làm mới các giá trị này sau khi thay đổi mã.

​
Lý do

Quyền TCC được gắn với mã định danh bundle và chữ ký mã. Các bản dựng debug chưa ký với UUID thay đổi đã khiến macOS quên quyền đã cấp sau mỗi lần dựng lại. Việc ký các binary (mặc định là ad-hoc) và giữ bundle id/đường dẫn cố định (dist/OpenClaw.app) bảo toàn các quyền đã cấp giữa các bản dựng, khớp với cách tiếp cận của VibeTunnel.

​
Liên quan