OpenClaw 完全ガイド：クラウドMac 上の AI エージェント サンドボックス運用

OpenClaw は本番環境で何を解決しますか?

AI エージェントはコードを変更し、シェルを実行し、ネットワークにアクセスできます。権限が制御不能になると、誤って設定が変更されたり、キーが漏洩したりする可能性があります。 macOS 開発リンクでは、この問題はさらに拡大します。Xcode、コード署名、および Neural Engine が必要です。従来の Linux コンテナはこれらの機能を提供できません。裸で実行されているエージェントは監査可能な境界を提供できません。

OpenClaw の位置付けは次のとおりです: SpinMac 専用の Mac mini M4 物理マシンでは、完全な macOS ネイティブ機能を維持しながら、 各タスクの設定可能、追跡可能、 中止可能な操作範囲が定義されます。この記事では、「1 人セッション」から「チーム + CI 運用環境」にスケールするために必要なすべての手順について説明します。

コンソールの 4 段階のアクティブ化プロセス

1. 01
   Mac mini M4 インスタンスを購入する

   注文ページで 5 つのノードのいずれかを選択すると、基本パッケージは 1 日あたり $21.2 から始まります。支払い後 1 ～ 5 分で、SSH および VNC 認証情報を含む電子メールが自動配信されます。

2. 02
   コンソール → インスタンス → OpenClaw タグ

   最初のエントリはゼロ トラスト初期化をトリガーします。Ed25519 キー ペアを生成し、com.spinmac.openclaw.daemon をインストールし、/var/log/openclaw/ 監査ディレクトリを作成します。

3. 03
   アクセスポリシーとメンバーを構成する

   「アクセス制御」で共同作業者を追加し、所有者/オペレーター/監査者の役割を割り当てます。オペレーターはセッションを開始できます。監査人は監査ログの読み取りのみを行うことができます。

4. 04
   CLIをインストールして確認する

   コンソールでは、インストール スクリプトとトークンのダウンロードが提供されます。 claw status を実行して、daemon: running と auth: valid を確認します。

コンソールには、アクティブなセッションの数、各セッションの CPU/メモリ、過去 24 時間の BLOCK イベント統計などのリアルタイム パネルも表示され、セキュリティ レビュー用に PDF コンプライアンスの概要をエクスポートできます。

CLI コマンドグループの概要

日常の運用とメンテナンスは claw を中心に展開され、機能に応じて次のグループに分類できます。

# Status
claw status
claw doctor

# Sessions
claw run --config policy.yaml
claw run --template ci-review --detach
claw attach <session-id>
claw stop <session-id>
claw list

# Templates
claw template list
claw template export agent > policy.yaml
claw template save my-ci-policy

# Audit
claw audit tail <session> --follow
claw audit query --since 24h --action BLOCK
claw audit export <session> --format json

# Network dry-run
claw net test --domain api.openai.com

claw Doctor には、デーモン プロセスの検証、Endpoint Security の承認、ディレクトリの書き込み可能性の監査、およびトークンの有効性の監査などの日常的なチェックを含める必要があります。サンドボックスの起動に失敗し、エラーが曖昧な場合は、最初に診断を実行します。

実稼働グレードの YAML 戦略の詳細な説明

以下は、実稼働エージェントに一般的に使用される完全な構成とフィールドの説明です。

version: "1"
session:
  name: "prod-agent"
  auto_cleanup: false
  max_duration: "4h"
  idle_timeout: "30m"

filesystem:
  workspace: "~/agent-workspace"
  readonly_mounts:
    - /Applications
    - /usr/local/bin
    - /Library/Developer
  deny:
    - ~/.ssh
    - ~/Library/Keychains
    - ~/Library/Application Support/Cursor/User/globalStorage

syscalls:
  preset: "agent"
  deny: [ptrace, setuid, mount]

network:
  allow_domains:
    - "api.openai.com"
    - "api.anthropic.com"
    - "*.github.com"
    - "registry.npmjs.org"
    - "pypi.org"
  block_all_others: true
  log_blocked: true

セッション セグメント制御のライフ サイクル: max_duration と idle_timeout により、無人のセッションが長時間リソースを占有するのを防ぎます。 auto_cleanup: false は、出力を保持する必要があるコード生成タスクに適しています。

ファイルシステムセクションでは、deny が readonly_mounts よりも優先されます。 OpenClaw シンボリックリンクの実際のパスを解析します。Homebrew ツールが Cellar を指している場合は、Cellar ディレクトリも一緒にマウントする必要があります。

ネットワークセクションには常に block_all_others: true を設定し、log_blocked: true を有効にすることをお勧めします。許可されていない送信トラフィックはサイレントに破棄されますが、痕跡は残ります。

マルチユーザーのゼロトラストとロールモデル

チーム シナリオでは、最小限の権限に基づいて 3 種類のロールが割り当てられます。

各ロールは、デフォルトで 24 時間有効な独立した CLI トークンを通じて認証されます。所有者は、ワンクリックで対応するアクティブなセッションを取り消して終了できます。期間限定のゲスト トークンを外部コンサルタントに発行でき、期限が切れると自動的に期限切れになります。

