進階操作

本章節介紹 Admin Panel 的進階功能，包括容器更新、備份還原、個人化設定等。

容器更新流程

定期更新容器可確保你擁有最新功能與安全修復。

更新檢查

每個 Tab 會顯示目前使用的映像版本，以及是否有新版本可用：

狀態	說明
🟢 Up to date	已是最新版本
🟡 Update available	有新版本可用
🔴 Update required	建議立即更新（可能包含重要修復）

更新步驟

1. 備份資料

   • 在更新前，建議先執行「Export Data」備份重要資料

2. 選擇容器

   • 進入要更新的容器 Tab
   • 點擊「Update」按鈕

3. 確認更新

   • 系統會顯示更新內容摘要
   • 確認後開始更新

4. 等待完成

   • 容器會短暫停止並重新啟動
   • 通常需要 30-60 秒
   • 完成後會顯示「Update completed」

更新注意事項

⚠️ 重要提醒：

• 更新過程中該容器會暫時無法使用
• 進行中的對話會被中斷
• 建議在離峰時段執行
• 若更新失敗，系統會自動回滾

大量更新

若需要同時更新多個容器：

1. 優先更新 Rose（管理核心）
2. 等待 Rose 完全啟動
3. 再更新 Ada 和 Vi
4. 每次更新間隔至少 30 秒

備份與還原完整指南

定期備份是保護資料的最佳實踐。

備份內容

「Export Data」功能可匯出以下資料：

類型	內容
對話記錄	與 AI 夥伴的歷史對話
角色設定	自定義的角色提示詞與參數
技能配置	啟用的技能與其設定
模型設定	偏好的模型與溫度參數
用戶資料	帳號設定與偏好

手動備份步驟

1. 進入 MAIN Tab
2. 點擊「Export Data」
3. 選擇要備份的項目
4. 點擊「Export」
5. 下載產生的檔案
6. 將檔案儲存在安全位置

自動備份建議

除了手動備份，建議設定自動化備份：

# 在 Host Terminal 中設定 cron 定期備份
# 這會每天凌晨 2 點執行備份
0 2 * * * /usr/local/bin/backup-openclaw.sh

還原資料

若需要還原備份：

1. 進入對應的容器 Terminal
2. 將備份檔案上傳至容器
3. 執行還原命令
4. 重新啟動相關服務

💡 提示：還原前請先備份當前狀態，以防萬一。

備份檔案管理

建議的檔案命名格式：

openclaw-backup-YYYYMMDD-HHMMSS.tar.gz

保留策略：

• 每日備份：保留最近 7 天
• 每週備份：保留最近 4 週
• 每月備份：保留最近 12 個月

暱稱與標籤管理

為容器設定暱稱與標籤，讓管理更直觀。

設定容器暱稱

預設的容器名稱（oc-1、oc-2、oc-3）可能不夠直觀，你可以設定暱稱：

1. 進入對應的容器 Tab
2. 點擊設定圖示（⚙️）
3. 在「Nickname」欄位輸入暱稱
4. 儲存設定

暱稱建議

容器	預設名稱	建議暱稱
oc-1	Rose	系統管理員、全能夥伴
oc-2	Ada	專案經理、客服專員
oc-3	Vi	測試環境、備援夥伴

使用標籤分類

標籤可以幫助你快速識別容器用途：

標籤範例：
- 🏷️ production  （正式環境）
- 🏷️ staging     （測試環境）
- 🏷️ development （開發環境）
- 🏷️ backup      （備援用途）
- 🏷️ client-a    （特定客戶）

設定標籤

1. 在容器設定中找到「Tags」
2. 輸入標籤名稱，按 Enter 新增
3. 點擊標籤旁邊的 ❌ 可移除
4. 儲存設定

深色/淺色主題切換

Admin Panel 支援深色與淺色主題，保護你的眼睛。

切換方式

方法一：快速切換

1. 點擊頁面右上角的「🌙/☀️」圖示
2. 主題會立即切換

方法二：設定頁面

1. 進入「Settings」頁面
2. 找到「Appearance」區塊
3. 選擇「Dark」、「Light」或「System」

主題選項

選項	說明
Dark	深色背景，適合低光環境
Light	淺色背景，適合明亮環境
System	跟隨作業系統設定自動切換

推薦使用情境

• 深色模式：夜間操作、長時間使用、減少眼睛疲勞
• 淺色模式：日間使用、簡報展示、列印頁面

其他進階設定

時區設定

確保所有時間戳記顯示正確：

1. 進入「Settings」
2. 找到「Timezone」
3. 選擇你的時區（例如 Asia/Taipei）
4. 儲存設定

語言設定

切換介面語言：

1. 點擊頂部的語言選擇器
2. 選擇「繁體中文」或「English」
3. 頁面會自動重新載入

通知設定

設定系統通知：

通知類型	說明
更新提醒	有新版本時通知
資源警示	CPU/記憶體使用率過高時提醒
錯誤通知	容器異常時發送通知

存取日誌

查看 Admin Panel 的操作記錄：

1. 進入「Logs」頁面
2. 選擇時間範圍
3. 篩選特定類型的記錄
4. 可匯出為 CSV 格式

疑難排解

常見問題

Q: 更新後容器無法啟動？ A: 嘗試以下步驟：

1. 在 MAIN Tab 查看錯誤日誌
2. 檢查磁碟空間是否足夠
3. 手動重啟容器
4. 聯繫技術支援

Q: 備份檔案太大？ A: 可以：

• 選擇性備份（只選需要的項目）
• 清理舊的對話記錄
• 壓縮大型附件

Q: 主題切換無效？ A: 嘗試：

1. 清除瀏覽器快取
2. 重新整理頁面
3. 檢查瀏覽器是否支援

頁面導航

• ← Vi Tab
• Admin Panel 總覽 →

0 2 * * * /usr/local/bin/backup-openclaw.sh

#!/bin/bash
# OpenClaw 自動備份腳本

BACKUP_DIR="/backup/openclaw"
DATE=$(date +%Y%m%d-%H%M%S)
FILENAME="openclaw-backup-$DATE.tar.gz"

# 建立備份目錄
mkdir -p $BACKUP_DIR

# 執行備份
docker exec oc-1 openclaw export > $BACKUP_DIR/export-$DATE.json

# 壓縮備份檔
tar -czf $BACKUP_DIR/$FILENAME $BACKUP_DIR/export-$DATE.json

# 清理 30 天前的備份
find $BACKUP_DIR -name "openclaw-backup-*.tar.gz" -mtime +30 -delete

echo "備份完成: $FILENAME"

openclaw-backup-YYYYMMDD-HHMMSS.tar.gz

範例：
openclaw-backup-20260321-143022.tar.gz