2026-04-20 ヘッドレス レンタル クラウド Mac 上の OpenClaw スキルと ClawHub 式ピン留め
2026 年時点で OpenClaw のエコシステムは拡張可能なスキルを重視します。コアゲートウェイの横にインストールするパッジ化された能力で、コミュニティハブ（運用会話では広く ClawHub 型カタログと呼ばれる）から見つけることが多いです。SSH しか使えないレンタル Apple Silicon Mac では、スキル管理はオペレーション作業です。バージョンを固定し、~/.openclaw（または $OPENCLAW_STATE_DIR）を一貫させ、ゲートウェイをきれいに再起動し、nginx イングレス を再有効化する前に健全性を示します。本稿 2026-04-20 は 初回オンボード と ゲートウェイ更新 を補完し、デーモンが存在したあとに焦点を当てます：選別されたスキル、決定的なバージョン、HK / JP / KR / SG / US にわたるフリート展開です。
スキルを明示的にピン留めする理由
スキルはプロンプト、スクリプト、ツール権限を束ねられます。本番ゲートウェイで「最新」スキルを流すのは、決済サービスで npm @latest を流すようなものです。デモには刺激的ですがオンコールには高くつきます。スキルパッケージをインフラリポジトリでセマンバーやコンテンツハッシュに固定し、openclaw 本体と同じ規律を適用してください。
- インシデントの再現性 — 壊れたときにどのスキル版が変わったか正確に分かります。
- コンプライアンス — セキュリティレビューがリリーストレインごとにサードパーティスキルコードを範囲化できます。
- マルチテナント — Xcode CI と OpenClaw が 1 台の Mac を共有する場合、スキル更新がコンパイルレーンを驚かせてはいけません。
実際に使う CLI 面
サブコマンドはリリースごとに進化します。固定したセマンバーで必ず openclaw skills --help を確認してください。典型フローはインストール済みの列挙、新規導入、古いパックの削除です。自動化では非対話フラグを優先し、TTY のない SSH セッションがプロンプトで止まらないようにします。
openclaw --version
openclaw skills list
openclaw skills install <name>@<version>
インストール、検証、ロールバック
- webhook が稼働中なら先にトラフィックを凍結（nginx で
503+Retry-After）。 - メンテナンス枠でスキルをインストールまたは更新し、グローバル
npm -g更新と重ねない。 - LaunchAgent の衛生 に従い
openclaw doctorを実行。 - ゲートウェイを再起動し、レディネスプローブ で
127.0.0.1:18789を確認。 - 挙動が悪ければバックアップ tarball から前のスキルバンドルを戻してロールバック — ゲートウェイ更新と同じ tarball 思考です。
状態ディレクトリと権限
スキルは通常 OpenClaw の状態ツリー配下に置かれます。コンプライアンスのため OPENCLAW_STATE_DIR を上書きする場合、インストール先がそのディレクトリになり、POSIX 権限が LaunchAgent ユーザーと一致することを確認してください。root/sudo の混在インストールは「tmux では動くが再起動後に失敗」の典型原因です。
ゲートウェイ再読み込み順
スキル変更後はモジュールグラフを再読み込みするためゲートウェイプロセスを再起動します。古い挙動が残る場合は2 回目のクリーン再起動を行います。グローバル npm 更新後にも同様のパターンが報告されています。ダブル再起動の期待値を文書化し、オンコールがフラップと誤認しないようにします。
| 手順 | 成功の兆候 |
|---|---|
openclaw doctor |
重複エージェントなし、スキルマニフェストが認識される |
| ローカル curl ヘルス | 文書化されたヘルスルートで HTTP 200 |
| Nginx の再オープン | TLS ハンドシェイク + カナリアからの webhook プローブ |
フリート運用：段階的ロールアウト
まず シンガポール または 米東 のカナリアへスキルを転がし、30〜60 分エラー率を比較してから 東京 とソウルのピアへ昇格させます。自動化は冪等に保ち、料金 ページから借りた交換ホスト上でも CI が同じスキルバンドルを再実行できるようにします。
リージョンの注意
モデルエンドポイントへの遅延はスキルインストールより推論実行の方が影響大きいですが、大型スキルパックの成果物ダウンロードは依然ボトルネックになり得ます。地域ごとのオフピークにインストールを計画し NVMe 余裕を監視してください。スキルと Xcode 成果物が同時に共有ディスクを圧迫することがあります。
関連ランブック
スキルプロバイダの秘密情報は launchd 環境変数の手引き へ。公開ポートなしのメッシュは Tailscale メッシュ を参照。スキル整理の cron 的メンテナンスには launchd スケジュールタスク を使います。
FAQ：クラウド Mac のスキル
| 質問 | 回答 |
|---|---|
| 開発者がアドホックでスキルを入れてよいか | 共有 CI ホストでは非推奨。レビュー済みチケットと本番ゲートウェイと同じバンドルを使う。 |
| スキルは Xcode ビルドに影響するか | 直接はないがディスクと CPU の競合はあり得る。重いスキル更新はコンパイルピーク外に。 |
| エアギャップ導入は | ベンダ tarball をアーティファクトストアへミラーしローカルパスからインストール。チェックサム検証を文書化。 |
まとめ：スキルをバージョン付き依存関係として扱い、doctor とヘルスプローブで検証し地域展開し、謎の「最新」スキルドロップを本番ゲートウェイに混ぜないでください。
