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 Token
• 至少一個在 Coolify 中設定好的應用程式或服務
• clawhub CLI 已安裝，用於技能管理

驗證你的設定：

# 檢查 OpenClaw 版本
openclaw --version

# 驗證 Coolify 是否可連線（請替換為你的執行個體 URL）
curl -s https://your-coolify-instance.com/api/v1/healthcheck

# 檢查 clawhub CLI
clawhub --version

如何安裝 Coolify 技能

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

npx clawhub@latest install coolify

驗證安裝：

clawhub list

你應該在已安裝的技能列表中看到 coolify。技能會在首次使用時提示你輸入 Coolify API 端點和 Token。

Coolify 技能設定指南

Coolify 技能需要 API Token 和你的執行個體 URL。請在 Coolify 儀表板的 Settings → API Tokens 中產生 Token。

Token 權限

Coolify API Token 提供對你執行個體的完整存取權限。請遵循最小權限原則：

| 使用情境 | 建議 | |----------|------| | 唯讀監控 | 在具有檢視者角色的團隊成員帳戶上建立 Token | | 完整部署 | 使用管理員 Token，但在確認前審查所有操作 | | 多伺服器 | 為每台伺服器建立獨立的 Token 以實現隔離 |

環境設定

# 設定你的 Coolify 執行個體 URL
export COOLIFY_BASE_URL=https://your-coolify-instance.com

# 設定你的 Coolify API Token
export COOLIFY_TOKEN=your_api_token_here

重要： 切勿將 Token 硬編碼在設定檔中。請使用環境變數或金鑰管理工具，例如 1Password 或 Bitwarden。請將你的 Coolify 執行個體更新至最新版本以取得安全修補。

驗證連線

設定環境變數後，驗證連線：

# 測試 API 存取
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

Coolify 技能使用範例

1. 部署應用程式

你：「將我的網頁應用程式的最新版本部署到 Coolify。」

智慧體透過名稱識別你的應用程式，透過 Coolify API 觸發部署，並串流傳送建置狀態。你會收到包含部署 URL 和建置時間的摘要。

2. 管理環境變數

你：「將 DATABASE_URL 新增到我的 API 服務的預備環境中。」

智慧體呼叫 Coolify API，在你指定的應用程式上建立環境變數。你也可以要求列出、更新或批次更新跨環境的變數。技能會確保敏感值在輸出中被遮蔽。

3. 檢視應用程式日誌

你：「顯示付款服務的最近 100 行日誌。」

智慧體透過 Coolify API 取得容器日誌，並以易讀的格式呈現。它還可以標記錯誤，並根據常見模式建議修復方案。

4. 重新啟動服務

你：「重新啟動我正式伺服器上的 PostgreSQL 資料庫。」

智慧體向指定服務發送重新啟動命令。OpenClaw 在對正式服務執行任何重新啟動或停止操作之前，會提示你進行確認。

5. 檢查資源使用情況

你：「我的預備伺服器使用了多少 CPU 和記憶體？」

智慧體查詢 Coolify API 以取得伺服器指標，並呈現 CPU、記憶體和磁碟使用的摘要。如果任何資源接近其限制，它會發出警示。

安全與最佳實踐

Coolify 技能可以對你的伺服器和應用程式執行寫入操作。請遵循以下指引以確保安全：

• 使用最小權限。 建立具有最小權限的專用 API Token。避免在自動化操作中使用主要管理員 Token。
• 部署到正式環境前先審查。 始終先在預備環境測試部署。OpenClaw 在正式部署之前會提示確認。
• 保持 Coolify 更新。 定期更新你的 Coolify 執行個體以取得最新的安全修補——從 Coolify 儀表板執行更新或使用官方更新指南。
• 保護你的執行個體。 將 Coolify 放在防火牆或 VPN 之後。使用強密碼並啟用雙因素驗證。
• 輪換 API Token。 定期重新產生 Token，並從儀表板撤銷未使用的 Token。
• 定期備份。 使用 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 Token 無效或已過期。

1. 在 Coolify Dashboard → Settings → API Tokens 檢查你的 Token。
2. 如果 Token 已被撤銷，請重新產生。
3. 驗證 COOLIFY_TOKEN 環境變數是否正確設定。

# 驗證 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 Token 具有存取該應用程式所屬團隊的權限。