Server Migration Center：SMC AI Agent版用戶端（公測）

功能特性

• AI 對話遷移：通過自然語言對話完成遷移源匯入、遷移任務建立、狀態查詢、故障排除。

• SMC API 操作：內建 SMC 遷移技能，調用 SMC API 管理遷移源與遷移任務。

• 定時任務：對指定遷移任務跟蹤監控遷移進度狀態。

• Web 控制台：提供 Dashboard，支援通過圖形化介面進行 AI 對話、會話管理、頻道配置、定時任務、模型配置、日誌查看。

• 命令列 TUI：提供命令列互動介面，直接與 AI 助手對話。

• 命令審批：基於工具命令白名單，對風險命令提供安全審批機制。

與傳統 SMC 用戶端區別

適用情境

• 伺服器遷移：完成本機伺服器或遠程伺服器的遷移上雲。

• 遷移進度監控：為指定遷移任務設定定時任務，監控遷進度。

• 遷移故障排除：諮詢遷移問題及故障排除。

步驟一：準備環境

1. 準備伺服器。

   • Linux：具備公網訪問能力，可訪問阿里雲 SMC 服務和所選大模型 API。x86_64 架構，核心 5.10 及以上，Python 3.9 及以上。推薦 Alibaba Cloud Linux 3、Ubuntu 22.04、Rocky Linux 9 或更高版本。

   • Windows：具備公網訪問能力，可訪問阿里雲 SMC 服務和所選大模型 API。x86_64 架構，Windows Server 2012 R2 及以上。推薦 Windows Server 2016、Windows 10 或更高版本。

2. 阿里雲帳號：已開通Server Migration Center 服務。SMC 服務本身免費，但遷移過程中使用的中轉執行個體、雲端硬碟和網路流量等雲資源可能產生費用。

3. 大模型 API Key：準備一個大模型API Key，推薦使用阿里雲（千問雲）Token Plan 方案 或 Coding Plan 方案。

步驟二：下載並安裝

步驟三：用戶端基本配置

1. 配置大模型。

   Setup命令一鍵配置（推薦）

   以阿里雲（千問雲）國際站 Coding Plan，使用qwen/qwen3.7-plus為例，更多方案及模型請參考更多模型配置。

   任選一種方案配置即可，避免在同一次 setup 中傳入多個模型 Key。

   參數	說明
   <AccessToken ID>	SMC 啟用碼的 AccessToken ID。 擷取方式參見擷取啟用碼。
   <AccessToken Code>	SMC 啟用碼的 AccessToken Code。 擷取方式參見擷取啟用碼。
   <API_KEY>	阿里雲（千問雲）國際站的API KEY擷取方式First API call。
   --model	指定具體模型，模型格式為 provider/model，例如 --model "qwen/qwen3.7-plus"。

   smcclaw setup --modelstudio-api-key "<API_KEY>" --model "qwen/qwen3.7-plus" --accesstokenid "<AccessToken ID>" --accesstokencode "<AccessToken Code>"

   重要

   啟用碼屬于敏感憑證。直接在命令中輸入可能被 Shell 記錄儲存，請按實際安全要求管理認證。

   Onboard 介面互動配置

   以阿里雲（千問雲）國際站 Coding Plan，使用qwen/qwen3.7-plus為例。

   1. 進入介面互動配置。

      <AccessToken ID>及<AccessToken Code>可通過擷取啟用碼擷取。

      smcclaw onboard --accesstokenid "<AccessToken ID>" --accesstokencode "<AccessToken Code>"

      重要

      啟用碼屬于敏感憑證。直接在命令中輸入可能被 Shell 記錄儲存，請按實際安全要求管理認證。

   2. 依照以下參數配置。

      • Setup mode：OneClick

      • Model/auth provider：Qwen Cloud（若無，則選擇More）

      • Qwen Cloud auth method：Coding Plan API Key for Global/Intl

      • Enter Alibaba Cloud Model Studio Token Plan API key (China)：輸入Coding Plan API key。

      • Default model：選擇模型，如qwen/qwen3.7-plus。

2. 執行smcclaw gateway status，running表示 Gateway 服務已啟動。

步驟四：開啟對話

Gateway 預設監聽 127.0.0.1:18789，提供三種對話入口。

smcclaw tui

首次遷移伺服器

支援三種伺服器環境遷移情境：

• 本機隨即轉移：隨即轉移 SMCClaw 所在伺服器。

• 遠程 SSH 遷移：通過 SSH 串連遠程伺服器進行遷移。

