Simple Application Server：OpenClaw 常見問題

已購買的Simple Application Server，如何部署OpenClaw鏡像？

1. 登入Simple Application Server控制台，選擇對應執行個體單擊重置系統。

2. 選擇重設為其他鏡像，選擇版本OpenClaw 2026.5.19。

3. 重新設定OpenClaw。重設後之前配置的API Key和Token都會失效，需要到應用詳情裡重新設定API Key。

如何重設當前應用鏡像至最新版本？

若當前鏡像不是OpenClaw 2026.5.19版本，希望體驗最新OpenClaw能力，可重設系統來更新鏡像。

1. 登入Simple Application Server控制台，選擇對應執行個體單擊重置系統。

2. 選擇重設為其他鏡像，選擇版本OpenClaw 2026.5.19。

3. 重新設定OpenClaw。重設後之前配置的API Key和Token都會失效，需要到應用詳情裡重新設定API Key。

如何查看OpenClaw的鏡像版本？

有兩種方式可以查看當前OpenClaw的鏡像版本：

• 通過控制台查看：登入Simple Application Server控制台，進入對應OpenClaw執行個體的詳情頁，依次查看基本資訊 > 鏡像，即可看到當前執行個體的鏡像版本。

• 通過終端命令查看：在Simple Application Server控制台，單擊遠端連線 > 立即登入進入終端介面，然後執行以下命令查看版本：

  openclaw --version

以上兩種方式返回的版本號碼含義不同：

• 控制台鏡像版本：顯示的是建立執行個體時選擇的鏡像版本號碼，即安裝時的初始鏡像版本。

• openclaw --version 返回的版本：顯示的是當前啟動並執行 OpenClaw 程式版本號碼，會隨程式更新而變化。

兩者來源不同，因此可能出現版本號碼不一致的情況，屬於正常現象。

重設系統時報錯如何處理？

如果在重設系統時遇到報錯，請先確認Simple Application Server是否已關機。重設系統操作需要在伺服器處於已停止狀態下執行。

1. 登入Simple Application Server控制台，在伺服器列表中單擊對應執行個體。

2. 在執行個體詳情頁右上方單擊關機，等待伺服器狀態變為已停止。

3. 伺服器關機後，再執行重置系統操作。

OpenClaw擷取連接埠放通命令執行失敗如何處理？

在Simple Application Server控制台對OpenClaw應用執行一鍵放通防火牆時，彈窗提示“擷取連接埠放通命令執行失敗”，“您的防火牆將為來源為0.0.0.0/0的IP開啟 Port 未設定 連接埠，請妥善評估安全風險後點擊確認。”

• 原因：設定檔中的OpenClaw連接埠丟失，導致系統無法正確擷取連接埠放通命令。

• 影響範圍：僅OpenClaw 2026.3.28之前的版本會出現此問題，2026.3.28及以上版本已修複。

• 解決方案：重設當前應用鏡像至最新版本。

OpenClaw報錯“API rate limit reached”怎麼辦？

請按以下順序排查：

1. OpenClaw 配置錯誤。

   若 Base URL 或模型供應商配置有誤，導致請求未進入 Coding Plan 專屬通道，而是被路由到了通用的API 呼叫，從而觸發限流。

   • 若使用 Coding Plan 套餐，請核對OpenClaw設定檔中的 models、agents、gateway（含嵌套欄位），確保與文檔配置一致。例如：模型服務提供者的結構為{ "models": { "providers": { "bailian": {...} } } } 。

   • 若當前未使用 Coding Plan 套餐，建議切換至 Coding Plan 以擷取專屬額度。

2. 超出套餐限額：在Coding Plan頁面查看套餐用量情況。

3. 嘗試重設 API Key：若完成上述排查後問題仍未解決，請前往Coding Plan頁面重設 API Key。

通用限流排查（適用於所有模型供應商）

如果調用模型時報錯 API rate limit reached，還可能是以下原因：

• 調用頻率過快：短時間內觸發了模型供應商的限流策略。請降低調用頻率，等待一段時間後重試。

• 並發請求過多：檢查是否在短時間內並發發送了大量請求。建議檢查應用配置中的 maxConcurrent 參數，適當降低並發限制。

• 免費額度耗盡：如果使用免費額度，確認是否因額度耗盡導致服務受限。部分廠商在額度耗盡後會返回 403 或限流錯誤，而非正常的計費計費。

OpenClaw 是否支援接入第三方模型？

支援。根據 OpenClaw 鏡像版本不同，配置方式分為以下兩種，請切換頁簽查看對應的供應商列表與接入入口。

如果您僅使用阿里雲百鍊模型，無需配置第三方模型。控制台應用詳情頁面的模型配置地區僅展示阿里雲百鍊相關選項（如阿里雲百鍊 Coding Plan和阿里雲百鍊），這是正常現象，無需額外操作。第三方模型的接入有獨立的配置路徑，不通過該下拉式功能表添加。

配置第三方模型後 WebUI 不顯示、無法切換或自動回退預設模型怎麼辦？

配置了 DeepSeek/MiniMax 等第三方模型後，如果在 WebUI 下拉式功能表中看不到新模型，或切換後仍調用預設模型（如 Qwen），請按以下步驟排查：

• 檢查配置完整性：確認不僅在 models.providers 中添加了模型，還必須在 agents.defaults.models 中添加該模型的引用（格式為 provider-id/model-id），並在 agents.defaults.model.primary 中指定預設模型。僅配置 models.providers 而不添加引用，WebUI 將無法識別新模型。

• 重啟服務使配置生效：修改設定檔後，必須執行以下命令使配置生效：

  openclaw gateway restart

• 控制台限制說明：Simple Application Server控制台的"應用詳情"頁面僅支援展示和修改阿里雲百鍊模型，不支援第三方模型的回顯或修改。第三方模型配置以伺服器內 ~/.openclaw/openclaw.json 檔案為準，控制台顯示百鍊屬於正常現象。

