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 帳戶（免費方案即可）且至少有一個專案
• Node.js 18+（Vercel CLI 需要）
• clawhub CLI 已安裝，用於技能管理

驗證你的設定：

# 檢查 OpenClaw 版本
openclaw --version

# 檢查 Vercel CLI 版本
vercel --version

# 驗證 Vercel 身份驗證
vercel whoami

如何安裝 Vercel 技能

使用一條命令安裝 Vercel 技能：

npx clawhub@latest install vercel

驗證安裝：

clawhub list

你應該在已安裝的技能列表中看到 vercel。如果你尚未連結 Vercel 專案，技能會在首次使用時提示你進行連結。

Vercel 技能設定指南

Vercel 技能需要透過 Vercel Access Token 或 Vercel CLI 登入流程進行身份驗證。我們建議使用 vercel login 以獲得最簡單的設定。

基於 Token 的身份驗證

如果你偏好使用 Token，請在 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

重要： 切勿將 Token 硬編碼在設定檔中。請使用環境變數或金鑰管理工具，例如 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. 設定自訂網域

你：「將網域 app.example.com 新增到我的 Vercel 專案。」

智慧體執行 vercel domains add app.example.com 並提供你需要在域名註冊商設定的 DNS 記錄。它也可以驗證網域設定狀態。

安全與最佳實踐

Vercel 技能可以對你的部署和專案設定執行寫入操作。請遵循以下指引以確保安全：

• 使用最小權限。 如果你在團隊中工作，請將 Token 範圍限制到特定專案，而非完整帳戶存取。
• 部署到正式環境前先審查。 始終先使用預覽部署。OpenClaw 在升級為正式版本之前會提示確認。
• 保護環境變數。 敏感值如資料庫 URL 和 API 金鑰應透過 vercel env 設定——切勿提交到原始碼中。
• 定期輪換 Token。 為你的 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 檢查你的 Token。
2. 如果已過期，請產生新的 Token 並更新你的環境變數。
3. 或者，使用 vercel login 重新進行身份驗證。

# 重新進行身份驗證
vercel login

# 或更新你的 Token
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 的建置設定一致