Render

使用基礎設施即程式碼在 Render 上部署 OpenClaw。隨附的 render.yaml Blueprint 以宣告方式定義了您的整個技術堆疊、服務、磁碟和環境變數，因此您可以單擊進行部署，並與程式碼一起對基礎設施進行版本控制。

先決條件

• 一個 Render 帳戶 （提供免費層級）
• 來自您首選的 模型提供者 的 API 金鑰

使用 Render Blueprint 部署

部署到 Render

點擊此連結將會：

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

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

了解 Blueprint

Render Blueprints 是定義基礎設施的 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

使用的關鍵 Blueprint 功能：

功能	用途
runtime: docker	從儲存庫的 Dockerfile 建置
healthCheckPath	Render 監控 /health 並重新啟動不健康的實例
generateValue: true	自動生成密碼學安全的值
disk	在重新部署後仍然存在的持久性儲存空間

選擇方案

方案	休眠	磁碟	最適合
免費	閒置 15 分鐘後	不可用	測試、示範
入門	永不	1GB+	個人使用、小團隊
標準版以上	永不	1GB+	正式環境、多個頻道

Blueprint 預設為 starter。若要使用免費層級，請在您分支儲存庫的 render.yaml 中變更 plan: free（但請注意：沒有持久性磁碟意味著每次部署時配置都會重設）。

部署完成後

存取控制介面

網頁儀表板可在 https://<your-service>.onrender.com/ 存取。

使用部署期間自動產生的 OPENCLAW_GATEWAY_TOKEN 值進行連線（可在 Dashboard → your service → Environment 中找到）。

Render Dashboard 功能

日誌

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

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

Shell 存取

若要進行除錯，請透過 Dashboard → your service → Shell 開啟 shell 會話。永久性磁碟已掛載於 /data。

環境變數

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

自動部署

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

自訂網域

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

擴展

Render 支援水平和垂直擴展：

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

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

備份與移轉

隨時使用 Render Dashboard 中的 shell 存取權匯出您的設定和工作區：

openclaw backup create

這會建立一個可攜式備份存檔，您可以在任何 OpenClaw 主機上還原。詳情請參閱 備份。

疑難排解

服務無法啟動

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

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

冷啟動緩慢（免費層級）

免費層級服務會在閒置 15 分鐘後休眠。休眠後的第一個請求在容器啟動時需要幾秒鐘。升級至 Starter 方案可保持隨時待命。

重新部署後資料遺失

這發生在免費層級（無永久性磁碟）。升級至付費方案，或在 Render shell 中定期透過 openclaw backup create 匯出您的設定。

健康檢查失敗

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

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

後續步驟

• 設定訊息通道：通道
• 設定閘道：閘道設定
• 保持 OpenClaw 為最新狀態：更新