---
read_when:
    - OpenClaw を Render にデプロイする場合
    - Render Blueprints による宣言的なクラウドデプロイを使いたい場合
summary: Infrastructure as Code を使って OpenClaw を Render にデプロイする
title: Render
x-i18n:
    generated_at: "2026-04-05T12:49:23Z"
    model: gpt-5.4
    provider: openai
    source_hash: 379297f0298ddac0c1c657695f52619bb482f7b76d358e765880726f6f558c88
    source_path: install/render.mdx
    workflow: 15
---

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

## 前提条件

- [Render アカウント](https://render.com)（無料プランあり）
- 使用する [model provider](/providers) の API キー

## Render Blueprint でデプロイする

[Deploy to Render](https://render.com/deploy?repo=https://github.com/openclaw/openclaw)

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

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

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

## Blueprint の理解

Render Blueprints は、インフラを定義する YAML ファイルです。この
リポジトリ内の `render.yaml` では、OpenClaw の実行に必要なものがすべて設定されています:

```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 # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
```

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

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

## プランを選ぶ

| Plan      | Spin-down         | Disk          | Best for                      |
| --------- | ----------------- | ------------- | ----------------------------- |
| Free      | 15 分のアイドル後 | 利用不可 | テスト、デモ                |
| 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、およびワークスペースをエクスポートできます:

```bash
openclaw backup create
```

これにより、OpenClaw の状態と、設定されている
ワークスペースを含むポータブルなバックアップアーカイブが作成されます。詳細は [Backup](/cli/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` でローカル実行できるか

## 次のステップ

- メッセージングチャネルを設定する: [Channels](/ja-JP/channels)
- Gateway を設定する: [Gateway configuration](/gateway/configuration)
- OpenClaw を最新の状態に保つ: [Updating](/install/updating)