• 切換模型的方法：

  • 在 WebUI 對話中發送命令 /model provider-id/model-id 進行切換。

  • 在終端執行 openclaw models set provider-id/model-id。

  • 查看可用模型列表，執行 openclaw models list。

  可切換的模型範圍由設定檔 ~/.openclaw/openclaw.json 中 agents.defaults.models 列表決定。只有在該列表中聲明的模型才能通過上述命令切換。如需增加可切換模型，先在 models.providers 中添加模型配置，再在 agents.defaults.models 中添加對應引用。

  切換模型前建議先建立執行個體快照或備份設定檔（cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak），以防配置修改出錯時可快速恢複。

• 備選策略排查：如果配置正確但仍調用其他模型，請檢查 OpenClaw 日誌，確認是否因限流或報錯觸發了系統的備選模型切換機制。

在控制台切換模型後，對話中仍顯示舊模型怎麼辦？

在控制台將模型從一個切換為另一個後（例如從 QWEN PLUS 切換為 MAX），配置已更新但對話中仍顯示舊模型，這是因為模型切換需要重啟網關服務並重新整理頁面才會生效。

操作步驟

1. 確認設定檔 ~/.openclaw/openclaw.json 中 agents.defaults.model.primary 欄位已更新為目標模型。該欄位決定實際使用的模型。

2. 執行以下命令重啟網關，使新配置生效：

   openclaw gateway restart

3. 重新整理瀏覽器頁面或重建存取 URL，確認對話中已使用新模型。

切換模型後飛書不回複訊息怎麼辦？

切換大模型後，飛書通道配置會失效，導致飛書機器人不回複訊息。請前往Simple Application Server控制台的應用詳情頁面，重新設定飛書通道的 App ID 和 App Secret 即可恢複。

操作步驟

1. 登入Simple Application Server控制台，在伺服器列表中單擊對應執行個體。

2. 進入應用詳情頁面，找到飛書通道配置。

3. 重新填寫飛書 App ID 和 App Secret，儲存後飛書機器人即可恢複正常。

更換大模型後對話記憶消失是否正常？

更換大模型後對話記憶消失是正常現象。OpenClaw 的對話記憶依賴於當前模型的上下文處理機制，不同模型之間的上下文不互連，切換模型時系統會清空之前的對話緩衝以確保相容性和穩定性。建議在更換模型前手動記錄關鍵資訊。

調用模型時報錯 HTTP 401 (Incorrect API key / Invalid access token) 怎麼辦？

HTTP 401 錯誤通常由 API Key 不正確或 Base URL 與 Key 不匹配導致。請按以下情境排查：

情境一：阿里雲百鍊通用模型（隨用隨付）

• API Key 格式：確認 API Key 格式通常為 sk- 開頭。

• 地區匹配：API Key 需與 Base URL 地區匹配（如北京地區 Key 對應北京地區 URL）。

• Base URL：通常為 https://dashscope.aliyuncs.com/compatible-mode/v1。

• 注意：Coding Plan 的 Key 與隨用隨付 Key 不通用，請勿混用。

情境二：阿里雲百鍊 Token Plan

• API Key 格式：確認 API Key 格式通常為 sk-sp- 開頭的長字串。

• Base URL：必須使用 https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。

• 注意：Token Plan 不支援在控制台一鍵配置，必須手動修改設定檔。

情境三：第三方模型（MiniMax/DeepSeek/騰訊雲等）

• 確認使用的是該第三方平台提供的 API Key，而非阿里雲百鍊 Key。

• 檢查 Key 是否包含多餘空格或分行符號。

• 確認 Base URL 是否正確（例如 DeepSeek 為 https://api.deepseek.com/v1）。

• 部分模型（如 MiniMax）可能需要選擇特定的 Auth Method（如 MiniMax CN 或 MiniMax Global）。

通用排查步驟

• 在第三方控制台重建 API Key 並替換。

• 檢查設定檔 ~/.openclaw/openclaw.json 中 apiKey 欄位值是否正確寫入。

• 重啟服務 openclaw gateway restart。

OpenClaw 是否支援調用本地部署的大模型？

目前雲端部署的 OpenClaw（如Simple Application Server鏡像）不支援直接調用使用者本地區域網路或本機部署的大模型。OpenClaw 需要訪問公網可達的 API Endpoint。

如果需要使用本地模型，需滿足以下條件：

• 確保本地模型服務已映射到公網並可被雲端服務器訪問。

• 按照「通用第三方模型接入指南」中的方式，將公網 Base URL 配置到 ~/.openclaw/openclaw.json 的 models.providers 中。

更換 OpenClaw 模型供應商是否影響其他應用？

更換 OpenClaw 底層模型供應商僅影響 OpenClaw 應用本身，通常不會影響伺服器上部署的其他應用（如 Hermes 等）。

如果配置錯誤導致異常，可通過在Simple Application Server控制台建立的執行個體快照復原恢複。建議在每次修改配置前建立快照或備份設定檔（cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak）。

OpenClaw 是否支援同時串連多個大模型？

支援。OpenClaw 支援同時串連多個不同廠家的大模型。在Simple Application Server控制台，進入對應 OpenClaw 執行個體的應用詳情頁面，模型配置區塊提供了兩種模式：

• 阿里雲百鍊 Coding Plan：支援阿里雲自研的 Qwen 系列以及 MiniMax、GLM、Kimi 等第三方廠家模型。

• 阿里雲百鍊：支援 Qwen 系列模型，包括 qwen3-vl-plus、qwen3-vl-flash 等視覺模型。

從供應商下拉框中選擇模型供應商，在模型下拉框中選擇具體模型，單擊應用即可完成配置。第三方模型已通過百鍊平台整合，無需手動輸入 Base URL 或 API Key。

如何查看OpenClaw的連接埠號碼？

為了防止惡意掃描與定向攻擊，OpenClaw 在初始化時會自動產生一個隨機連接埠。在應用詳情 > 基礎配置 > 查看連接埠中單擊檢視查看OpenClaw的連接埠號碼。

部署在Simple Application Server上的OpenClaw，能否授權控制本地電腦的應用？

