在 Render 上部署

使用基礎架構即代碼在 Render 上部署 OpenClaw。包含的 render.yaml 藍圖以聲明式方式定義了您的整個技術堆疊、服務、磁碟和環境變量，因此您可以單擊進行部署，並將基礎架構與代碼一起進行版本控制。

先決條件

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

使用 Render 藍圖進行部署

部署至 Render

點擊此連結將會：

1. 根據此儲存庫根目錄中的 render.yaml 藍圖建立一個新的 Render 服務。
2. 提示您設定 SETUP_PASSWORD
3. 建置 Docker 映像檔並進行部署

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

了解藍圖

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

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # prompts during deploy
      - 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 建置
healthCheckPath	Render 監控 /health 並重新啟動不正常的執行個體
sync: false	在部署期間提示輸入值（秘密）
generateValue: true	自動產生密碼學安全的值
disk	在重新部署後仍然存在的持久儲存空間

選擇方案

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

藍圖預設為 starter。若要使用免費層，請在您 fork 的儲存庫中 render.yaml 變更 plan: free（但請注意：無持久磁碟意味著每次部署時設定會重置）。

部署完成後

完成設定精靈

1. 導覽至 https://<your-service>.onrender.com/setup
2. 輸入您的 SETUP_PASSWORD
3. 選擇一個模型提供商並貼上您的 API 金鑰
4. 選擇性地配置訊息通道（Telegram、Discord、Slack）
5. 點擊 Run setup

存取控制介面

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

Render 儀表板功能

日誌

在 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，垂直擴展通常已足夠。水平擴展需要黏性會話或外部狀態管理。

備份與移轉

隨時匯出您的設定與工作區：

https://<your-service>.onrender.com/setup/export

這會下載一個可攜式備份，您可以在任何 OpenClaw 主機上還原。

疑難排解

服務無法啟動

檢查 Render 儀表板中的部署日誌。常見問題：

• 缺少 SETUP_PASSWORD — Blueprint 會提示輸入此項，但請確認已設定
• 連接埠不符 — 確認 PORT=8080 與 Dockerfile 中暴露的連接埠相符

冷啟動緩慢（免費方案）

免費方案的服務在閒置 15 分鐘後會進入休眠。休眠後的首次請求在容器啟動時需要幾秒鐘的時間。升級至 Starter 方案可保持永久運作。

重新部署後資料遺失

這發生在免費方案上（無持久磁碟）。升級至付費方案，或 定期透過 /setup/export 匯出您的設定。

健康檢查失敗

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

• 建置記錄中的錯誤
• 容器是否能以 docker build && docker run 在本地執行