> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS 署名

# mac 署名（デバッグ ビルド）

このアプリは通常、[`scripts/package-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh) からビルドされます。現在、このスクリプトは次を行います。

* 安定したデバッグ用のバンドル識別子を設定します：`ai.openclaw.mac.debug`
* そのバンドル ID で Info.plist を書き込みます（`BUNDLE_ID=...` で上書き可能）。
* [`scripts/codesign-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/codesign-mac-app.sh) を呼び出して、メイン バイナリとアプリ バンドルに署名します。これにより、macOS は各リビルドを同一の署名済みバンドルとして扱い、TCC 権限（通知、アクセシビリティ、画面収録、マイク、音声）を保持します。権限を安定させるには、実際の署名 ID を使用してください。アドホック署名はオプトインで脆弱です（[macOS permissions](/platforms/mac/permissions) を参照）。 安定した権限については、本当の署名IDを使用してください。ad-hoc はオプトインで脆弱です ([macOS の権限](/platforms/mac/permissions)を参照してください)。 安定した権限については、本当の署名IDを使用してください。ad-hoc はオプトインで脆弱です ([macOS の権限](/platforms/mac/permissions)を参照してください)。
* 既定で `CODESIGN_TIMESTAMP=auto` を使用します。これは Developer ID 署名に対して信頼されたタイムスタンプを有効にします。タイムスタンプを省略するには `CODESIGN_TIMESTAMP=off` を設定します（オフラインのデバッグ ビルド向け）。 既定で `CODESIGN_TIMESTAMP=auto` を使用します。これは Developer ID 署名に対して信頼されたタイムスタンプを有効にします。タイムスタンプを省略するには `CODESIGN_TIMESTAMP=off` を設定します（オフラインのデバッグ ビルド向け）。 タイムスタンプをスキップするには `CODESIGN_TIMESTAMP=off` を設定します (オフラインのデバッグビルド)。
* ビルド メタデータを Info.plist に注入します：`OpenClawBuildTimestamp`（UTC）および `OpenClawGitCommit`（短縮ハッシュ）。これにより、About ペインにビルド、git、デバッグ／リリース チャンネルを表示できます。
* **パッケージングには Node 22+ が必要です**：スクリプトは TS ビルドおよび Control UI ビルドを実行します。
* 環境から `SIGN_IDENTITY` を読み込みます。 環境から `SIGN_IDENTITY` を読み込みます。 環境から `SIGN_IDENTITY` を読み取ります。常に自分の証明書で署名するには、`export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)"`（または Developer ID Application 証明書）をシェルの rc に追加してください。アドホック署名は `ALLOW_ADHOC_SIGNING=1` または `SIGN_IDENTITY="-"` による明示的なオプトインが必要です（権限テストには推奨しません）。 アドホック署名には、`ALLOW_ADHOC_SIGNING=1` または `SIGN_IDENTITY="-"` を介した明示的なオプトインが必要です (許可テストには推奨されません)。 アドホック署名には、`ALLOW_ADHOC_SIGNING=1` または `SIGN_IDENTITY="-"` を介した明示的なオプトインが必要です (許可テストには推奨されません)。
* 署名後に Team ID の監査を実行し、アプリ バンドル内のいずれかの Mach-O が異なる Team ID で署名されている場合は失敗します。回避するには `SKIP_TEAM_ID_CHECK=1` を設定します。 バイパスに`SKIP_TEAM_ID_CHECK=1`を設定します。 バイパスに`SKIP_TEAM_ID_CHECK=1`を設定します。

## 使用方法

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 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
```

### アドホック署名に関する注意

`SIGN_IDENTITY="-"` (ad-hoc) で署名するとき、スクリプトは **Hardened Runtime** (`--options runtime`) を自動的に無効にします。 これは、同じチーム ID を共有しない埋め込みフレームワーク(Sparkleなど)をアプリがロードしようとするとクラッシュを防ぐために必要です。 アドホック署名は TCC パーミッションの永続性を破壊します。リカバリ手順については [macOS パーミッション](/platforms/mac/permissions) を参照してください。

## About 用のビルド メタデータ

`package-mac-app.sh` は、次の内容でバンドルにスタンプします。

* `OpenClawBuildTimestamp`：パッケージ時点の ISO8601 UTC
* `OpenClawGitCommit`：短縮 git ハッシュ（利用できない場合は `unknown`）

About タブはこれらのキーを読み取り、バージョン、ビルド日、git コミット、そしてデバッグ ビルドかどうか（`#if DEBUG` 経由）を表示します。コード変更後は、パッケージャーを実行してこれらの値を更新してください。 パッケージを実行して、コードが変更された後にこれらの値を更新します。 パッケージを実行して、コードが変更された後にこれらの値を更新します。

## 理由

TCCパーミッションはバンドル識別子とコード署名に関連付けられます。 UUIDを変更することで署名されていないデバッグビルドが、再構築ごとにmacOSの許可を忘れる原因となっていました。 バイナリ(デフォルトではアドホック)に署名し、バンドルID/パス(`dist/OpenClaw.app`)を保持することで、ビルド間の補助金が、VibeTunnelアプローチと一致します。