• 遠程輔助遷移：提供手動匯入指令碼命令，需您輔助執行後進行遷移。

參考指令樣本：

幫我遷移本機到阿里雲北京地區。
需要遷移另一台雲主機，可以通過 SSH 串連。
有一台線下 Windows 需要遷移，沒遠端連線方式。

遷移互動流程：

1. 識別遷移意圖：AI 解析對話意圖，確認遷移目標。

   遷移源註冊、遷移演練和資料同步會佔用 CPU、磁碟和網路資源；縮盤遷移需根據檔案系統、分區布局、實際資料量和遷移演練結果綜合判斷。生產環境請在業務低峰期執行並提前完成備份。

2. 配置啟用碼：首次執行遷移時，若本機未儲存 SMC 啟用碼，用戶端會詢問 AccessToken ID 和 AccessToken Code，可擷取啟用碼後通過對話提供。

3. 註冊/匯入遷移源：AI 完成源端資訊採集後匯入遷移源，成功後給出遷移源基礎資訊。

4. 遷移分析與費用估算：AI 根據源端資訊和雲資源價格進行遷移分析與費用估算並展示。

   估算結果僅供參考，實際費用以阿里雲賬單為準。

5. 建立/啟動遷移任務：確認費用後，AI將建立並啟動遷移任務，同時設定遷移進度自動監控的定時任務。任務預設開啟遷移演練，先做一次遷移可行性測試並輸出演練報告，演練通過後自動進入正式遷移。

6. 遷移進度監控：遷移過程中，自動監控定時任務定期在當前會話發起進度查詢並給出報告。

7. 遷移完成：遷移任務完成後，AI 會自動取消進度監控定時任務，給出遷移總結報告，等待下一步指令。

定時任務

遷移開始時預設建立指定遷移任務的自動監控定時任務。也可通過對話建立自訂定時任務：

今晚 22:00 開始遷移任務 j-bp1xxx，完成後通知我。
每天 9:00 檢查所有遷移源狀態，異常時警示。

建立的定時任務可在 Dashboard 控制台查看。

常用管理命令

#列出所有定時任務
smcclaw cron list

#查看某個任務的詳細資料
smcclaw cron get <jobId>

#立即手動執行一次某個任務
smcclaw cron run <jobId>

#查看某個任務的執行記錄
smcclaw cron runs --id <jobId>

#啟用某個被禁用的任務
smcclaw cron enable <jobId>

#禁用某個任務（暫停，不刪除）
smcclaw cron disable <jobId>

#永久刪除某個任務
smcclaw cron remove <jobId>

常用 Cron 運算式

安全性原則

• Gateway 綁定：Gateway 預設僅綁定本地迴環地址；遠端存取優先使用 SSH 隧道。

• 網關令牌：Gateway Token 及包含 Token 的 Dashboard URL 屬于敏感憑證，不要分享或記錄在未脫敏截圖中。

• 啟用碼：SMC 啟用碼屬于敏感憑證，僅在本機 TUI 或私人 Dashboard 會話中提供；文檔、截圖和日誌定期清理。

• 命令來源：不向 AI 提交來源不明的命令；破壞性操作執行前核對完整命令和目標路徑。

• 安全執行策略：預設開啟 allowlist + on-miss，白名單外命令必須審批，建議保持開啟。

可通過以下指令查看安全配置：

smcclaw config get tools.exec

啟停服務

#開啟服務
smcclaw gateway start

#停止服務
smcclaw gateway stop

#重啟服務
smcclaw gateway restart

#查看服務狀態
smcclaw gateway status

卸載用戶端

• Linux：分別執行以下指令卸載用戶端。

  #先移除 Gateway 服務
  smcclaw gateway uninstall
  
  #再刪除程式檔案
  bash /opt/smcclaw/install.sh --uninstall

  重要

  若安裝時使用了自訂目錄，卸載時必須指定相同的 --prefix 目錄，否則無法正確清理。如bash /usr/local/smcclaw/install.sh --prefix /usr/local/smcclaw --uninstall

• Windows：執行smcclaw gateway uninstall卸載 Gateway 服務後，刪除解壓的 SMCClaw 目錄即可。

配置與資料清理

執行以下指令備份並刪除配置或工作目錄：

smcclaw backup create
smcclaw uninstall --dry-run
smcclaw uninstall

smcclaw uninstall 會移除 Gateway 服務和所選本機資料，不刪除 CLI 程式檔案。刪除 CLI 程式檔案需執行卸載用戶端操作。

