# OpenClaw v2026.8.1 將 session 與 transcript 遷移至 SQLite，由 Gateway 統一管理

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 原作者：Peter Steinberger 🦞 (@steipete) · 策展與摘要：EasyVibeCoding · 平台：X (Twitter) · 熱度：🔥🔥 · 日期：2026-09-01

> 原始來源：https://x.com/steipete/status/2094290652649636173

## 證據與延伸閱讀

- [OpenClaw v2026.8.1 將 session 與 transcript 遷移至 SQLite，由 Gateway 統一管理。](https://docs.openclaw.ai/gateway/cloud-sessions) — 官方文件 · 最後核對：2026-09-01 · 支持主張：The release notes add a downgrade/backup warning for the SQLite migration, model verification and safer installation, readable tool/result diffs with a rolling approval history, and a remote-session model in which the Gateway owns credentials and reconciles workspace changes. Cloud Sessions docs add automatic host retry, desktop/CUA controls, idle suspension, warm images, and replacement workers.
- [OpenClaw 2.0 cloud sessions and control workflow — docs.openclaw.ai](https://docs.openclaw.ai/releases/2026.8.1) — 一手來源 · 最後核對：2026-09-01 · 支持主張：The release notes add a downgrade/backup warning for the SQLite migration, model verification and safer installation, readable tool/result diffs with a rolling approval history, and a remote-session model in which the Gateway owns credentials and reconciles workspace changes. Cloud Sessions docs add automatic host retry, desktop/CUA controls, idle suspension, warm images, and replacement workers.
- [Peter Steinberger 稱用 OpenClaw 建造 OpenClaw](https://x.com/steipete/status/2094290652649636173)

## 中文摘要

OpenClaw v2026.8.1 將 session 與 transcript 遷移至 SQLite，由 Gateway 統一管理。

這次更新已可使用，但 SQLite 遷移、錯誤 beta 版本與遠端工作機的資料邊界，都要求升級前先完成備份與人工核對。

**發布背景** OpenClaw Foundation 於 2026 年 8 月 31 日釋出 v2026.8.1，官方也稱為 OpenClaw 2.0。Peter Steinberger 在[原始貼文](https://x.com/steipete/status/2094290652649636173)表示，團隊兩個月前開始「用 OpenClaw 建造 OpenClaw」，逐步從本機 coding harness 轉向 team.openclaw.ai 的共享 Agent；他認為多人協作、cloud sessions 與節點帶來的「infinite compute」已改變團隊建置方式，甚至形容本機 harness 像是過時遺物。不過，文件並未證實「無限運算」是不限容量的保證，因此這仍屬宣傳性說法，不能直接視為產品承諾。

**版本與升級風險** v2026.8.1 涵蓋安裝、訊息、記憶、技能、模型、自動化、瀏覽器、原生應用程式、plugins 與安全性等多個部分；官方特別提醒，標成 `2026.9.1-beta.1` 的套件其實錯誤標版本，實際上是 `2026.8.1-beta.4`，不能解讀為比穩定版 `2026.8.1` 更新，穩定版使用者應安裝或更新至 `2026.8.1`。

這次發布也把 session 與 transcript 從檔案儲存遷移至 SQLite。升級前應先建立 verified backup，並閱讀官方的[版本降級與 SQLite 遷移說明](https://docs.openclaw.ai/releases/2026.8.1)；若要退回舊的檔案儲存版本，必須使用目前版本的 CLI 還原封存的舊 transcript。遷移後建立的 session 不會出現在較舊版本中，除非依照指定的還原流程處理，因此不能把降級視為無痛回復。

**安裝與首次設定** 新的 Mac、Linux 與 Windows 安裝流程提供從下載到首次有效對話的引導；iPhone、iPad 與 Android 則把配對及權限設定放在較容易找到的位置。引導式設定可以重用支援的訂閱、API keys 與 local models，並在儲存前驗證選定的 model，連線準備完成後再交給 Web 應用程式或終端機。

安裝器也補上數項降低初始設定風險的處理：

- 從 Downloads 或磁碟映像檔開啟的 Mac 應用程式，可提示移至 Applications，讓更新與登入時啟動正常運作。
- Linux 與其他 Unix 系統會讓 `openclaw` 在新的終端機工作階段中可用，不要求使用者手動編輯 shell 啟動檔。
- 可能在未驗證情況下暴露 OpenClaw 的網路安裝，會在變更發生前停止。
- 重新安裝若因準備階段取消或失敗，會保護現有可運作設定；初次啟動也會等待 Gateway 有足夠時間啟動後，再回報是否可連線。
- 文件列出的執行環境版本包含 Node 22.22.2。

**Cloud Sessions 模型** Cloud session 是「對話仍在同一個 session 中，但 coding 工作在另一台機器執行」。使用者在側邊欄看到的仍是同一段對話與 transcript；Gateway 保留對話、已整合的工作區（workspace）、模型憑證與 placement 紀錄，遠端機器則負責執行命令、編輯檔案與 tool 工作。工作完成後，變更會回整合至 managed worktree；即使遠端機器消失，session 和持久狀態仍會保留。

工作可放在三種目的地，且都使用相同的 session、chat 與 Place picker：

- **Gateway**：預設選項，在執行 `openclaw gateway` 的主機上處理日常 session。
- **Paired device**：透過 `openclaw connect` 配對的自有硬體，適合閒置 Mac、建置主機或既有伺服器，所需範圍為 `operator.write`。
- **Cloud worker**：透過 Crabbox 租用的一次性機器，適合突發運算、長時間工作，以及與本機隔離的執行，所需範圍為 `operator.admin`。

無論工作放在哪裡，model inference 都由 Gateway 代理，provider credentials 不會傳到遠端機器；OpenClaw 的 `worker-turn` 與 Codex 的 `remote-exec` 可以共用這些目的地。這種設計把「對話與憑證的所有權」和「命令與檔案的執行位置」分開，但 workspace reconciliation 與憑證邊界仍需由操作者自行確認。

**自有裝置與雲端工作機** 自有機器可以用一個命令配對，並登記為 session host：

```bash
openclaw connect <join-url> --service --session-host
```

配對裝置會與 Gateway 維持對外連線，預設每個 CPU core 提供一個 worker slot，也可透過 `nodeHost.workerRuns.capacity` 調整容量；每個 hosted session 也可選擇使用 Docker-compatible container，設定為 `nodeHost.workerRuns.isolation: "container"`。裝置短暫離線時，既有 placement 不會消失，session 會等待它重新連線。worker child 有 120 秒的 admission window；若在 turn 開始前逾時，Gateway 最多可嘗試五次，使用帶有 jitter 的指數退避，約涵蓋十多分鐘加上 backoff。已開始的工作不會依這項政策重播，憑證或建置拒絕則會被視為終止性錯誤。

Cloud worker 則由 `cloudWorkers.profiles` 設定檔啟動。內建 Crabbox plugin 會在 AWS、Hetzner 等 cloud backend 上按需建立機器，執行 setup command，將機器註冊為暫時 node，session 停止後再拆除。這些機器的定位是可拋棄式執行環境，不在其上長期保存 credentials；持久狀態仍由 Gateway 掌握。若雲端機器失效，下一則訊息會自動建立 replacement worker；自有配對裝置離線則不同，placement 會維持並等待原裝置回來。

**桌面與 Computer Use 控制** 啟用 cloud worker desktop 後，使用者可以從 session 開啟 Desktop，查看實際執行機器；cloud session 顯示其 worker desktop，配對裝置 session 則顯示該裝置。Cloud Worker Desktop lab 與 desktop profile setting 必須啟用，並在 Crabbox 設定 `settings.desktop: true`；若使用 coding profile，還要把 `computer` 加入 `tools.alsoAllow`。桌面檢視預設是 view-only，不會自行改變機器權限或 Agent 的 tool policy，明確的沙盒 allowlist 與 deny 規則仍然有效。

同一台機器會同時提供聊天介面的 Desktop panel 與 Agent 的 `computer` tool。使用者應在接手滑鼠鍵盤前先暫停 Agent，避免輸入衝突。worker transcript 會保留 screenshots；為了符合傳輸限制，OpenClaw 可把已處理的舊圖片在 model context 中替換成文字標記，但仍保留目前 computer frame 與尚未處理的圖片。Computer control 綁定於特定回合（turn）、placement、節點連線與 provider；若 worker 斷線，控制會關閉，重新連線後必須開始新的 turn，且停止或替換機器會使舊的 tool handles 失效。

**排程、重試與成本控制** 使用者不必每次手動挑選裝置。Place picker 的 `Auto` 選項，或 `autoDevice: true`，會依可用 worker slot 選擇較不忙的 paired session host；若在配置機器前失敗，最多重試三個排序後的 host。`worker-turn` 依可用 slot 數量排序，再以 device ID 打破平手；`remote-exec` 不消耗 worker slot，因此只依 device ID 排序。沒有合格 host 時，錯誤訊息會指出是沒有配對的 session host、全部離線，或全部已達容量上限。

Cloud worker 也新增閒置暫停與 warm image：

- `suspendAfter: "2h"` 會在 session 閒置兩小時後，先整合 workspace，再安全停止並釋放機器；暫停期間只支付保留 snapshot 的儲存成本，下一則訊息會自動建立 replacement worker。
- `settings.warmImage` 會先準備專案已 commit 的 checkout 與 node runtime，再擷取可重用的 image。相同專案與 profile 的後續 session 可由此 image 啟動；若 `setupEnv` 非空，只有明確選擇才會擷取，`settings.warmImage: false` 則維持 cold profile。
- warm image 保留乾淨的 committed seed，每個新 session 仍會重新 enrollment 並取得當下 workspace 檔案；相符 seed 可略過 origin 存取與完整 Git pack 傳輸，包含 private 或尚未發布的 commit。
- 有 active turn、佇列訊息或尚未整合結果時，不會執行 suspension；Gateway 會在下一輪檢查重新確認。

**資料保留與人工核對** Gateway 會持有 transcript、最近一次整合的 workspace 檔案、placement history 與所有 provider credentials。乾淨停止，包括自動暫停，都會先 reconciliation，因此雲端機器消失時主要的未同步風險，是自上次 reconciliation 後產生的 workspace 變更。對離線 paired device 而言，使用「Continue on Gateway…」是明確操作，可能遺失尚未同步的裝置檔案，不能與雲端 replacement worker 的行為混為一談。

附件會透過驗證過的傳輸通道複製到 worker workspace；目前附件若不可用或過大會直接回報錯誤，不會靜默丟棄，歷史來源若因 retention 到期而不存在，則會在 replay staging 時略過並提出警告。輸入暫存路徑位於 `media/inbound/openclaw-staged-<id>/`，一般 Git publication 不會包含這些檔案；若要將圖片或文件納入專案，必須先明確複製到一般專案路徑。附件傳輸沿用 25,000 個檔案、總計 256 MiB 與單檔 6 MiB 的限制，影像訊息相關 frame 另受 25 MiB 限制。

**可觀測性與審批流程** 另一個核心變化是 Control UI 將 Agent 工作過程整理成更容易檢查的活動介面。tool call 會與結果清楚配對，命令活動更易讀，檔案變更提供聚焦 diff；背景工作可在對話旁持續執行，並顯示經過時間與最近活動。完成 turn 後，中間 commentary 與 tools 會收進可重新展開的 `Worked for` 摘要，但即時活動、搜尋結果、只有附件的回覆與尚未解決的錯誤仍會保留。

審批請求會出現在觸發它的對話中，其他對話只顯示需要處理的提示；關閉 approval queue 不會意外核准或拒絕，請求會維持 pending。系統提供 rolling 30-day history，讓操作者回看近期決策。這套流程把遠端 Agent 的行為從「背景中自行執行」轉成可觀察、可暫停、可追溯的操作面，但權限設定、雲端 Session 政策、Desktop 控制與工作區同步 仍不應只依賴 UI 顯示，升級後應逐項驗證實際邊界。

## 標籤

功能更新, CLI, OpenClaw, OpenClaw 2.0, Peter Steinberger, OpenClaw Foundation, SQLite