不支援。由於Simple Application Server運行在雲端網路環境，與本地電腦網路相互隔離，因此無法直接跨網路控制本地案頭的應用程式。

為什麼OpenClaw應用鏡像更新至最新版本仍無法使用連網搜尋功能？

請前往Simple Application Server控制台，在鏡像資訊模組查看並確保已更新至OpenClaw 2026.2.3及以上版本應用鏡像，若不是該版本需要參考如何重設當前應用鏡像至最新版本？進行更新。該版本應用鏡像在所有地區均預設提供基於內建SearXNG連網搜尋Skill的連網搜尋能力，無需額外配置，不收取額外費用，可直接告訴OpenClaw使用SearXNG的Skill進行連網搜尋。若伺服器部署在中國香港或海外地區時，可參考OpenClaw如何配置Brave Search連網搜尋功能配置Brave Search API以實現連網搜尋。

如何更改OpenClaw調用的模型？

OpenClaw 支援在控制台切換不同的模型，操作路徑因鏡像版本而異：

• OpenClaw 2026.5.19 及以上版本：進入應用詳情頁，在模型 (Models)卡片下找到已配置的模型，單擊切換模型選擇其他模型；或單擊添加模型接入新的模型廠商。該版本支援阿里雲百鍊 Coding Plan、阿里雲百鍊 Token Plan、阿里雲百鍊、deepseek、Kimi、GLM Coding Plan、智譜等多家廠商。

• OpenClaw 2026.5.19 之前版本：在應用詳情 > 模型配置 > 模型配置中刪除預設的模型，然後下拉選擇不同的百鍊模型。

鏡像是否預裝了常用 Skills？

OpenClaw 2026.2.3 及以上版本應用鏡像預設僅內建 SearXNG 連網搜尋 Skill，不預裝其他常用 Skills。如需使用其他 Skills，可通過以下三種方式手動安裝：

• 對話安裝：直接在對話中告訴 OpenClaw 安裝所需的 Skill，系統自動完成安裝。

• URL 安裝：將 Skill 的 URL 地址發送給 OpenClaw，系統自動完成安裝。

• ClawHub 安裝：通過 clawhub install <skill-name> 命令從技能市場安裝。

各安裝方式的詳細操作步驟，請參見如何在OpenClaw中安裝或添加Skills。

如何在OpenClaw中安裝或添加Skills？

OpenClaw 支援通過對話互動、連結安裝以及轉存安裝三種方式來添加 Skill，具體操作如下：

• 互動式建立（適用於建立 Skill）。

  OpenClaw 內建了 Skill Creator 組件。可直接與 Skill Creator 進行對話聊天，描述需求，讓它自動建立一個全新的 Skill。

• 通過 URL 安裝（適用於複用現有 Skill）。

  如需安裝已經開發好的 Skill，只需將該Skill的URL地址發送給 OpenClaw，系統即可自動完成安裝。例如安裝anthropics提供的網頁搭建工具Web Artifacts Builder，只需在對話中告訴 Agent 安裝該 Skill 即可系統自動完成。

• 中轉源安裝（適用於網路受限情境）。

  如果所在的伺服器網路環境無法訪問 GitHub 等外部程式碼程式庫，可以採用轉存的方式：

  1. 先將檔案下載到本地。

  2. 將代碼上傳至可訪問的儲存空間（例如上傳到OSS）。

  3. 擷取新的下載連結，按照通過 URL 安裝的步驟將該連結發送給 OpenClaw 進行安裝。

是否支援從自訂檔案夾載入 Skills？OpenClaw中Skills載入的優先順序是什嗎？

可以。通過 ~/.openclaw/openclaw.json 中的 skills.load.extraDirs 添加額外目錄（最低優先順序）。

預設載入Skills的優先順序為：<workspace>/skills > ~/.openclaw/skills > 內建> skills.load.extraDirs。

clawhub 預設安裝到 ./skills，OpenClaw會將其視為 <workspace>/skills。

安裝ClawHub上的Skills

ClawHub是專屬的技能市場管理工具，用於搜尋、安裝和管理第三方技能。

• 搜尋技能（以 weather 為例）：

  clawhub search weather

• 安裝技能：

  clawhub install weather

• 其他命令詳見：

  clawhub --help

ClawHub 已推出官方中國鏡像站，持續收錄和鏡像加速社區高品質 Skill，方便中國地區使用者更快速地擷取可複用的 Agent Skill。詳情及使用方式請參見ClawHub 中國鏡像站。

如何使用 ClawHub 中國鏡像站？

ClawHub 已推出官方中國鏡像站，持續收錄和鏡像加速社區高品質 Skill，方便中國地區使用者更快速地擷取可複用的 Agent Skill。

適用情境：當您的Simple Application Server部署在中國內地地區時，直接從預設源下載 Skill 可能存在網路延遲或速度慢的情況，建議使用中國鏡像站加速下載。

使用方式：

1. 訪問 ClawHub 中國鏡像站，瀏覽或搜尋所需的 Skill。

2. 找到目標 Skill 後，複製該 Skill 在鏡像站上的安裝地址。

3. 在 OpenClaw 對話中，將鏡像站的 Skill 地址發送給 Agent，系統即可自動完成安裝。

中國鏡像站與預設 ClawHub 源內容一致，區別僅在於下載節點位於中國內地，網路訪問速度更快。非中國地區使用者可繼續使用預設源。

Skills 下載速度慢怎麼辦？

在中國內地地區的Simple Application Server上下載或安裝 Skills 時，可能會遇到下載速度慢或連線逾時的問題。這通常是因為預設的 Skill 資源託管在海外節點，網路延遲較高。

解決方案：

• 使用 ClawHub 中國鏡像站：訪問 ClawHub 中國鏡像站擷取 Skill 的鏡像下載地址，從中國內地節點加速下載。具體操作請參見如何使用 ClawHub 中國鏡像站。

• 使用中轉源安裝：如果網路環境無法訪問 GitHub 等外部程式碼程式庫，可以將 Skill 檔案先下載到本地，再上傳至可訪問的儲存空間（如 OSS），最後通過新地址發送給 OpenClaw 進行安裝。具體操作請參見如何在OpenClaw中安裝或添加Skills中的中轉源安裝方式。

