格式化重建會把實例清回「剛裝好」的狀態。它解決的是那種設定改到自己都搞不清楚、想從頭來過的情況。
但這個操作無法復原，所以按下去之前值得先確認幾件事。
30 秒總覽
| 項目 | 狀態 |
|---|---|
| 對話記錄、Agent 設定、技能 | 清除 |
| 工作區檔案 | 清除 |
| Telegram／Discord 串接 | 清除 |
| 你的子網域 | 保留 |
| 訂閱方案與帳單 | 不受影響 |
| Gateway Token | 保留，驗證仍有效 |
| 能不能復原 | 不能 |
| 大約要多久 | 約 30 秒 |
會被清除的項目
| 項目 | 說明 |
|---|---|
| 工作區檔案 | workspace 目錄底下的所有檔案 |
| Agent 設定 | 模型選擇、API Key 等設定 |
| 對話記錄 | 所有歷史對話 |
| 已配對裝置 | Telegram／Discord Bot 連線 |
| 已安裝技能 | 所有安裝過的 Skills |
不受影響的項目
- 子網域——你的專屬網址不會改變，外部指向這個網址的設定不用調整
- 訂閱方案——帳單與計費完全不受影響，重建不等於重新訂閱
- Gateway Token——系統保留原有的 Token，自動驗證仍然有效
第三點是刻意的設計：如果 Token 也換掉，你所有外部串接都要重設一次，那會讓重建的成本高很多。
按下去之前先確認三件事
一、工作區裡有沒有你還要的東西
OpenClaw 產出的檔案都在工作區裡。整理過的資料、寫好的腳本、下載的內容，重建之後全部不見。先下載一份。
二、你的 API Key 還找得到嗎
重建後要重新填 API Key。如果那把 Key 只存在 OpenClaw 裡、你的密碼管理工具沒有備份，重建之後你得回供應商後台重新產生。
三、問題真的需要重建才能解決嗎
這是最該問的一題。實務上多數問題不需要重建——設定錯了可以改、技能裝壞了可以移除、模型接不上多半是 Key 的問題。
排查順序在常見問題裡。重建是最後手段，不是第一步。
備份：唯一能救你的東西
重建無法復原，所以「事前備份」不是建議，是唯一的保險。
該備份什麼
- 工作區檔案——整理過的資料、寫好的腳本、產出的內容
- API Key——存進密碼管理工具，不要只留在 OpenClaw 設定裡
- 技能清單——裝了哪些、順序如何，截圖就夠
- Prompt 或角色設定——調了很久的東西不要靠記憶
什麼時候備份
不是決定要重建的那一刻，是平常就該做。等到你想重建的時候，通常已經處在「東西壞掉、想快點解決」的心情，那個狀態下最容易漏東西。
比較實際的做法是：每次做完一段有價值的工作，順手把產出往外存一份。這比另外排一個備份時間表容易維持。
執行步驟
- 登入 RoamerHost 控制台
- 點「我的實例」，選擇要重建的實例
- 捲到頁面底部的「危險操作區」
- 點「格式化重建」
- 在彈出視窗輸入確認字串
- 等待完成，約 30 秒
需要手動輸入確認字串是刻意的——這個操作不該只隔著一個按鈕。
重建之後要做的事
完成後開啟 Dashboard 會看到初始設定畫面。要重新處理的有三項：
- 設定 AI 模型與 API Key——見 API Key 設定教學
- 重新串接通訊平台——見Telegram 與 Discord 設定教學
- 重新安裝技能——見 技能安裝與管理教學
建議照這個順序：先把模型接好、確認能對話，再處理串接與技能。一次全部設完的話，出問題時不知道是哪一項造成的。
怎麼減少下次重建的機會
設定改動一次一項
同時換模型、裝三個技能、調 Prompt，壞掉時你分不出是哪一個。這是最常見的「搞到自己都不知道改了什麼」的成因。
重要檔案不要只放在工作區
工作區是工作空間，不是儲存空間。有價值的產出定期往外存一份。
API Key 存在密碼管理工具裡
不要只存在 OpenClaw 的設定裡。這樣重建、換實例、換方案都不會卡住。
什麼情況該重建、什麼情況不該
這是整篇最重要的判斷。多數人按下重建的時候，其實有更省事的解法。
| 你的狀況 | 該不該重建 |
|---|---|
| 設定改到自己都不知道改了什麼 | 可以——這正是它的用途 |
| 裝了太多技能，行為變得奇怪 | 先試移除技能，通常就解決了 |
| 模型接不上、一直報錯 | 不用——先查 API Key 與額度 |
| 回應很慢 | 不用——那是模型的回應時間 |
| 想把實例交給別人用 | 可以——清掉舊資料比較乾淨 |
| 對話記錄太多想清掉 | 先看有沒有個別刪除的選項 |
原則是：先問「這個問題有沒有更小的解法」。重建能解決的問題，通常別的方法也能解決，而且不用重設一輪。
重建與換方案是兩回事
常見的混淆：以為升級方案需要先重建。
不需要。方案調整不會清空實例，你的設定、技能、對話都會留著。這兩件事是分開的操作，不要為了換方案而重建。
常見問題
Q：重建會不會影響我的訂閱？
不會。方案、帳單、計費週期都不受影響，子網域也保留。
Q：重建之後要重新付款嗎？
不用。這是把實例內容清空，不是取消再重辦。
Q：可以只清掉對話記錄，不動其他設定嗎？
格式化重建是整包清除。如果只是想清對話，先確認 Dashboard 裡有沒有個別刪除的選項——能用小手段解決就不要動大的。
Q：重建之後子網域會變嗎？
不會。這是刻意保留的，讓你外部的串接與書籤都不用改。
Q：多久會完成？
約 30 秒。如果明顯超過這個時間還停在處理中，聯絡客服比重複點按鈕有用。
延伸閱讀
- OpenClaw 安裝後設定教學：從零開始啟動你的 AI Agent
- API Key 設定教學：如何為 OpenClaw 配置 AI 模型
- OpenClaw 通訊平台串接：Telegram 與 Discord 設定教學
- OpenClaw 常見問題 FAQ
- RoamerHost OpenClaw 託管方案
想找人幫你做？
這些流程要是不想自己搭，或是規模大到需要有人一起規劃，浪花科技（RoamerHost 的母公司）承接企業流程自動化與 AI Agent 的委託開發：
OpenClaw
