OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

渲染

在 Render 上使用儲存庫的 render.yaml Blueprint 部署 OpenClaw。此檔案集中宣告服務、磁碟與環境變數。

先決條件

部署

部署至 Render

這會依據 render.yaml 建立 Render 服務、建置 Docker 映像檔並進行部署。你的服務 URL 格式為 https://<service-name>.onrender.com。

Blueprint

yaml
services:  - type: web    name: openclaw    runtime: docker    plan: starter    healthCheckPath: /health    envVars:      - key: OPENCLAW_GATEWAY_PORT        value: "8080"      - key: OPENCLAW_STATE_DIR        value: /data/.openclaw      - key: OPENCLAW_WORKSPACE_DIR        value: /data/workspace      - key: OPENCLAW_GATEWAY_TOKEN        generateValue: true # 自動產生安全權杖    disk:      name: openclaw-data      mountPath: /data      sizeGB: 1
功能 用途
runtime: docker 使用儲存庫的 Dockerfile 建置
healthCheckPath Render 監控 /health，並重新啟動狀態異常的執行個體
generateValue: true 自動產生密碼學安全值
disk 可在重新部署後保留資料的持久性儲存空間

選擇方案

方案 縮減至停止狀態 磁碟 最適合
免費 閒置 15 分鐘後 不提供 測試、示範
入門 永不 1GB 以上 個人使用、小型團隊
標準以上 永不 1GB 以上 正式環境、多個頻道

Blueprint 預設使用 starter。若要使用免費方案，請在分支儲存庫的 render.yaml 中將其改為 plan: free。請注意，由於沒有持久性磁碟，每次部署都會重設 OpenClaw 狀態。

部署後

存取控制介面

網頁儀表板位於 https://<your-service>.onrender.com/。請使用共用密鑰連線：自動產生的 OPENCLAW_GATEWAY_TOKEN（可在 Dashboard → your service → Environment 中找到）；若已改用密碼驗證，則使用你的密碼。

日誌

Dashboard → your service → Logs 會顯示建置日誌（建立 Docker 映像檔）、部署日誌（服務啟動）和執行階段日誌（應用程式輸出）。

Shell 存取

Dashboard → your service → Shell 會開啟 Shell 工作階段。持久性磁碟掛載於 /data。

環境變數

在 Dashboard → your service → Environment 中編輯變數。變更會觸發自動重新部署。

自動部署

連線的儲存庫分支有新提交時，Render 會自動重新部署。如果你直接從 openclaw/openclaw 部署，而不是從自己的分支儲存庫部署，就沒有推送權限可觸發自動部署；因此，請從 Dashboard 手動執行 Blueprint 同步以進行更新，或將服務指向你自己的分支儲存庫。

自訂網域

  1. Dashboard → your service → Settings → Custom Domains
  2. 新增你的網域
  3. 依照指示設定 DNS（將 CNAME 指向 *.onrender.com）
  4. Render 會自動佈建 TLS 憑證

擴充規模

  • 垂直擴充：變更方案以取得更多 CPU/RAM。通常已足以供 OpenClaw 使用。
  • 水平擴充：增加執行個體數量（標準方案以上）。由於 OpenClaw 將執行階段狀態保存在本機磁碟，因此需要黏性工作階段或外部狀態管理。

備份與遷移

你可以隨時從 Render Dashboard Shell 匯出狀態、設定、驗證設定檔和工作區：

bash
openclaw backup create

這會建立可攜式備份封存檔。請參閱備份。

疑難排解

服務無法啟動

請檢查 Render Dashboard 中的部署日誌。常見問題：

  • 缺少 OPENCLAW_GATEWAY_TOKEN — 確認已在 Dashboard → Environment 中設定
  • 連接埠不符 — 確認 OPENCLAW_GATEWAY_PORT=8080，讓閘道繫結至 Render 預期的連接埠

冷啟動緩慢（免費方案）

免費方案的服務會在閒置 15 分鐘後縮減至停止狀態；容器啟動時，停止後的第一個請求會需要數秒。升級至入門方案即可讓服務持續運作。

重新部署後資料遺失

這會發生在免費方案（沒有持久性磁碟）。請升級至付費方案，或定期從 Render Shell 使用 openclaw backup create 匯出備份。

健康檢查失敗

如果建置成功但部署失敗，可能是服務啟動時間過長，或無法存取 /health。請檢查：

  • 建置日誌中是否有錯誤
  • 容器是否可在本機使用 docker build && docker run 執行

後續步驟

Was this useful?
On this page

On this page