如何重啟OpenClaw Gateway 網關服務?

openclaw gateway restart

OpenClaw如何配置Brave Search連網搜尋功能？

僅中國香港和海外地區Simple Application Server執行個體可以配置Brave Search使用連網搜尋功能。

OpenClaw 2026.2.3及以上版本應用鏡像已預設內建基於SearXNG的連網搜尋Skill。

1. 在Brave Search官網建立 Brave Search API 賬戶，並產生API密鑰。

2. 在鏡像中配置，進入 OpenClaw 頁面，在左側導覽列單擊，開啟設定檔。將BRAVE_API_KEY更改為Brave Search API密鑰，複製下面代碼塊到設定檔中，並在鏡像中配置，進入 OpenClaw 頁面，在左側導覽列單擊Config > All Settings > Raw，開啟設定檔。將BRAVE_API_KEY更改為Brave Search API密鑰，複製下面代碼塊到設定檔中並粘貼到 tools.web.search 配置位置。

     "tools": {
       "web": {
         "search": {
           "provider": "brave",
           "apiKey": "BRAVE_API_KEY",
           "maxResults": 5,
           "timeoutSeconds": 30
         }
       }
     },

   操作位置如下：左側菜單中單擊 Config，在 Settings 面板中選擇 All Settings，切換到 Raw 標籤後將代碼塊粘貼到 tools.web.search 配置位置，最後單擊右上方 Save 儲存。

香港或海外地區部署的OpenClaw能否搜尋百度、微信、知乎等國內平台的內容？

可以搜尋，但搜尋效果因平台而異。

OpenClaw的連網搜尋能力依賴底層搜尋引擎，預設使用SearXNG（一個彙總多個搜尋引擎的開源元搜尋引擎），可選配Brave Search。搜尋結果的覆蓋範圍取決於底層搜尋引擎對目標內容的索引情況：

• 百度已索引的公開網頁內容：通常可正常檢索。

• 微信公眾號文章、知乎回答等平台內封閉內容：搜尋引擎覆蓋可能不完整，部分內容無法直接擷取。

如需更廣泛的搜尋覆蓋，可額外配置Brave Search。配置方式請參見OpenClaw如何配置Brave Search連網搜尋功能。

如何在OpenClaw中使用Docker容器運行工具？

OpenClaw 支援在 Docker 容器中運行工具，即降低潛在風險的影響範圍。該功能為可選項，當該功能啟用時，工具的執行將在隔離的沙箱環境中進行。具體配置操作可參見OpenClaw sandboxing功能介紹。

OpenClaw常用命令列工具（CLI）有哪些？

登入伺服器終端，切換到 root 使用者執行以下命令。

控制台"初始化"操作會影響已安裝的 Skills、記憶或歷史對話資料嗎？

在控制台執行「初始化」或重新設定 API Key 不會清除已安裝的 Skills、記憶（Memory）、歷史對話資料或訓練內容。該操作僅重設模型串連配置。

重啟 OpenClaw 網關或伺服器會遺失資料嗎？

不會。重啟 OpenClaw 網關或伺服器不會遺失資料。資料存放區在 ~/.openclaw 目錄下，只要不重設系統或刪除該目錄，配置和技能均保留。

接入飛書、DingTalk後出現多個會話是正常的嗎？

接入飛書、DingTalk等渠道時，系統會自動產生對應的平台接入會話，屬正常現象。若需清理，可在 Web UI 中手動刪除，但刪除後將無法接收該渠道訊息。

OpenClaw 是否支援叢集部署？

OpenClaw 基於Simple Application Server的應用鏡像部署，每台Simple Application Server執行個體獨立運行一個 OpenClaw 服務，不支援多台執行個體組成叢集統一調度。

如需擴充服務能力，可購買多台Simple Application Server分別部署 OpenClaw，各執行個體獨立運行、獨立管理。

如何配置OpenClaw僅使用百鍊新加坡地區免費額度，不產生額外費用？

預設狀態下，百鍊大模型（新加坡地區）在免費額度消耗完後，繼續使用會計費，若希望不產生超出免費額度外的模型調用費用，可前往百鍊平台開啟免費額度用完即停。配置完成後，模型免費額度消耗完畢將無法使用，模型免費額度用完後可更換擁有免費額度的模型繼續使用。

如何配置百鍊模型的免費額度用完即停？

預設狀態下，免費額度消耗完後繼續使用會計費。啟用免費額度用完即停功能後，免費額度耗盡將無法繼續調用（返回錯誤 code：AllocationQuota.FreeTierOnly），避免產生額外費用。

OpenClaw對話報403免費額度耗盡怎麼辦？

對話時收到403錯誤，提示AllocationQuota.FreeTierOnly，說明當前模型開啟了免费额度用完即停功能且免費額度已耗盡。百鍊控制台顯示額度充足，是因為免費額度與付費額度獨立計算。

選擇以下任一方式解決：

如何在OpenClaw中手動設定百鍊購買的Coding Plan概述？

1. 複製並儲存Coding Plan的步驟二：擷取套餐專屬 API Key 和 Base URL。

2. 將下面代碼塊中"apiKey": "YOUR_API_KEY"中的YOUR_API_KEY替換為您的步驟二：擷取套餐專屬 API Key 和 Base URL。

   "models": {"mode": "merge","providers": {"bailian": {"baseUrl": "https://coding.dashscope.aliyuncs.com/v1","apiKey": "YOUR_API_KEY","api": "openai-completions","models": [{"id": "qwen3-max-2026-01-23","name": "qwen3-max-thinking","reasoning": false,"input": ["text"],"cost": {"input": 0,"output": 0,"cacheRead": 0,"cacheWrite": 0},"contextWindow": 262144,"maxTokens": 65536}]}}},"agents": {"defaults": {"model": {"primary": "bailian/qwen3-max-2026-01-23"},"models": {"bailian/qwen3-max-2026-01-23": {"alias": "qwen3-max-thinking"}},"maxConcurrent": 4,"subagents": {"maxConcurrent": 8}}},

   "models": {"mode": "merge","providers": {"bailian": {"baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1","apiKey": "YOUR_API_KEY","api": "openai-completions","models": [{"id": "qwen3-max-2026-01-23","name": "qwen3-max-thinking","reasoning": false,"input": ["text"],"cost": {"input": 0,"output": 0,"cacheRead": 0,"cacheWrite": 0},"contextWindow": 262144,"maxTokens": 65536}]}}},"agents": {"defaults": {"model": {"primary": "bailian/qwen3-max-2026-01-23"},"models": {"bailian/qwen3-max-2026-01-23": {"alias": "qwen3-max-thinking"}},"maxConcurrent": 4,"subagents": {"maxConcurrent": 8}}},