狀態查詢與診斷

#查看smcclaw運行狀態及配置資訊
smcclaw status

#診斷自檢，可排查運行環境是否正常
smcclaw doctor

#查看SMCClaw作業記錄
smcclaw logs --follow

#查看SMCClaw 當前使用的 AI 模型配置狀態
smcclaw models status

#查看SMCClaw 訊息通道串連狀態
smcclaw channels status

如何擷取啟用碼？

1. 訪問SMC控制台-伺服器遷移。

2. 在服務器遷移頁面，單擊導入遷移源。

3. 在導入遷移源頁面，選擇客戶端導入。

4. 在SMC控制台的導入說明中，選擇作業系統類型後，單擊生成啟動碼。

5. 複製產生的Access Token ID及Access Token Code。

Linux如何自訂用戶端安裝目錄？

bash ./smcclaw-<version>-linux-x64/install.sh --prefix /usr/local/smcclaw

更多模型配置

推薦：阿里雲（千問雲/Qwen Cloud）

Qwen Provider 已內建，首次配置不會提示從 npm 下載外掛程式。從曾自動下載 Qwen 外掛程式的舊版本升級後，可先運行 smcclaw doctor --fix 清理舊外掛程式安裝記錄。根據方案和網站選擇任一命令：

其他主流模型

配置後檢查：

smcclaw models status
smcclaw doctor

如何查看模型使用方式？

開啟 Dashboard 使用方式頁面 http://127.0.0.1:18789/usage，查看模型 API Token 使用量和成本。

Dashboard 顯示無法串連怎麼辦？

顯示“瀏覽器無法完成Gateway串連。重試憑據前請檢查目標和傳輸方式”，需要檢查網關令牌是否有誤。

AI 回答失敗，提示 Agent failed before reply怎麼辦？

需要核實模型配置是否正確，是否使用了錯誤的模型 API Key 或 provider/model 名稱。

Gateway 串連失敗怎麼辦？

1. 確認服務狀態。

   smcclaw gateway status

   查看 Gateway 是否正在運行。

2. 檢查監聽連接埠。

   Gateway 預設監聽 18789 連接埠。需檢查連接埠是否被佔用、是否被防火牆攔截，或 Gateway 未在該連接埠監聽。

3. 執行環境自檢。

   smcclaw doctor

   全面檢測環境配置，查看是否存在異常。

4. 查看作業記錄，排查串連失敗原因。

   smcclaw logs --follow

模型調用失敗怎麼辦？

1. 檢查模型狀態是否正常。

   smcclaw models status

2. 執行環境自檢。

   smcclaw doctor

3. 查看作業記錄。

   smcclaw logs --follow

4. 核驗API Key。

   檢查 AccessKey 是否有效,是否已到期或被禁用。

定時任務未執行怎麼排查原因？

1. 查看任務清單。

   smcclaw cron list

   確認任務是否建立成功，是否啟用，以及時間配置是否正確。

2. 查看單個任務詳情。

   smcclaw cron get <jobId>

   用任務 ID 查看詳細資料：調度規則、上次執行時間、下次計劃執行時間、任務配置是否正確。

3. 確認 Gateway 狀態。

   smcclaw gateway status

   定時任務由 Gateway 調度。Gateway 未運行或異常時，所有定時任務均不觸發。

4. 核對伺服器時區。

   任務執行時間依賴伺服器時區。時區與預期不一致時，任務會在錯誤時間執行，表現為“未執行”。

5. 查看執行歷史。

   smcclaw cron runs --id <jobId>

Windows如何將smcclaw加入系統PATH？

將 smcclaw 可執行檔路徑添加至 PATH 環境變數，可實現命令列全域調用。

以Windows 2022為例。

1. 按右鍵表徵圖，選擇系統。

2. 在左側導覽列搜尋並開啟查看進階系統設定。

3. 在系統屬性的進階頁簽中，單擊環境變數。

4. 在系統變數地區尋找Path變數。選中後，單擊編輯，進入編輯環境變數頁面後，再單擊建立，添加C:\smcclaw\smcclaw-<version>-win32-x64\bin。

   將 <version> 替換為具體版本號碼，如 2026.9.5。

5. 測試環境變數是否配置成功。

   1. 按右鍵表徵圖，選擇運行，輸入PowerShell，新開PowerShell介面。

   2. 在介面中，執行smcclaw --version，若輸出工具版本資訊，則表示環境變數配置成功。