render.yaml Blueprint を使用して、Render に OpenClaw をデプロイします。これはサービス、ディスク、環境変数を 1 つのファイルで宣言します。
前提条件
- Render アカウント(無料枠あり)
- 使用するモデルプロバイダーの API キー
デプロイ
Render にデプロイ これにより、render.yaml から Render サービスが作成され、Docker イメージがビルドされてデプロイされます。サービス URL は https://<service-name>.onrender.com の形式になります。
Blueprint
| 機能 | 目的 |
|---|---|
runtime: docker | repo の Dockerfile からビルドします |
healthCheckPath | Render が /health を監視し、異常なインスタンスを再起動します |
generateValue: true | 暗号学的に安全な値を自動生成します |
disk | 再デプロイ後も保持される永続ストレージ |
プランの選択
| プラン | スピンダウン | ディスク | 最適な用途 |
|---|---|---|---|
| 無料 | 15 分のアイドル後 | 利用不可 | テスト、デモ |
| Starter | なし | 1GB+ | 個人利用、小規模チーム |
| Standard+ | なし | 1GB+ | 本番環境、複数チャンネル |
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 で変数を編集します。変更すると自動的に再デプロイが開始されます。自動デプロイ
接続された repo のブランチに新しいコミットが追加されると、Render は自動的に再デプロイします。自分のフォークではなくopenclaw/openclaw から直接デプロイした場合、そのトリガーを発生させる push 権限がないため、Dashboard から手動で Blueprint 同期を実行するか、サービスを自分のフォークに向けてください。
カスタムドメイン
- Dashboard → your service → Settings → Custom Domains
- ドメインを追加します
- 指示に従って DNS を設定します(
*.onrender.comへの CNAME) - Render が TLS 証明書を自動的にプロビジョニングします
スケーリング
- 垂直: CPU/RAM を増やすにはプランを変更します。通常、OpenClaw にはこれで十分です。
- 水平: インスタンス数を増やします(Standard プラン以上)。OpenClaw はランタイム状態をローカルディスクに保持するため、スティッキーセッションまたは外部状態管理が必要です。
バックアップと移行
Render Dashboard のシェルから、状態、設定、認証プロファイル、ワークスペースをいつでもエクスポートできます。トラブルシューティング
サービスが起動しない
Render Dashboard のデプロイログを確認してください。よくある問題:OPENCLAW_GATEWAY_TOKENがない — Dashboard → Environment で設定されていることを確認してください- ポートの不一致 — Gateway が Render の期待するポートにバインドするよう、
OPENCLAW_GATEWAY_PORT=8080であることを確認してください
コールドスタートが遅い(無料枠)
無料枠のサービスは、15 分間非アクティブだとスピンダウンします。スピンダウン後の最初のリクエストでは、コンテナの起動中に数秒かかります。常時稼働にするには Starter にアップグレードしてください。再デプロイ後のデータ損失
無料枠(永続ディスクなし)で発生します。有料プランにアップグレードするか、Render シェルからopenclaw backup create で定期的にバックアップをエクスポートしてください。
ヘルスチェック失敗
ビルドは成功するのにデプロイが失敗する場合、サービスの起動に時間がかかりすぎているか、/health に到達できない可能性があります。以下を確認してください。
- エラーがないかビルドログ
- コンテナがローカルで
docker build && docker runにより実行できるかどうか
次のステップ
- メッセージングチャンネルを設定する: Channels
- Gateway を設定する: Gateway configuration
- OpenClaw を最新に保つ: Updating