3. 在Simple Application Server控制台-伺服器頁面，單擊部署了OpenClaw的伺服器卡片中的執行個體ID，進入服務器概覽頁面。

4. 單擊應用詳情頁簽，在存取控制頁面單擊開啟網站頁面右側的執行命令後，單擊彈窗中的網站地址URL連結可進入OpenClaw對話頁面。

5. 單擊，開啟設定檔。複製上述修改完"apiKey"參數的代碼塊，單擊Config > All Settings > Raw，開啟設定檔。複製上述修改完apiKey參數的代碼塊，替換您的配置代碼中的原agents{...}內容後儲存修改。"agents"{...}內容後儲存修改。

如何將Coding Plan的預設模型改為qwen3.6-plus？

Lite 套餐暫不支援qwen3.6-plus。

在OpenClaw 2026.4.14及以上版本的鏡像中，應用詳情頁已適配 qwen3.6-plus，可直接在控制台的模型下拉式功能表中選擇切換。如果您使用的是舊版本鏡像，可通過以下手動方式配置：

1. 進入 OpenClaw 的 WebUI，在左側功能表列中選擇配置 > RAW。

2. 在 models.providers.dashscope-coding.models 中增加 qwen3.6-plus 模型配置：

   {
     "id": "qwen3.6-plus",
     "name": "Qwen3.6-Plus",
     "api": "openai-completions",
     "reasoning": false,
     "input": ["text", "image"],
     "cost": {
       "input": 0,
       "output": 0,
       "cacheRead": 0,
       "cacheWrite": 0
     },
     "contextWindow": 1000000,
     "maxTokens": 65536
   }

3. 將 agents.defaults.model.primary 修改為 dashscope-coding/qwen3.6-plus。

4. 單擊 Save 儲存配置，然後單擊 Update 使配置生效。

購買OpenClaw伺服器配置有要求嗎，是否所有配置都可以選擇OpenClaw鏡像？

需選擇2核2G及以上配置以保障服務效能。

購買部署OpenClaw應用鏡像的Simple Application Server執行個體後，使用執行個體時還會產生其他費用嗎？

若為執行個體中的OpenClaw配置了百鍊提供的 API Key進行模型調用，則會基於 token 用量產生費用，具體計費規則遵循百鍊平台的模型調用計費說明。

通過 API 呼叫 OpenClaw 時如何計費？

Simple Application Server採用套餐計費模式，套餐費用已包含計算、儲存和頻寬資源，調用Simple Application Server的 OpenAPI 介面（如查詢執行個體資訊、管理防火牆規則等）本身不額外收費。

通過 OpenClaw 調用大模型（如百鍊平台的模型）時產生的費用屬於模型調用費用，按 Token 用量計費，與Simple Application Server套餐費用相互獨立。

如何查詢新加坡地區百鍊中模型的免費額度還剩多少？

登入百鍊控制台後，在免费额度地區可查看到您賬戶下該模型的剩餘免費額度。

如何查看阿里雲百鍊的模型調用記錄？

百鍊的國際（新加坡）、美國（維吉尼亞）和中國內地（北京）地區有什麼區別？

阿里雲百鍊提供國際（新加坡）、美國（維吉尼亞）和中國內地（北京）地區的模型服務，選擇鄰近地區調用可降低網路延遲。不同地區的服務存取點（Endpoint/Base URL）不同，且API Key不通用，支援的模型、平台功能及價格也有所不同，詳情請參見選擇模型。

海外地區的伺服器能否使用北京地區的百鍊 API Key？

可以。海外地區的Simple Application Server可以正常調用中國內地（北京）地區的百鍊模型服務，但跨地區網路延遲會導致響應明顯變慢。

Coding Plan 是否支援跨地區使用？

支援。Coding Plan 訂閱後全域生效，不區分Simple Application Server所在地區。例如，在華北地區購買的 Coding Plan，美國、新加坡等其他地區的Simple Application Server均可直接使用該 Plan 的專屬 API Key 調用模型，無需按伺服器地區重複購買。

如何在伺服器上管理檔案（上傳、下載和尋找）？

在使用 OpenClaw 過程中，Agent 產生的檔案（如代碼檔案、報告、圖片等）預設存放在 /home/admin/.openclaw/ 目錄下。

尋找產生的檔案：

• 在終端中使用 ls 命令查看目前的目錄下的檔案清單。

• 使用 find / -name "檔案名稱" 命令在整個伺服器中搜尋指定檔案。

• 也可以直接在 OpenClaw 對話中詢問 Agent 檔案存放的具體路徑。

上傳檔案到伺服器 / 下載檔案到本地：

可以通過 Workbench 檔案管理功能完成檔案上傳和下載操作，具體步驟請參見通過Workbench上傳或下載檔案。

在OpenClaw的Chat頁面對話無返回內容或無響應怎麼辦？

1. 檢查API Key配置是否正確：遠端連線至Simple Application Server中，將配置的API Key及對應地區的Base URL替換進下方代碼塊，複製並粘貼至終端後測試模型調用。若返回報錯資訊，可在錯誤碼文檔中搜尋報錯內容並根據方案處理。不同地區的 Base URL 不通用：

   • 華北2（北京）： https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

   • 美國（維吉尼亞）： https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions

   • 新加坡： https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions

   • Coding Plan套餐：https://coding-intl.dashscope.aliyuncs.com/v1/chat/completions

   curl -X POST YOUR_API_KEY_BASE_URL \
   -H "Authorization: Bearer YOUR_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
       "model": "qwen3-max-2026-01-23",
       "messages": [
           {
               "role": "user",
               "content": "你是誰？"
           }
       ]
   }'