GitHub Actions 統合例

SpinMac M4 を自己ホスト型ランナーとして登録すると、PR パイプライン内のレビューごとに独立したサンドボックス セッションが作成されます。

# .github/workflows/ai-review.yml
name: AI Code Review (Sandboxed)
on: [pull_request]

jobs:
  review:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4

      - name: Start OpenClaw sandbox
        run: |
          claw run --template ci-review --detach
          SESSION=$(claw list --json | jq -r '.[0].id')
          echo "SESSION_ID=$SESSION" >> $GITHUB_ENV

      - name: Run AI review agent
        run: |
          claw attach $SESSION_ID --exec \
            "claude -p 'Review this PR for security issues'"

      - name: Export audit log
        if: always()
        run: |
          claw audit export $SESSION_ID \
            --format json \
            --output audit-${{ github.run_id }}.json

      - name: Stop sandbox
        if: always()
        run: claw stop $SESSION_ID

ci-review テンプレート YAML をリポジトリの .openclaw/ ディレクトリに配置して、ワークフロー バージョンと同期することをお勧めします。ポリシーの変更はコードレビューを通過する必要があり、セキュリティチームは有効な境界を直接レビューできます。

監査ログの高度な使用法

条件付きバッチ クエリ - 異常な動作を追跡するときに時間と種類でフィルタリングします。

claw audit query --since 7d --action BLOCK --type network --format table

claw audit query --since 24h --action BLOCK --type write --format json \
  | jq '.[] | select(.target | contains("/etc"))'

準拠したエクスポート: JSON、CSV、PDF をサポートします。 PDF にはセッションの概要、ALLOW/BLOCK 統計、ポリシーのスナップショット、タイムラインが含まれており、監査のために直接送信できます。

アラーム ルール: コンソールでは、「単一セッションのブロック > 50 回/時間」や「~/.ssh の読み取り試行」などのしきい値を設定できます。トリガー後、所有者にメールまたは Webhook で通知されます。

高頻度の障害とパフォーマンスの調整

完全な監査には約 3% の CPU が使用されますが、これは M4 デカコアではほとんど無視できます。遅延に非常に敏感なシナリオの場合は、きめ細かい Syscall 監査をオフにして、ファイル層とネットワーク層のみを残すことができます。運用環境では完全な監査を維持することをお勧めします。監査ディレクトリの増加が速すぎる場合は、コンソールで保存日数を調整するか、セッションごとにオブジェクト ストレージにアーカイブして、ディスクが履歴ログでいっぱいになって新しいセッションの書き込みに影響を与えるのを避けることができます。

打ち上げ前の安全チェックリスト

生産を開始する前に、項目ごとに確認することをお勧めします。

各タスクには独立したセッションがあります。ポリシー YAML は Git とコード レビューに組み込まれます。 ~/.ssh、キーチェーン、IDE グローバル ストレージは常に拒否リストに含まれます。ネットワークはデフォルトですべて拒否され、必要に応じてホワイトニングが追加されます。 max_duration と idle_timeout を設定します。メンバーには最小限の権限が割り当てられ、トークンは定期的にレビューされます。 CI エクスポート監査の if: always()。ブロックアラームを設定します。リースをキャンセルする前に、すべてのログをアーカイブしてください。さらに、ポリシーが厳しすぎてパイプラインがサイレントに失敗したり、ポリシーが緩すぎて監査の盲点が残ったりすることを避けるために、システムコールのデフォルトまたはネットワークのホワイトリストを変更した後、クロー ネット テスト と短いタスク テストの実行を使用して検証することをお勧めします。

ローカルネイキッドランニングやパブリッククラウドとの違いmacOS

ローカル MacBook が裸で実行されている: エージェントにはメイン マシンと同じ権限がありますが、運用レベルの監査がありません。 8 GB モデルは長距離のランニング タスクに簡単に交換できますが、CI 7×24 を実行するのは困難です。

パブリック クラウド macOS インスタンス: ほとんどが仮想化環境であり、Neural Engine は直接接続できず、組み込みのサンドボックスや監査が欠如しており、最小リース期間と単価は通常、日次の柔軟な物理マシン ソリューションよりも高くなります。

GitHub Actions macOS ランナー: 分単位で請求され、macOS は単価が高く、環境の共有とポリシーを注意深く制御できず、ピーク時には行列が明らかです。

SpinMac は、Mac mini M4 物理マシン専用 ($21.2/日から)、OpenClaw 内蔵、1 ～ 5 分での 5 ノード配信、および 24 時間 365 日の対面サポートを提供します。この記事で説明するコラボレーション、CI、および監査プロセスは、このすぐに使用できる環境上に構築されています。 「高負荷のローカル マシンからエージェントを移行するかどうか」を評価する場合は、まずシンガポールまたは日本のノードで日次のリース期間で制御された実験を実行します。同じ倉庫、同じエージェント タスクで、監査ログの完全性とタスクの完了時間を比較してから、運用レビュー パイプラインをクラウドに修正するかどうかを決定します。