OpenClaw Coolify スキルガイド

OpenClaw Coolify スキル概要

Coolifyスキルは、REST APIを通じてOpenClawをCoolifyインスタンスに接続します。インストール後、OpenClawエージェントはアプリケーションのデプロイ、データベースの管理、環境変数の設定、サービスの監視を、すべて自然言語コマンドで行えるようになります。

Coolifyは、Vercel、Heroku、Netlifyのオープンソースかつセルフホスト可能な代替です。静的サイト、フルスタックアプリケーション、データベース、280以上のワンクリックサービスを自分のサーバーにデプロイできます。OpenClaw Coolifyスキルにより、インフラとデータの完全なコントロールを維持しながら、マネージドプラットフォームの利便性を得ることができます。

典型的なワークフロー：

1. OpenClawにステージングサーバーへ最新の変更をデプロイするよう依頼する。
2. エージェントがCoolify APIを呼び出し、リンクされたプロジェクトのデプロイメントをトリガーする。
3. ビルドステータスとログが読みやすい要約で返される — Coolifyダッシュボードを開く必要はない。

Coolify スキルの前提条件

Coolifyスキルをインストールする前に、以下を確認してください：

• OpenClawがインストールされ実行中（v1.0+）
• Coolifyインスタンスがサーバー上で実行中 — インストールガイド
• Coolifyダッシュボードから生成したCoolify APIトークン
• Coolifyで設定済みのアプリケーションまたはサービスが少なくとも1つ
• スキル管理用のclawhub CLIがインストール済み

セットアップの確認：

# OpenClawのバージョンを確認
openclaw --version

# Coolifyに到達可能か確認（インスタンスURLに置き換えてください）
curl -s https://your-coolify-instance.com/api/v1/healthcheck

# clawhub CLIを確認
clawhub --version

Coolify スキルのインストール方法

1つのコマンドでCoolifyスキルをインストールできます：

npx clawhub@latest install coolify

インストールを確認するには：

clawhub list

インストール済みスキルのリストにcoolifyが表示されるはずです。初回使用時に、スキルがCoolify APIエンドポイントとトークンの入力を求めます。

Coolify スキルの設定

CoolifyスキルにはAPIトークンとインスタンスURLが必要です。CoolifyダッシュボードのSettings → API Tokensからトークンを生成してください。

トークンの権限

Coolify APIトークンはインスタンスへのフルアクセスを提供します。最小権限の原則に従ってください：

| ユースケース | 推奨事項 | |----------|---------------| | 読み取り専用の監視 | ビューアーロールを持つチームメンバーアカウントでトークンを作成 | | フルデプロイメント | 管理者トークンを使用するが、確認前にすべてのアクションをレビュー | | マルチサーバー | 分離のためにサーバーごとに個別のトークンを作成 |

環境設定

# CoolifyインスタンスURLを設定
export COOLIFY_BASE_URL=https://your-coolify-instance.com

# Coolify APIトークンを設定
export COOLIFY_TOKEN=your_api_token_here

重要： トークンを設定ファイルにハードコードしないでください。環境変数または1PasswordやBitwardenなどのシークレットマネージャーを使用してください。セキュリティパッチのため、Coolifyインスタンスを常に最新バージョンに更新してください。

接続の確認

環境変数を設定した後、接続を確認してください：

# APIアクセスをテスト
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

Coolify スキルの使用例

1. アプリケーションのデプロイ

あなた：「CoolifyでWebアプリの最新バージョンをデプロイして。」

エージェントがアプリケーション名でアプリを特定し、Coolify APIを通じてデプロイメントをトリガーし、ビルドステータスをストリーミングします。デプロイメントURLとビルド時間を含む要約を受け取れます。

2. 環境変数の管理

あなた：「APIサービスのステージング環境にDATABASE_URLを追加して。」

エージェントがCoolify APIを呼び出し、指定したアプリケーションに環境変数を作成します。変数の一覧表示、更新、環境間での一括更新もリクエストできます。スキルは出力で機密値を確実にマスクします。

3. アプリケーションログの確認

あなた：「決済サービスの最後の100行のログを見せて。」

エージェントがCoolify APIを通じてコンテナログを取得し、読みやすい形式で表示します。エラーをハイライトし、一般的なパターンに基づいた修正を提案することもできます。

4. サービスの再起動

あなた：「本番サーバーのPostgreSQLデータベースを再起動して。」

エージェントが指定されたサービスに再起動コマンドを送信します。OpenClawは本番サービスの再起動や停止操作を実行する前に確認を求めます。

5. リソース使用状況の確認

あなた：「ステージングサーバーのCPUとメモリの使用状況は？」

エージェントがCoolify APIにサーバーメトリクスを問い合わせ、CPU、メモリ、ディスク使用量の要約を表示します。リソースが制限に近づいている場合、アラートを出すこともできます。

セキュリティとベストプラクティス

Coolifyスキルはサーバーとアプリケーションに対して書き込み操作を実行できます。安全に使用するために以下のガイドラインに従ってください：

• 最小権限を使用する。 最小限の権限で専用のAPIトークンを作成してください。自動化操作にメインの管理者トークンを使用しないでください。
• 本番デプロイ前にレビューする。 常にステージングでデプロイメントをテストしてください。OpenClawは本番デプロイメント前に確認を求めます。
• Coolifyを最新に保つ。 最新のセキュリティパッチを取得するため、Coolifyインスタンスを定期的に更新してください — Coolifyダッシュボードから更新するか、公式アップデートガイドを使用してください。
• インスタンスを保護する。 Coolifyをファイアウォールまたはvpnの背後に配置してください。強力なパスワードを使用し、二要素認証を有効にしてください。
• APIトークンをローテーションする。 定期的にトークンを再生成し、未使用のトークンをダッシュボードから取り消してください。
• 定期的にバックアップする。 Coolifyの組み込みS3バックアップ機能を使用して、設定とデータベースデータを保護してください。

よくあるエラーのトラブルシューティング

"Connection refused" または "ECONNREFUSED"

スキルがCoolifyインスタンスに到達できません。

1. COOLIFY_BASE_URLが正しく、プロトコル（https://）が含まれていることを確認してください。
2. Coolifyインスタンスが実行中か確認してください：サーバーでsystemctl status coolifyを実行。
3. ファイアウォールがCoolifyポート（デフォルト：8000）のトラフィックを許可していることを確認してください。
4. VPNまたはTailscaleを使用している場合、トンネルがアクティブであることを確認してください。

"Unauthorized" または "401 Error"

APIトークンが無効または期限切れです。

1. Coolify Dashboard → Settings → API Tokensでトークンを確認してください。
2. トークンが取り消されている場合は再生成してください。
3. COOLIFY_TOKEN環境変数が正しく設定されていることを確認してください。

# トークンが設定されているか確認
echo $COOLIFY_TOKEN

# 認証をテスト
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

"Application not found"

スキルが参照したアプリケーションを見つけることができません。

1. すべてのアプリケーションを一覧表示：OpenClawに「Coolifyのすべてのアプリケーションを一覧表示して」と依頼してください。
2. アプリケーション名またはUUIDがCoolifyダッシュボードのものと一致していることを確認してください。
3. APIトークンがアプリケーションを所有するチームへのアクセス権を持っていることを確認してください。