2. 檢查模型服務是否欠費或限流情況。

   1. Coding plan：套餐存在每 5 小時、每周、每月的限額請求次數，您可以在Coding Plan 控制台查看套餐額度消耗情況。當超出限制時會報錯hour/week/month allocated quota exceeded。

      解決辦法：需等待額度自動回復。

   2. 按Token計費的百鍊API Key：

      1. 查看免費額度，登入百鍊控制台後，在免费额度地區可查看到賬戶下該模型的剩餘免費額度。

      2. 查看帳號欠費，可以訪問費用與成本中心，確保賬戶沒有欠費。

3. 排查錯誤記錄檔：前往OpenClaw Chat頁面，在左側導覽列單擊Logs，並勾選WARN、ERROR查看錯誤記錄檔，並在OpenClaw常見問題文檔中搜尋對應報錯的解決方案。

   如果Logs日誌無錯誤輸出，可在控制台重啟網關。

4. 重設鏡像

   如果確認伺服器裡沒有重要資料，可以考慮重設Simple Application Server鏡像，重設為最新的openclaw應用鏡像，重新設定使用。

   重要

   重設系統操作相當於重裝系統，會清空系統硬碟內的所有資料（包括已儲存的配置、日誌和資料庫）。在執行操作前，請務必備份重要資料（建議建立快照或將資料匯出到本地）。如需保留OpenClaw的工作區資料（如記憶、身份配置、Skills等），請參見升級OpenClaw版本的資料備份與恢複。

OpenClaw對話報錯"HTTP 400 InvalidParameter: Range of input length"怎麼處理？

此報錯的原因是對話過程中累積的上下文內容長度超過了模型的輸入上限。建議在OpenClaw對話頁面執行/new命令開啟新對話。

執行 openclaw skills list 未顯示已安裝的技能怎麼辦？

執行 openclaw skills list 後返回為空白或未列出預期技能，通常由以下原因導致：

• 目前的目錄不在工作區內：openclaw skills list 僅掃描當前工作區的 skills 目錄和 ~/.openclaw/skills 目錄。如果在其他目錄下執行，將無法檢測到已安裝的技能。切換到 OpenClaw 工作區根目錄後重新執行即可。

• 技能通過 ClawHub 安裝到了其他路徑：clawhub install 預設將技能安裝到目前的目錄的 ./skills 檔案夾。如果安裝時所在目錄與 OpenClaw 的工作區目錄不同，openclaw skills list 將無法找到這些技能。確認 ClawHub 安裝時的路徑與 OpenClaw 工作區一致，或將技能檔案夾複製到 ~/.openclaw/skills 目錄下。

• 鏡像版本過舊：2026年1月30日之前建立的執行個體可能未預裝 clawhub CLI 工具或 openclaw skills 子命令。請先重設當前應用鏡像至最新版本。

驗證步驟：

1. 切換到 OpenClaw 工作區根目錄：

   cd ~/.openclaw

2. 確認 skills 目錄存在且包含技能檔案夾：

   ls skills/

3. 重新執行技能列表命令：

   openclaw skills list

如需從技能市場安裝新技能，可使用 clawhub search 搜尋並通過 clawhub install 安裝。具體操作請參見安裝ClawHub上的Skills。

如何重啟OpenClaw網關？

當遇到串連中斷或服務不可用等情境時，可在控制台頁面重啟OpenClaw網關。在應用詳情 > 基礎配置 > 重啟 OpenClaw 網關中單擊重啟。

OpenClaw頁面報錯 HTTP 401: invalid access token or token expired如何解決？

該錯誤通常是由於應用詳情頁面的初始化配置步驟未成功完成、未填寫API Key、誤填了第三方（非百鍊）的API Key，或者手動輸入API Key時所選地區與API Key對應的地區不一致導致。

解決方案：

1. 在Simple Application Server控制台進入對應執行個體的應用詳情頁面，重新在初始化步驟中配置百鍊API Key或Coding Plan。

2. 重啟OpenClaw網關。

3. 重新擷取最新的WebUI地址並訪問，確認報錯是否消失。

OpenClaw 配置儲存失敗（修改後無法儲存、儲存後仍顯示舊值）怎麼辦？

在控制台"應用詳情"頁面修改 API Key 或模型配置後，出現儲存失敗、儲存後顯示舊值等現象，請按以下情境排查：

情境一：第三方模型配置在控制台顯示舊值

Simple Application Server控制台的"應用詳情"頁面僅支援展示和修改阿里雲百鍊模型，不支援第三方模型（DeepSeek、MiniMax 等）的回顯或修改。如果通過伺服器內設定檔 ~/.openclaw/openclaw.json 接入了第三方模型，控制台始終顯示百鍊配置資訊，屬於正常現象。

修改第三方模型的 API Key 需直接編輯伺服器內的設定檔，修改後執行 openclaw gateway restart 使配置生效。

情境二：控制台儲存百鍊 API Key 時報錯

在控制台配置百鍊 API Key 時儲存失敗，按以下步驟排查：

1. 確認 API Key 格式正確：百鍊 API Key 通常以 sk- 開頭，Coding Plan 的 API Key 以 sk-sp- 開頭。粘貼時避免首尾包含空格或分行符號。

2. 確認地區選擇正確：API Key 與地區必須匹配。北京地區的 Key 只能配置在北京地區，不能選擇新加坡或維吉尼亞。

3. 檢查網路連通性：如果瀏覽器開發人員工具中看到請求逾時或網路異常，嘗試重新整理頁面後重新儲存。

4. 檢查 API Key 是否有效：前往Coding Plan 頁面確認 Key 未被刪除或到期。

情境三：通過終端修改設定檔後未生效

