OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

Render

Render に OpenClaw をデプロイするには、リポジトリの render.yaml Blueprint を使用します。この Blueprint では、サービス、ディスク、環境変数を1つのファイルで定義します。

前提条件

デプロイ

Render にデプロイ

これにより、render.yaml から Render サービスが作成され、Docker イメージがビルドされてデプロイされます。サービス URL は https://<service-name>.onrender.com という形式になります。

Blueprint

yaml
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 # 安全なトークンを自動生成    disk:      name: openclaw-data      mountPath: /data      sizeGB: 1
機能 目的
runtime: docker リポジトリの Dockerfile からビルド
healthCheckPath Render が /health を監視し、異常なインスタンスを再起動
generateValue: true 暗号学的に安全な値を自動生成
disk 再デプロイ後も保持される永続ストレージ

プランの選択

プラン スピンダウン ディスク 最適な用途
Free アイドル状態が15分続いた後 利用不可 テスト、デモ
Starter なし 1GB以上 個人利用、小規模チーム
Standard+ なし 1GB以上 本番環境、複数チャネル

Blueprint のデフォルトは starter です。無料プランを使用するには、フォーク内の render.yaml にある plan: free を変更します。ただし、永続ディスクがないため、OpenClaw の状態はデプロイのたびにリセットされます。

デプロイ後

Control UI へのアクセス

Web ダッシュボードは https://<your-service>.onrender.com/ で利用できます。共有シークレットで接続してください。自動生成された OPENCLAW_GATEWAY_TOKEN（Dashboard → your service → Environment で確認できます）、またはパスワード認証に切り替えた場合はパスワードを使用します。

ログ

Dashboard → your service → Logs には、ビルドログ（Docker イメージの作成）、デプロイログ（サービスの起動）、ランタイムログ（アプリケーションの出力）が表示されます。

シェルアクセス

Dashboard → your service → Shell でシェルセッションを開きます。永続ディスクは /data にマウントされています。

環境変数

Dashboard → your service → Environment で変数を編集します。変更すると自動的に再デプロイされます。

自動デプロイ

接続されたリポジトリのブランチに新しいコミットが追加されると、Render は自動的に再デプロイします。自身のフォークではなく openclaw/openclaw から直接デプロイした場合、再デプロイをトリガーするためのプッシュ権限がありません。そのため、Dashboard から Blueprint の同期を手動で実行するか、サービスの参照先を自身のフォークに変更して更新してください。

カスタムドメイン

  1. Dashboard → your service → Settings → Custom Domains
  2. ドメインを追加
  3. 指示に従って DNS を設定（*.onrender.com への CNAME）
  4. Render が TLS 証明書を自動的にプロビジョニング

スケーリング

  • 垂直スケーリング：プランを変更して CPU/RAM を増やします。通常、OpenClaw にはこれで十分です。
  • 水平スケーリング：インスタンス数を増やします（Standard プラン以上）。OpenClaw はランタイム状態をローカルディスクに保持するため、スティッキーセッションまたは外部状態管理が必要です。

バックアップと移行

Render Dashboard のシェルから、状態、設定、認証プロファイル、ワークスペースをいつでもエクスポートできます。

bash
openclaw backup create

これにより、移植可能なバックアップアーカイブが作成されます。バックアップを参照してください。

トラブルシューティング

サービスが起動しない

Render Dashboard でデプロイログを確認してください。一般的な問題は次のとおりです。

  • OPENCLAW_GATEWAY_TOKEN がない — Dashboard → Environment で設定されていることを確認してください
  • ポートの不一致 — Gateway が Render の想定するポートにバインドされるよう、OPENCLAW_GATEWAY_PORT=8080 であることを確認してください

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

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

再デプロイ後のデータ消失

無料プランでは永続ディスクがないため発生します。有料プランにアップグレードするか、Render のシェルから openclaw backup create を使用して定期的にバックアップをエクスポートしてください。

ヘルスチェックの失敗

ビルドは成功するもののデプロイに失敗する場合、サービスの起動に時間がかかりすぎているか、/health に到達できない可能性があります。次を確認してください。

  • ビルドログにエラーがないか
  • コンテナが docker build && docker run を使用してローカルで実行できるか

次のステップ

Was this useful?
On this page

On this page