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のビルド設定と一致していることを確認してください