直接修改 ~/.openclaw/openclaw.json 檔案後，必須重啟網關才能使配置生效：

openclaw gateway restart

重啟完成後，執行以下命令驗證配置是否已載入：

openclaw models list

如果列表中顯示了修改後的模型配置，說明儲存和載入均成功。

OpenClaw報錯 "browser failed: timed out" 或無法使用 Browser 怎麼解決？

完整報錯資訊如下：

error [tools] browser failed: timed out. Restart the OpenClaw gateway (OpenClaw.app menubar, or 'openclaw gateway'). Do NOT retry the browser tool — it will keep failing. Use an alternative approach or inform the user that the browser is currently unavailable.

出現該錯誤時，請重啟OpenClaw網關即可恢複。

OpenClaw的Skills安裝為什麼提示blocked？

OpenClaw管理介面提供了部分skills組件的一鍵安裝能力，但是大部分組件安裝依賴brew軟體，所以無法一鍵安裝，如果使用者需要使用skills，可以給伺服器安裝brew，然後進行調試。

訪問OpenClaw網站報錯 "disconnected (1008): unauthorized" 怎麼解決？

這是因為您的訪問連結中缺少身分識別驗證 Token。OpenClaw 的 Web 控制台不允許直接通過 IP 訪問，必須在 URL 中攜帶正確的 Token 參數。可以在伺服器控制台，單擊伺服器卡片中的執行個體ID，進入伺服器概覽頁面。單擊應用詳情頁簽，在存取控制頁面的地區單擊執行命令擷取正確的token訪問地址。

訪問OpenClaw網站報錯 "control ui requires device identity" 或 "control ui requires HTTPS or localhost (secure context)" 怎麼解決？

登入伺服器，修改OpenClaw設定檔中的 dangerouslyDisableDeviceAuth 參數來禁用裝置身份校正。

1. 登入Simple Application Server控制台。在伺服器列表中，找到目標伺服器卡片，單擊卡片中的遠端連線。在Workbench 一鍵連接地區，單擊立即登入。

2. 執行以下命令，編輯OpenClaw設定檔。

   vim ~/.openclaw/openclaw.json

3. 找到 gateway 配置中的 "dangerouslyDisableDeviceAuth": false，將 false 改為 true，儲存退出。

4. 執行以下命令，重啟Gateway服務使配置生效。

   openclaw gateway restart

訪問OpenClaw網站報錯 "disconnected (1006): no reason" 怎麼解決？

建議按以下步驟排查：

1. 重建 token：請登入阿里雲Simple Application Server控制台，找到執行個體進入應用詳情頁，重建新的 token。

2. 使用新 token 訪問：將新 token 拼接到訪問地址中，格式為 http://<公網IP>:<連接埠號碼>/?token=新產生的token（連接埠號碼以控制台產生的存取 URL 為準），並在無痕視窗中開啟測試。

3. 確認服務運行狀態：通過 SSH 登入伺服器，確認OpenClaw服務正在運行。

4. 檢查防火牆規則：確保輕量伺服器的防火牆已允許存取監聽連接埠的入方向流量（協議類型為 TCP）。

   若服務未正確綁定公網 IP 或反向 Proxy配置錯誤，也可能導致 WebSocket 串連失敗。建議優先通過本地 curl 或 telnet 測試是否可連通。

使用網域名稱訪問OpenClaw Web UI報錯 "origin not allowed" 怎麼解決？

當使用自訂網域名（而非IP地址）訪問OpenClaw Web UI時，可能會出現錯誤提示：origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)。

原因：OpenClaw 網關預設僅允許通過伺服器 IP 訪問 Web UI。當使用網域名稱訪問時，請求的 Origin 不在允許清單中，因此被網關攔截。

登入伺服器修改 OpenClaw 的設定檔 openclaw.json，在 allowedOrigins 配置項中添加網域名稱訪問地址。

1. 登入Simple Application Server控制台。在伺服器列表中，找到目標伺服器卡片，單擊卡片中的遠端連線。在Workbench 一鍵連接地區，單擊立即登入。

2. 在OpenClaw 的設定檔，找到 allowedOrigins 欄位，添加網域名稱訪問地址。

   "allowedOrigins": [
     "http://47.**.**.59:15386",
     "http://openclaw-us.hewushui.cn:15386"
   ]

   請將上述樣本替換為實際使用的協議 + 網域名稱或 IP + 連接埠。

3. 儲存檔案後，重啟OpenClaw網關使配置生效。

OpenClaw Web UI打不開如何排查？

當無法正常開啟OpenClaw Web UI頁面時，請登入Simple Application Server控制台逐一排查：

1. 開放OpenClaw使用的連接埠：在伺服器列表中，找到目標伺服器卡片，單擊管理 OpenClaw進入應用詳情，在OpenClaw 使用步驟地區的連接埠放通中單擊一鍵放通。

   若執行過重設鏡像，還需重新初始化並擷取新的WebUI地址。

2. 檢查設定檔是否被修改：返回伺服器列表，找到目標伺服器卡片，單擊卡片中的遠端連線。在Workbench 一鍵連接地區，單擊立即登入。執行：

   openclaw doctor --fix

   該命令會自動移除 openclaw.json 中不支援的欄位（如 allowlist）。

3. 修複完成後，重啟OpenClaw網關使配置生效。

提示 "Failed to discover Alibaba Cloud models: 401 Unauthorized" 怎麼辦？

在使用阿里雲百鍊（Model Studio）模型時，系統報錯 Failed to discover Alibaba Cloud models: 401 Unauthorized。

可能原因：出現 401 錯誤，通常是由於 API Key 填寫錯誤、API Key 所屬地區與請求的 Base URL 地區不一致，或者對應業務空間/帳號缺乏調用許可權導致。

排查與解決方案：

curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \

- H "Authorization: Bearer DASHSCOPE_API_KEY" \

- H "Content-Type: application/json" \

- d '{

    "model": "qwen3-max-2026-01-23",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user", 
            "content": "你是誰？"
        }
    ]
}'

