Fly.io

**目標：**讓 OpenClaw 閘道在具備持久性儲存空間、自動 HTTPS 及 Discord／頻道存取功能的 Fly.io 機器上執行。

所需項目

• 已安裝 flyctl 命令列介面
• Fly.io 帳號（免費方案即可）
• 模型驗證：所選模型供應商的 API 金鑰
• 頻道認證資訊：Discord 機器人權杖、Telegram 權杖等

初學者快速流程

1. 複製儲存庫、自訂 fly.toml
2. 建立應用程式與磁碟區，設定祕密
3. 使用 fly deploy 部署
4. 透過 SSH 連入以建立設定，或使用控制介面

git clone https://github.com/openclaw/openclaw.gitcd openclaw # 選擇你自己的名稱fly apps create my-openclaw # 1GB 通常就足夠fly volumes create openclaw_data --size 1 --region iad

app = "my-openclaw"  # 你的應用程式名稱primary_region = "iad" [build]  dockerfile = "Dockerfile" [env]  NODE_ENV = "production"  OPENCLAW_PREFER_PNPM = "1"  OPENCLAW_STATE_DIR = "/data"  NODE_OPTIONS = "--max-old-space-size=1536" [processes]  app = "node dist/index.js gateway --allow-unconfigured --port 3000 --bind lan" [http_service]  internal_port = 3000  force_https = true  auto_stop_machines = false  auto_start_machines = true  min_machines_running = 1  processes = ["app"] [[vm]]  size = "shared-cpu-2x"  memory = "2048mb" [mounts]  source = "openclaw_data"  destination = "/data"

# 必要：非回送繫結所需的閘道驗證權杖fly secrets set OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32) # 模型供應商 API 金鑰fly secrets set ANTHROPIC_API_KEY=example-anthropic-key-not-real # 選用：其他供應商fly secrets set OPENAI_API_KEY=example-openai-key-not-realfly secrets set GOOGLE_API_KEY=... # 頻道權杖fly secrets set DISCORD_BOT_TOKEN=example-discord-bot-token

fly deploy

fly statusfly logs

fly ssh console

