メインコンテンツへスキップ
Infrastructure as Code を使って OpenClaw を Render にデプロイします。付属の render.yaml Blueprint では、サービス、ディスク、環境変数を含むスタック全体が宣言的に定義されているため、ワンクリックでデプロイでき、コードと並行してインフラをバージョン管理できます。

​
前提条件

​
Render Blueprint でデプロイする

Deploy to Render このリンクをクリックすると、次のことが行われます:
  1. このリポジトリのルートにある render.yaml Blueprint から、新しい Render サービスを作成
  2. Docker イメージをビルドしてデプロイ
デプロイ後、サービス URL は https://<service-name>.onrender.com の形式になります。

​
Blueprint の理解

Render Blueprints は、インフラを定義する YAML ファイルです。この リポジトリ内の render.yaml では、OpenClaw の実行に必要なものがすべて設定されています: 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
使用されている主な Blueprint 機能:
FeaturePurpose
runtime: dockerリポジトリの Dockerfile からビルド
healthCheckPathRender が /health を監視し、不健全なインスタンスを再起動
generateValue: true暗号学的に安全な値を自動生成
disk再デプロイ後も保持される永続ストレージ

​
プランを選ぶ

PlanSpin-downDiskBest for
Free15 分のアイドル後利用不可テスト、デモ
Starterなし1GB+個人利用、小規模チーム
Standard+なし1GB+本番、複数チャネル
Blueprint のデフォルトは starter です。無料プランを使うには、 fork 側の render.yaml で plan: free に変更してください（ただし注意: 永続ディスクがないため、OpenClaw の状態はデプロイごとにリセットされます）。

​
デプロイ後

​
Control UI にアクセスする

Web ダッシュボードは https://<your-service>.onrender.com/ で利用できます。 設定された shared secret を使って接続します。このデプロイテンプレートでは OPENCLAW_GATEWAY_TOKEN が自動生成されます（Dashboard → 対象サービス → Environment で確認できます）。password auth に置き換えた場合は、代わりにその password を使ってください。

​
Render Dashboard の機能

​
ログ

Dashboard → 対象サービス → Logs でリアルタイムログを表示できます。フィルター対象:
  • ビルドログ（Docker イメージ作成）
  • デプロイログ（サービス起動）
  • ランタイムログ（アプリケーション出力）

​
Shell アクセス

デバッグ用に、Dashboard → 対象サービス → Shell から shell セッションを開けます。永続ディスクは /data にマウントされています。

​
環境変数

Dashboard → 対象サービス → Environment で変数を変更します。変更すると自動的に再デプロイされます。

​
自動デプロイ

元の OpenClaw リポジトリを使用している場合、Render は OpenClaw を自動デプロイしません。更新するには、ダッシュボードから手動で Blueprint sync を実行してください。

​
カスタムドメイン

  1. Dashboard → 対象サービス → Settings → Custom Domains に移動
  2. ドメインを追加
  3. 指示どおりに DNS を設定（*.onrender.com への CNAME）
  4. Render が TLS 証明書を自動的にプロビジョニング

​
スケーリング

Render は水平スケーリングと垂直スケーリングをサポートしています:
  • 垂直: プランを変更して CPU/RAM を増やす
  • 水平: インスタンス数を増やす（Standard プラン以上）
OpenClaw では通常、垂直スケーリングで十分です。水平スケーリングには、sticky session または外部状態管理が必要です。

​
バックアップと移行

Render Dashboard の shell アクセスを使って、いつでも状態、設定、auth profile、およびワークスペースをエクスポートできます: 
openclaw backup create
これにより、OpenClaw の状態と、設定されている ワークスペースを含むポータブルなバックアップアーカイブが作成されます。詳細は Backup を参照してください。

​
トラブルシューティング

​
サービスが起動しない

Render Dashboard のデプロイログを確認してください。一般的な問題:
  • OPENCLAW_GATEWAY_TOKEN がない — Dashboard → Environment で設定されていることを確認
  • ポート不一致 — Render が期待するポートに gateway が bind するよう、OPENCLAW_GATEWAY_PORT=8080 が設定されていることを確認

​
コールドスタートが遅い（無料プラン）

無料プランのサービスは、15 分間操作がないと停止します。停止後の最初のリクエストでは、コンテナ起動中のため数秒かかります。常時稼働にするには Starter プランへアップグレードしてください。

​
再デプロイ後にデータが失われる

これは無料プランで発生します（永続ディスクなし）。有料プランへアップグレードするか、 Render shell で openclaw backup create を定期的に実行して完全バックアップをエクスポートしてください。

​
ヘルスチェック失敗

Render は、30 秒以内に /health から 200 応答が返ることを期待しています。ビルドは成功しているのにデプロイが失敗する場合、サービスの起動に時間がかかりすぎている可能性があります。次を確認してください:
  • エラーの有無をビルドログで確認
  • docker build && docker run でローカル実行できるか

​
次のステップ