Simple Application Server終端中報錯顯示沒有openclaw命令如何解決？

可以添加軟串連，執行命令：

ln -sf /home/clawdbot/dist/entry.js /usr/bin/openclaw
openclaw --help

啟用Tailscale 後無法擷取Token，該如何處理？

這是由於 Tailscale 修改路由策略導致的。請嘗試使用以下替代命令，直接在執行個體內部讀取 Token 資訊：

1. 登入OpenClaw伺服器終端。

2. 運行以下命令：

   echo $(sed -z 's/.*"token": "\([^"]*\)".*/\1/' /root/.clawdbot/clawdbot.json | tr -d '\0')

3. 終端輸出的字串即為 Token。

OpenClaw 連接埠 18789 監聽在 127.0.0.1，外網無法訪問怎麼辦？

OpenClaw 的 18789 連接埠監聽地址顯示為 127.0.0.1，導致無法通過外網訪問該服務。

可能原因：OpenClaw 設定檔中的 bind 參數被更改。該參數預設配置為 lan（允許公網訪問），如果被修改為 loopback 並重啟了服務，連接埠就會僅監聽本地迴環地址 127.0.0.1。

解決方案：

1. 登入伺服器並檢查配置。使用 admin 使用者登入Simple Application Server，執行以下命令檢查 bind 參數的當前配置：

   cat /home/admin/.openclaw/openclaw.json | grep bind

2. 修改設定檔。查看命令輸出結果。如果發現配置為 "bind": "loopback"，請編輯該設定檔，將其修改回預設的 "lan" 模式。

3. 重啟 Gateway 服務。修改並儲存設定檔後，執行以下命令重啟 Gateway 服務，使配置生效：

   openclaw gateway restart

   重啟完成後，連接埠將恢複正常的監聽狀態，即可恢複外網訪問。

執行 openclaw gateway restart （重啟網關）命令報錯，服務重啟失敗怎麼辦？

在嘗試重啟網關服務時，執行 openclaw gateway restart 命令出現報錯，導致服務無法成功重啟。

解決方案：當常規重啟命令執行失敗時，可以通過手動結束進程並重新啟動服務來恢複。請按照以下步驟進行操作：

1. 登入伺服器。使用 admin 使用者登入Simple Application Server。

2. 結束當前進程。執行以下命令，強制結束當前的 OpenClaw Gateway 進程：

   killall openclaw-gateway

3. 重新啟動服務。進程結束後，執行以下命令重新啟動 Gateway 服務：

   openclaw gateway start

   說明： 在執行啟動命令時，系統如果輸出報錯提示，可暫時忽略。

4. 驗證服務狀態。啟動命令執行完成後，執行命令ps aux | grep gate查看openclaw-gateway 進程是否已經成功拉起，並執行netstat -nltp確認相關連接埠是否已處於正常的監聽狀態。

Simple Application Server經常宕機/記憶體滿/OOM Killer觸發怎麼辦？

• 升級執行個體配置
  建議升級執行個體配置，將伺服器配置升級至 2核2G及以上，以提升 OpenClaw 運行穩定性，降低因資源不足導致的伺服器宕機、網站無法訪問、記憶體佔滿等問題。
  
  
  
  
  
  
  
  

• 檢查並補充 Swap 分區
  2026年2月26日之後的 OpenClaw 應用鏡像已預設配置 Swap 分區；若執行個體是更早版本鏡像，建議手動設定 Swap 分區，或直接重設當前應用鏡像至最新版本，可在記憶體不足時提供緩衝，減少 OOM Killer 觸發、服務異常中斷等情況。
  
  
  
  
  
  
  
  

Coding Plan 到期如何切換到 Token Plan？

切換步驟：

1. 前往百鍊控制台訂閱 Token Plan 團隊版套餐。

2. 參照如何在 OpenClaw 中接入百鍊 Token Plan 團隊版？完成 Token Plan 的配置。

3. 配置完成後，OpenClaw 將自動使用 Token Plan 提供的模型進行對話。

如何在 OpenClaw 中接入百鍊 Token Plan 團隊版？

Token Plan 團隊版支援按月訂閱，團隊可以共用 Token 額度使用多種模型（如 qwen3.7-max、qwen3.6-plus、deepseek-v4-pro、kimi-k2.6、glm-5.1、MiniMax-M2.5 等）。在 OpenClaw 中接入後，即可通過對話調用這些模型。

接入步驟：

1. 確認已訂閱 Token Plan 團隊版。

選擇以下任一方式修改設定檔：

關閉Simple Application Server後OpenClaw的聊天記錄會丟失嗎？

不會。關閉（停止）Simple Application Server不會丟失OpenClaw的聊天記錄，聊天資料持久化儲存在伺服器的磁碟上，關機不影響磁碟資料。但伺服器處於關機狀態時OpenClaw無法使用，無法發起新的對話，需要重新啟動伺服器後才能恢複正常使用。

以下操作會導致聊天記錄丟失：

• 重設系統：重設系統相當於重裝系統，會清空系統硬碟內的所有資料，包括OpenClaw的聊天記錄、配置和資料庫。如需保留OpenClaw的工作區資料（如記憶、身份配置、Skills等），請在重設前參見升級OpenClaw版本的資料備份與恢複。

• 釋放執行個體：釋放Simple Application Server執行個體會刪除執行個體及其所有資料，聊天記錄將無法恢複。

伺服器資源不足導致宕機/OOM 怎麼處理？OpenClaw 與其他 Agent 能否共存？

• 資源配置要求：建議Simple Application Server配置至少 2 核 2G，以保障 OpenClaw 穩定運行。低配執行個體易因記憶體不足觸發 OOM Killer 導致服務中斷。

• Swap 分區：2026年2月26日後的鏡像已預設配置 Swap。舊版本鏡像建議手動設定 Swap 或重設為最新鏡像，以緩解記憶體壓力。

• 共存風險：不建議在同一台低配伺服器上同時部署 OpenClaw 和 Hermes 等其他 Agent 服務，可能導致資源競爭、效能下降或功能衝突。建議分別部署在不同執行個體上。