mkdir -p /datacat > /data/openclaw.json << 'EOF'{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-opus-4-6",        "fallbacks": ["anthropic/claude-sonnet-4-6", "openai/gpt-5.4"]      },      "maxConcurrent": 4    },    "list": [      {        "id": "main",        "default": true      }    ]  },  "auth": {    "profiles": {      "anthropic:default": { "mode": "token", "provider": "anthropic" },      "openai:default": { "mode": "token", "provider": "openai" }    }  },  "bindings": [    {      "agentId": "main",      "match": { "channel": "discord" }    }  ],  "channels": {    "discord": {      "enabled": true,      "groupPolicy": "allowlist",      "guilds": {        "YOUR_GUILD_ID": {          "channels": { "general": { "allow": true } },          "requireMention": false        }      }    }  },  "gateway": {    "mode": "local",    "bind": "auto",    "controlUi": {      "allowedOrigins": [        "https://my-openclaw.fly.dev",        "http://localhost:3000",        "http://127.0.0.1:3000"      ]    }  },  "meta": {}}EOF

exitfly machine restart <machine-id>

fly open

fly logs              # 即時記錄fly logs --no-tail    # 最近的記錄

fly ssh console

疑難排解

“應用程式未在預期的位址上監聽”

閘道繫結至 127.0.0.1，而非 0.0.0.0。

**修正：**在 fly.toml 的程序命令中加入 --bind lan。

健康檢查失敗／連線遭拒

Fly 無法透過設定的連接埠連線至閘道。

**修正：**確保 internal_port 與閘道連接埠（--port 3000 或 OPENCLAW_GATEWAY_PORT=3000）相符。

OOM／記憶體問題

容器持續重新啟動或遭到終止。跡象包括：SIGABRT、v8::internal::Runtime_AllocateInYoungGeneration，或無提示地重新啟動。

**修正：**增加 fly.toml 中的記憶體：

[[vm]]  memory = "2048mb"

或更新現有機器：

fly machine update <machine-id> --vm-memory 2048 -y

512MB 太小。1GB 可能可用，但在高負載或詳細記錄模式下可能發生 OOM。建議使用 2GB。

閘道鎖定問題

容器重新啟動後，閘道因「已在執行」錯誤而拒絕啟動。

執行階段鎖定檔位於 <tmpdir>/openclaw-<uid>/gateway.<hash>.lock 及 gateway.state.<hash>.lock（Linux： /tmp/openclaw-<uid>/gateway.*.lock），而非持久性的 /data 磁碟區，因此 完整重新啟動容器時，通常會連同容器檔案系統的其餘內容一起清除。 如果鎖定檔仍然存在（例如會保留容器檔案系統的 fly machine restart） 並阻止啟動，請手動移除：

fly ssh console --command "rm -f /tmp/openclaw-*/gateway.*.lock"fly machine restart <machine-id>

未讀取設定

--allow-unconfigured 只會略過啟動防護機制。它不會建立或修復 /data/openclaw.json，因此請確保實際設定存在，並包含 "gateway": { "mode": "local" }，以正常啟動本機閘道。

確認設定存在：

fly ssh console --command "cat /data/openclaw.json"

透過 SSH 寫入設定

fly ssh console -C 不支援 Shell 重新導向。若要寫入設定檔：

# echo + tee（從本機透過管線傳至遠端）echo '{"your":"config"}' | fly ssh console -C "tee /data/openclaw.json" # 或使用 sftpfly sftp shell> put /local/path/config.json /data/openclaw.json

若檔案已存在，fly sftp 可能會失敗；請先刪除：

fly ssh console --command "rm /data/openclaw.json"

狀態未持久保存

如果重新啟動後遺失驗證設定檔、頻道／供應商狀態或工作階段，表示狀態目錄正寫入容器檔案系統，而非磁碟區。

**修正：**確保已在 fly.toml 中設定 OPENCLAW_STATE_DIR=/data，然後重新部署。

更新

git pullfly deployfly statusfly logs

git pull + fly deploy 是此處受監督的流程：它會從 Dockerfile 重新建置映像檔，因此命令列介面／閘道版本、基礎作業系統映像檔及所有 Dockerfile 變更都會一併更新。在執行中容器內執行 openclaw update 並非相同操作，因為映像檔是以 Docker 建置的 dist/ 目錄樹形式提供，其中沒有 .git 簽出，也沒有供其偵測的 npm 管理全域安裝；在虛擬機器式安裝中使用此流程時，請參閱更新。

更新機器命令

若要在不完整重新部署的情況下變更啟動命令：

fly machines listfly machine update <machine-id> --command "node dist/index.js gateway --port 3000 --bind lan" -y # 或同時增加記憶體fly machine update <machine-id> --vm-memory 2048 --command "node dist/index.js gateway --port 3000 --bind lan" -y

之後執行 fly deploy 會將機器命令重設為 fly.toml 中的內容；重新部署後，請再次套用手動變更。

私人部署（強化）

Fly 預設會配置公開 IP，因此你的閘道可透過 https://your-app.fly.dev 存取，也能被網際網路掃描器（Shodan、Censys 等）發現。

使用 deploy/fly.private.toml 可進行無公開 IP 的強化部署：它省略了 [http_service]，因此不會配置公開輸入流量。

適合使用私人部署的情況

• 僅有對外呼叫／訊息（沒有傳入的網路鉤子）
• 由 ngrok 或 Tailscale 通道處理所有網路鉤子回呼
• 透過 SSH、Proxy 或 WireGuard 存取閘道，而非使用瀏覽器
• 部署應對網際網路掃描器隱藏

設定

fly deploy -c deploy/fly.private.toml

或轉換現有部署：

# 列出目前的 IPfly ips list -a my-openclaw # 釋放公用 IPfly ips release <public-ipv4> -a my-openclawfly ips release <public-ipv6> -a my-openclaw # 切換至私人設定，讓後續部署不會重新配置公用 IPfly deploy -c deploy/fly.private.toml # 配置僅限私人的 IPv6fly ips allocate-v6 --private -a my-openclaw

完成後，fly ips list 應只會顯示一個 private 類型的 IP：

版本     IP                   類型             區域v6       fdaa:x:x:x:x::x      私人             全球

存取私人部署

選項 1：本機 Proxy（最簡單）

fly proxy 3000:3000 -a my-openclaw# 在瀏覽器中開啟 http://localhost:3000

選項 2：WireGuard VPN

fly wireguard create# 匯入 WireGuard 用戶端，然後透過內部 IPv6 存取# 範例：http://[fdaa:x:x:x:x::x]:3000

選項 3：僅限 SSH

fly ssh console -a my-openclaw

私人部署的網路鉤子

若要接收網路鉤子回呼（Twilio、Telnyx 等）而不公開對外：

1. ngrok 通道：在容器內執行 ngrok，或將其作為 Sidecar 執行
2. Tailscale Funnel：透過 Tailscale 公開特定路徑
3. 僅限輸出：部分供應商（Twilio）可在沒有網路鉤子的情況下進行撥出通話

使用 ngrok 的語音通話設定範例，位於 plugins.entries.voice-call.config：

{  plugins: {    entries: {      "voice-call": {        enabled: true,        config: {          provider: "twilio",          tunnel: { provider: "ngrok" },          webhookSecurity: {            allowedHosts: ["example.ngrok.app"],          },        },      },    },  },}

ngrok 通道會在容器內執行，並提供公用網路鉤子 URL，而不會公開 Fly 應用程式本身。將 webhookSecurity.allowedHosts 設為通道主機名稱，以接受轉送的 Host 標頭。

安全性權衡

注意事項

• Fly.io 使用 x86 架構；Dockerfile 同時相容於 x86 和 ARM。
• 若要進行 WhatsApp/Telegram 初始設定，請使用 fly ssh console。
• 持久性資料位於 /data 的磁碟區中。
• Signal 需要在映像檔中安裝 signal-cli（以 Java 為基礎的命令列介面）；請使用自訂映像檔，並將記憶體維持在 2GB 以上。

費用

使用建議設定（shared-cpu-2x、2GB RAM）時，視使用情況而定，預估費用約為每月 $10-15；免費方案涵蓋部分基本額度。目前費率請參閱 Fly.io 定價。

後續步驟

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

相關內容

• 安裝概覽
• Hetzner
• Docker
• VPS 託管