Skip to content
OpenClaw Docs

Render

Render

Section titled “Render”

使用基礎架構即程式碼在 Render 上部署 OpenClaw。隨附的 render.yaml 藍圖以宣告方式定義您的整個技術堆疊、服務、磁碟、環境變數，讓您只需按一下即可部署，並將基礎架構與程式碼一併進行版本控制。

先決條件

Section titled “先決條件”

使用 Render 藍圖進行部署

Section titled “使用 Render 藍圖進行部署”

部署至 Render

點擊此連結將會：

  1. 根據此儲存庫根目錄中的 render.yaml 藍圖建立新的 Render 服務。
  2. 建置 Docker 映像檔並進行部署

部署完成後，您的服務 URL 將遵循 https://<service-name>.onrender.com 模式。

了解藍圖

Section titled “了解藍圖”

Render 藍圖是用來定義基礎架構的 YAML 檔案。此儲存庫中的 render.yaml 設定檔會設定執行 OpenClaw 所需的一切：

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 # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

使用的主要藍圖功能：

功能用途
runtime: docker從儲存庫的 Dockerfile 建置
healthCheckPathRender 監控 /health 並重新啟動狀況不佳的執行個體
generateValue: true自動產生密碼學安全的值
disk在重新部署後仍會保留的持續性儲存空間

選擇方案

Section titled “選擇方案”
方案休眠磁碟適用於
免費閒置 15 分鐘後無法使用測試、展示
入門從不1GB+個人使用、小型團隊
標準及以上從不1GB+生產環境、多頻道

藍圖預設為 starter。若要使用免費層級，請在您 fork 的 render.yaml 中變更 plan: free （但請注意：沒有持續性磁碟意味著每次部署時 OpenClaw 的狀態 都會重置）。

部署完成後

Section titled “部署完成後”

存取控制 UI

Section titled “存取控制 UI”

Web 儀表板可在 https://<your-service>.onrender.com/ 取得。

使用設定的共享金鑰進行連線。此部署範本會自動產生 OPENCLAW_GATEWAY_TOKEN（在 Dashboard → 您的服務 → Environment 中即可找到）；如果您將其替換為密碼驗證，請改用該密碼。

Render 儀表板功能

Section titled “Render 儀表板功能”

日誌

Section titled “日誌”

在 Dashboard → your service → Logs 中查看即時日誌。篩選條件：

  • 建置日誌（Docker 映像檔建立）
  • 部署日誌（服務啟動）
  • 執行時日誌（應用程式輸出）

Shell 存取

Section titled “Shell 存取”

為了進行除錯，請透過 Dashboard → your service → Shell 開啟 shell 工作階段。持久磁碟已掛載於 /data。

環境變數

Section titled “環境變數”

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

自動部署

Section titled “自動部署”

如果您使用原始的 OpenClaw 儲存庫，Render 將不會自動部署您的 OpenClaw。若要更新，請從儀表板執行手動 Blueprint 同步。

自訂網域

Section titled “自訂網域”
  1. 前往 Dashboard → your service → Settings → Custom Domains
  2. 新增您的網域
  3. 依照指示設定 DNS（CNAME 至 *.onrender.com）
  4. Render 會自動佈建 TLS 憑證

擴展

Section titled “擴展”

Render 支援水平和垂直擴展：

  • 垂直：變更方案以取得更多 CPU/RAM
  • 水平：增加執行個體數量（Standard 方案及以上）

對於 OpenClaw，垂直擴展通常已足夠。水平擴展需要sticky sessions或外部狀態管理。

備份與遷移

Section titled “備份與遷移”

您隨時可以使用 Render Dashboard 中的 shell 存取功能，匯出您的狀態、設定、設定檔和工作區：

Terminal window
openclaw backup create

這會建立一個包含 OpenClaw 狀態以及任何已設定 工作區的可攜式備份封存。詳情請參閱 Backup。

疑難排解

Section titled “疑難排解”

服務無法啟動

Section titled “服務無法啟動”

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

  • 缺少 OPENCLAW_GATEWAY_TOKEN — 請驗證其是否已在 Dashboard → Environment 中設定
  • 連接埠不符 — 請確保已設定 OPENCLAW_GATEWAY_PORT=8080，以便閘道綁定至 Render 預期的連接埠

冷啟動緩慢（免費方案）

Section titled “冷啟動緩慢（免費方案）”

免費方案的服務在閒置 15 分鐘後會進入休眠。休眠後的第一個請求需要幾秒鐘的時間讓容器啟動。升級至 Starter 方案可保持服務永遠在線。

重新部署後資料遺失

Section titled “重新部署後資料遺失”

這會發生在免費方案上（無持久磁碟）。請升級至付費方案，或 透過 Render shell 中的 openclaw backup create 定期匯出完整備份。

健康檢查失敗

Section titled “健康檢查失敗”

Render 預期在 30 秒內從 /health 收到 200 回應。如果建置成功但部署失敗，可能是服務啟動時間過長。請檢查：

  • 檢查建置日誌中的錯誤
  • 容器是否能在本機使用 docker build && docker run 執行

後續步驟

Section titled “後續步驟”