OpenClaw LogoOpenClaw AI
Back to Blog

RailwayでOpenClawをデプロイする：完全ガイド

Claw
RailwayでOpenClawをデプロイする：完全ガイド

OpenClawとは？

OpenClaw（旧称：Clawdbot / Moltbot）は、オープンソースのセルフホスト型AIパーソナルアシスタントフレームワークです。Telegram、Discord、WhatsApp、Slackなどのチャットプラットフォームを通じて対話し、電子メールの管理、スケジュールの調整、コードの実行、ウェブの閲覧、反復タスクの自動化などを支援します。データは完全に自己管理され、すべての情報はあなた自身のインスタンスに保存されます。

なぜRailwayを選ぶのか？

現在、RailwayはOpenClawをデプロイするための最も簡単で安定したクラウドベースの方法です。VPSのレンタルやDockerの独自設定と比較して、Railwayの利点は以下の通りです：

  • ワンクリックデプロイテンプレート: 公式のドキュメント（docs.openclaw.ai）で強く推奨されており、コミュニティテンプレートから2000回以上の本番デプロイが完了しています。
  • ターミナル操作ゼロ: 設定はブラウザ内の /setup ウィザードを通じて完全に行われ、コマンドを入力する必要はありません。
  • HTTPSとドメインの標準装備: Railwayは *.up.railway.app ドメインとSSL証明書を自動的に提供し、カスタムドメインもサポートしています。
  • 永続的ストレージ: 設定とデータはRailway Volumesを使用して保存されるため、再デプロイしてもデータが失われることはありません。
  • 低コスト: 無料枠で初期テストに十分対応でき、Hobbyプランはトラフィックに応じて月額約$5から利用可能です。

事前準備

始める前に、以下の準備が必要です：

項目説明
Railway アカウント で登録します。GitHubアカウントでのログインを強く推奨します。無料枠はクレジットカードなしで利用可能です。
AI プロバイダーのAPIキー最低1つ必要：Anthropic (Claude)、OpenAI (GPT)、Google Gemini、または OpenRouter（無料クレジットがあり安価でのモデル切り替えが可能なため、初心者におすすめ）。
チャットチャネルのトークン (任意)Telegram Bot トークン（BotFatherから取得、最も簡単）、Discord Bot トークン、Slack App トークンなど。

完全なデプロイ手順（所要時間：約5–12分）

ステップ1：ワンクリックデプロイテンプレートをクリック

現在、最も利用されており推奨されるテンプレートのパスは以下の通りです：

  • 公式ドキュメントからのリンク（推奨）: https://railway.com/new/template/openclaw-railway-template にアクセスし、ページ上の「Deploy on Railway」ボタンをクリックします。
  • 主流のコミュニティテンプレート: Railwayのテンプレートマーケットプレイスで「OpenClaw」または「Clawdbot」を検索し、デプロイ数が多くメンテナンスが活発なテンプレートを選択します。

クリックするとRailwayのインターフェースにリダイレクトされます。「Deploy Now」を押して開始します。

ステップ2：環境変数の設定

Railwayは必須および推奨の環境変数を入力するよう求めてきます。テンプレートにはヒントが含まれているので、それに従ってください：

変数名推奨値 / 説明必須か？
SETUP_PASSWORD強力なパスワードを設定してください（8〜20文字、/setupウィザードへのログインに使用するため必ず覚えておいてください）必須
OPENCLAW_GATEWAY_TOKEN安全な文字列（32文字以上、パスワードマネージャーによる生成を推奨。アプリとGateway間の認証キーです）必須
PORT8080（多くのテンプレートで事前設定済みです。空欄にするか8080を入力してください）推奨
OPENCLAW_STATE_DIR/data/.openclaw（設定および認証情報の永続パス）推奨
OPENCLAW_WORKSPACE_DIR/data/workspace（ワークスペースの永続パス）推奨
ENABLE_WEB_TUItrue（デバッグを容易にするためのWebターミナルUIを有効にします）任意

ヒント: OPENAI_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEYなどの他の変数は、後からSetupウィザードで入力可能です。このステップではスキップしても問題ありません。

ステップ3：ボリュームの追加（永続的ストレージ、絶対にお忘れなく！）

このステップは非常に重要です。Railwayのコンテナファイルシステムは一時的（ephemeral）であり、再起動や再デプロイを越えてデータを保持するには、Volumeをマウントする必要があります。

手順：

  1. デプロイ後、サービス（Service）ページに移動します。
  2. Volumes セクションを見つけ、+ New Volume をクリックします。
  3. マウントパス（Mount Path）は必ず /data に設定してください。ここに設定ファイル、長期記憶、デバイスのペアリング情報が保存されます。
  4. 5GBのスペースを割り当てることをお勧めします（個人利用には十分以上です）。
  5. 作成後、Redeploy をクリックしてVolumeを適用します。

警告: Volumeがない状態で再起動や再デプロイを行うと、すべての設定が消去され、最初からやり直す必要があります。

ステップ4：パブリックネットワークの有効化

サービスの設定（Settings）で：

  1. Settings → Public Networking に移動します。
  2. HTTP Proxyを有効にし、ポートを 8080 に設定します。
  3. Railwayは自動的にドメイン（例：https://<project-name>-production.up.railway.app）を割り当てます。ここでカスタムドメインをバインドすることも可能です。

このパブリックURLをコピーして保存してください。後のステップで必要になります。

ステップ5：デプロイ完了を待つ

ビルドとデプロイのプロセスには通常2〜5分かかります。Railwayの Deployments → View Logs でログを確認できます。以下のような内容が表示されれば、正常に起動しています：

