OpenClaw Vercel スキルガイド

OpenClaw Vercel スキル概要

Vercelスキル は、公式のVercel CLIを通じてOpenClawを Vercelプラットフォーム に接続します。インストール後、OpenClawエージェントはアプリケーションのデプロイ、環境変数の管理、ドメインの設定、ビルドログの確認を、すべて自然言語コマンドで行えるようになります。

Vercelは、Next.js、React、Svelte、その他のモダンフレームワークで構築された数百万のウェブサイトを支える、フロントエンドクラウドプラットフォームのリーダーです。OpenClaw Vercelスキルにより、エディタ、ターミナル、Vercelダッシュボード間のコンテキストスイッチングを解消できます。必要なことを説明するだけで、OpenClawが残りを処理します。

典型的なワークフロー：

1. OpenClawに現在のプロジェクトをVercelにデプロイするよう依頼する。
2. エージェントが内部で vercel deploy を実行し、プロジェクトのリンクとビルド設定を処理する。
3. プレビューURLが即座に返される — ダッシュボードを開く必要はない。

Vercel スキルの前提条件

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

• OpenClaw がインストールされ実行中（v1.0+）
• Vercel CLI がインストール済み — 公式インストールガイド
• Vercelアカウント （無料プランで利用可能）に少なくとも1つのプロジェクト
• Node.js 18+ （Vercel CLIに必要）
• スキル管理用の clawhub CLI がインストール済み

セットアップを確認：

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

# Vercel CLIのバージョンを確認
vercel --version

# Vercelの認証を確認
vercel whoami

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

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

npx clawhub@latest install vercel

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

clawhub list

インストール済みスキルの一覧に vercel が表示されるはずです。まだVercelプロジェクトをリンクしていない場合、初回使用時にスキルがリンクを促します。

Vercel スキルの設定

Vercelスキルは、Vercel Access TokenまたはVercel CLIのログインフローによる認証が必要です。最もシンプルなセットアップには vercel login の使用をお勧めします。

トークンベースの認証

トークンを使用する場合は、 vercel.com/account/tokens で作成してください：

| 設定 | 推奨事項 | |------|---------| | スコープ | フルアカウントまたは特定のチーム | | 有効期限 | 90日（定期的にローテーション） | | 名前 | openclaw-agent のようなわかりやすい名前を使用 |

環境設定

# オプション1: Vercel CLIログインを使用（推奨）
vercel login

# オプション2: Vercel Access Tokenを設定
export VERCEL_TOKEN=your_vercel_token_here

# オプション: デフォルトのチーム/スコープを設定
export VERCEL_ORG_ID=team_your_team_id
export VERCEL_PROJECT_ID=prj_your_project_id

重要： トークンを設定ファイルにハードコードしないでください。環境変数または 1Password やBitwardenなどのシークレットマネージャーを使用してください。

プロジェクトのリンク

デプロイする前に、ローカルディレクトリをVercelプロジェクトにリンクしてください：

vercel link

これにより、プロジェクト設定を含む .vercel ディレクトリが作成されます。スキルはこのリンクを使用してデプロイ先のプロジェクトを決定します。

Vercel スキルの使用例

1. プレビューにデプロイ

あなた： 「現在のプロジェクトをVercelにプレビューとしてデプロイして。」

エージェントが vercel deploy を実行し、プレビューURLを返します。本番環境に昇格する前に、このURLをチームメイトと共有してレビューできます。

2. 本番環境に昇格

あなた： 「最新のプレビューデプロイメントを本番環境に昇格して。」

エージェントが最新のプレビューデプロイメントを特定し、 vercel promote を実行して、ライブの本番バージョンにします。OpenClawは実行前に確認を求めます。

3. 環境変数の管理

あなた： 「本番環境に新しい環境変数DATABASE_URLを値postgres://...で追加して。」

エージェントが vercel env add DATABASE_URL production を実行し、値を安全に保存します。プレビュー、開発、本番環境にわたって環境変数の一覧表示、更新、削除を依頼することもできます。

4. ビルドログの確認

あなた： 「最後に失敗したデプロイメントのビルドログを見せて。」

エージェントが vercel ls で最近のデプロイメントを取得し、失敗したものを特定して、 vercel inspect でビルド出力を取得します。その後、エラーを要約し修正案を提案します。

5. カスタムドメインの設定

あなた： 「Vercelプロジェクトにドメインapp.example.comを追加して。」

エージェントが vercel domains add app.example.com を実行し、レジストラで設定する必要があるDNSレコードを提供します。ドメイン設定のステータスも確認できます。

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

Vercelスキルは、デプロイメントやプロジェクト設定に対して 書き込み操作 を実行できます。安全に利用するために以下のガイドラインに従ってください：

• 最小権限の原則を使用。 チームで作業する場合は、フルアカウントアクセスではなく特定のプロジェクトにトークンのスコープを限定してください。
• 本番環境へのデプロイ前にレビュー。 常にプレビューデプロイメントを先に使用してください。OpenClawは本番環境への昇格前に確認を求めます。
• 環境変数を保護。 データベースURLやAPIキーなどの機密値は vercel env で設定し、ソースコードにコミットしないでください。
• トークンを定期的にローテーション。 Vercel Access Tokenに90日の有効期限を設定し、積極的にローテーションしてください。
• デプロイメントを監査。 Vercelダッシュボードのアクティビティタブを定期的に確認し、CLI経由のデプロイメントをレビューしてください。
• チームスコープを使用。 マルチチーム環境では、誤ったチームにデプロイしないよう VERCEL_ORG_ID を明示的に設定してください。

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

"Error: No Project linked"

ローカルディレクトリがまだVercelプロジェクトにリンクされていません。

# 既存のプロジェクトにリンク
vercel link

# またはデプロイして新しいプロジェクトを作成
vercel deploy

アカウントに複数のプロジェクトがある場合、スキルがプロジェクト選択をガイドします。

"Error: Invalid token"

Vercel Access Tokenが見つからない、有効期限切れ、または無効化されています。

1. vercel.com/account/tokens でトークンを確認してください。
2. 有効期限切れの場合、新しいトークンを生成して環境変数を更新してください。
3. または、 vercel login で再認証してください。

# 再認証
vercel login

# またはトークンを更新
export VERCEL_TOKEN=your_new_token_here

"Build Failed: Command 'npm run build' exited with 1"

デプロイメント中にビルドコマンドが失敗しました。これは通常コードの問題であり、スキルの問題ではありません。

1. まずローカルでビルドを実行してください： npm run build
2. 環境変数の不足を確認してください — スキルは vercel env ls で一覧表示できます
3. vercel inspect <deployment-url> でビルドログの全文を確認してください
4. package.json のスクリプトとフレームワーク設定がVercelの ビルド設定 と一致していることを確認してください