Hosting

Render

Render

Infrastructure as Code を使って Render に OpenClaw をデプロイします。同梱の render.yaml Blueprint は、サービス、ディスク、環境変数を含むスタック全体を宣言的に定義するため、ワンクリックでデプロイでき、コードと一緒にインフラをバージョン管理できます。

前提条件

Render Blueprint でデプロイする

Deploy to Render

このリンクをクリックすると次のことが行われます。

  1. このリポジトリのルートにある render.yaml Blueprint から新しい Render サービスを作成する
  2. Docker イメージをビルドしてデプロイする

デプロイ後、サービス URL は https://<service-name>.onrender.com の形式になります。

Blueprint を理解する

Render Blueprint は、インフラを定義する 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 # 安全なトークンを自動生成
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

使用されている主な Blueprint 機能:

機能 目的
runtime: docker リポジトリの Dockerfile からビルド
healthCheckPath Render が /health を監視し、不健全なインスタンスを再起動
generateValue: true 暗号学的に安全な値を自動生成
disk 再デプロイ後も保持される永続ストレージ

プランを選ぶ

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

Blueprint のデフォルトは starter です。無料プランを使うには、fork 側の render.yamlplan: free に変更してください(ただし、永続ディスクがないため OpenClaw の状態はデプロイごとにリセットされる点に注意してください)。

デプロイ後

Control UI にアクセスする

Web ダッシュボードは https://<your-service>.onrender.com/ で利用できます。

設定された共有 secret で接続してください。このデプロイテンプレートは OPENCLAW_GATEWAY_TOKEN を自動生成します(Dashboard → your service → Environment で確認できます)。これをパスワード認証に置き換えた場合は、代わりにそのパスワードを使ってください。

Render Dashboard の機能

ログ

Dashboard → your service → Logs でリアルタイムログを確認できます。次で絞り込めます。

  • ビルドログ(Docker イメージ作成)
  • デプロイログ(サービス起動)
  • ランタイムログ(アプリケーション出力)

シェルアクセス

デバッグ用に、Dashboard → your service → Shell からシェルセッションを開けます。永続ディスクは /data にマウントされます。

環境変数

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

自動デプロイ

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

カスタムドメイン

  1. Dashboard → your service → Settings → Custom Domains に移動します
  2. ドメインを追加します
  3. 指示どおりに DNS を設定します(*.onrender.com への CNAME)
  4. Render が自動的に TLS 証明書を発行します

スケーリング

Render は水平スケーリングと垂直スケーリングをサポートしています。

  • 垂直: プランを変更して CPU/RAM を増やす
  • 水平: インスタンス数を増やす(Standard プラン以上)

OpenClaw では、通常は垂直スケーリングで十分です。水平スケーリングには sticky session または外部状態管理が必要です。

バックアップと移行

Render Dashboard のシェルアクセスを使って、状態、config、auth profile、ワークスペースをいつでもエクスポートできます。

openclaw backup create

これにより、OpenClaw の状態と設定済みワークスペースを含む持ち運び可能なバックアップアーカイブが作成されます。詳細は Backup を参照してください。

トラブルシューティング

サービスが起動しない

Render Dashboard のデプロイログを確認してください。よくある原因:

  • OPENCLAW_GATEWAY_TOKEN が不足している — Dashboard → Environment で設定されていることを確認してください
  • ポート不一致 — Render が期待するポートに gateway が bind するよう、OPENCLAW_GATEWAY_PORT=8080 が設定されていることを確認してください

コールドスタートが遅い(無料プラン)

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

再デプロイ後にデータが消える

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

ヘルスチェック失敗

Render は 30 秒以内に /health から 200 応答を期待します。ビルドは成功するのにデプロイが失敗する場合、サービスの起動に時間がかかりすぎている可能性があります。以下を確認してください。

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

次のステップ