ステップ6：Setupウィザードの実行（もっとも重要なステップ）

ブラウザを開き、以下のURLにアクセスします：

OpenClaw Setup Wizard

システムからHTTP Basic認証ウィンドウが表示されます：

  • ユーザー名: 任意の文字列（admin など）を入力しますが、無視されます。
  • パスワード: ステップ2で設定した SETUP_PASSWORD を入力します。

ログインすると、Setupウィザードに入ります。画面の指示に従って以下の手順を完了させます：

  1. LLMプロバイダーの選択: OpenRouter（テスト用の無料枠あり）、Anthropic、Google Gemini、またはOpenAIを推奨します。
  2. APIキーの入力: プロバイダーのAPIキーを貼り付けます。まだお持ちでない場合は、 に登録して無料クレジットを取得し、Claude、Gemini、Llamaなどの各モデルを低コストで試すことをお勧めします。
  3. チャットチャネルのバインド（推奨）: Telegramが最も簡単です（BotFatherからBot Tokenを取得）。Discordの場合は、OAuth2 URLジェネレーターで bot と applications.commands のスコープにチェックを入れてからBotを招待する必要があります。
  4. Gateway Tokenの入力: ステップ2で設定した OPENCLAW_GATEWAY_TOKEN を入力します。
  5. その他のオプション: ブラウザツールやファイルシステムへのアクセスなどは、現時点ではデフォルト値のままで構いません。
  6. Run Setup / Save をクリックし、成功の表示が出るまで10〜30秒待ちます。

ステップ7：デバイスのペアリングと使用開始

  1. Telegram（または設定したアプリ）でBotを見つけ、任意のメッセージ（hi や /start など）を送信します。
  2. Botは "Pairing Required"（ペアリングが必要です）と返信します。
  3. ブラウザに戻り、https://あなたのRailwayドメイン/openclaw （またはルートURL）を開きます。
  4. Control UIの Pending Devices リストを見つけ、対象デバイスの Approve をクリックします。
  5. 再度メッセージを送信すると、AIと正常に対話できるようになります！

デプロイ後の便利なURL

URL目的
https://あなたのドメイン/setup（パスワード保護あり）設定変更やバックアップ用のSetupウィザード
https://あなたのドメイン/openclawデバイス管理やチャットログ用のControl UIダッシュボード
https://あなたのドメイン/tuiWebターミナルUI（ENABLE_WEB_TUI=true が必要）

よくある質問とトラブルシューティング

「Internal error」または「Gateway did not become ready」

1〜2分待ってから再試行してください。解決しない場合はRailway内で Redeploy をクリックします。ログで明確なエラー（APIキーが無効など）がないか確認してください。

Control UIに「gateway disconnected」または認証エラーと表示される

最初から /openclaw にアクセスしないでください。まず /setup を開き、そこにある「Open OpenClaw UI」ボタンをクリックします。Setupページは認証トークンをUIに渡します。これを飛ばすとトークン不足となり、接続エラーになります。

「Pairing required」または「Disconnected (1008)」

https://あなたのドメイン/setup にアクセスし、Devicesエリアで「Manage Devices」または「Approve Latest Request」を手動でクリックします。Gateway Tokenが正しく（大文字と小文字を区別して）入力されているか確認してください。

AIモデルの切り替え

OpenClaw CLIを使用してモデルを切り替えることができます。Web TUIが有効な場合、/tui で以下を実行します：

あるいは、/setup に戻ってプロバイダーとAPIキーを更新し、Setupを再実行しても構いません。

設定が壊れているか、奇妙なエラーが出る

/setup にアクセスし、「Run Doctor」 ボタンをクリックします。これにより openclaw doctor --repair が実行され、ヘルスチェックと設定のバックアップが行われ、認識不能な設定や壊れた設定が削除されます。

コスト見積もり

項目費用
Railway初期テストには無料枠で十分です。Hobbyプランはトラフィック等に応じて月額約$5からです。
LLM 推論OpenRouterの無料モデルを使用すればほぼ無料から開始できます。Claude Sonnetなどの有料モデルは使用量に応じて課金されます。

高度な操作

コンテナのシェルにアクセスする

ターミナルコマンドを実行する必要がある場合：

  • Web TUI: ENABLE_WEB_TUI=true を設定してデプロイし、/tui にアクセスします。
  • Railway CLI: ローカルにRailway CLIをインストールし、railway link で接続後、railway shell を使用してコンテナに入ります。

バックアップと移行

  • 手動バックアップ: /setup にアクセスし、Export Backupダウンローダー（.zip 形式）をクリックします。これを任意のプラットフォーム（VPS、Docker、ホームサーバー）で復元できます。
  • 自動バックアップ: rclone を使用して、/data ディレクトリをクラウドストレージに定期的に同期させることができます。
  • 他への移行: バックアップ用のZIPをエクスポートし、新しいプラットフォームでOpenClawをデプロイしてインポートします。Railwayにロックインされることはありません。

マルチインスタンスデプロイ

Railway上でテンプレートを複数回デプロイすることができます。各インスタンスは独自のドメイン、Volume、設定を持つため、個人用と作業用を簡単に分けることができます。

まとめ

Railway上でOpenClawをデプロイするワークフロー全体は、次の5つの主要な手順で構成されます：テンプレートをクリック → 環境変数を設定 → Volumeをマウント → パブリックネットワークの有効化 → Setupウィザードの完了。これらはすべてブラウザ上で完結します。もし何らかの障害に遭遇した場合は、Railwayのデプロイログを確認することで原因をほぼ特定できます。 *