鏡像更新與重設問題
已購買的Simple Application Server,如何部署OpenClaw鏡像?
登入輕量應用控制台,選擇對應執行個體單擊重設系統。
選擇重設為其他鏡像,選擇版本
Openclaw 2026.3.13。重新設定OpenClaw。重設後之前配置的API Key和Token都會失效,需要到應用詳情裡重新設定API Key。
重設系統操作相當於重裝系統,會清空系統硬碟內的所有資料(包括已儲存的配置、日誌和資料庫)及停止輕量伺服器中正在啟動並執行業務程式。在執行操作前,請務必備份重要資料(建議建立快照或將資料匯出到本地)。
如何重設當前應用鏡像至最新版本?
重設系統操作相當於重裝系統,會清空系統硬碟內的所有資料(包括已儲存的配置、日誌和資料庫)。在執行操作前,請務必備份重要資料(建議建立快照或將資料匯出到本地)。
若當前鏡像不是Openclaw 2026.3.13版本,希望體驗最新OpenClaw能力,可重設系統來更新鏡像。登入輕量應用控制台,選擇對應執行個體單擊重設系統。
選擇重設當前系統。
重新設定OpenClaw。重設後之前配置的API Key和Token都會失效,需要到應用詳情裡重新設定API Key。
OpenClaw功能配置問題
OpenClaw報錯“API rate limit reached”怎麼辦?
請按以下順序排查:
OpenClaw 配置錯誤。
若 Base URL 或模型供應商配置有誤,導致請求未進入 Coding Plan 專屬通道,而是被路由到了通用的API 呼叫,從而觸發限流。
若使用 Coding Plan 套餐,請核對OpenClaw設定檔中的
models、agents、gateway(含嵌套欄位),確保與文檔配置一致。例如:模型服務提供者的結構為{ "models": { "providers": { "bailian": {...} } } }。若當前未使用 Coding Plan 套餐,建議切換至 Coding Plan 以擷取專屬額度。
超出套餐限額:在Coding Plan頁面查看套餐用量情況。
若額度已用盡,在該頁面查看下一次額度重設的時間。
若頻繁觸達限額,建議升級至 Pro 套餐以擷取更多調用次數。
嘗試重設 API Key:若完成上述排查後問題仍未解決,請前往Coding Plan頁面重設 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鏡像預設已初始化阿里雲百鍊 (Bailian) Provider,可直接在設定中修改其使用的具體 Model。如需接入 OpenAI、Anthropic、Google Gemini 或其他廠商的模型服務,請參考如下步驟進行配置。
使用
admin使用者登入Simple Application Server。更改模型供應商(以OpenRouter為例)。
openclaw onboard
驗證修改。登入網頁控制台,與Agents進行對話驗證。
如何更改OpenClaw調用的模型?
OpenClaw整合了阿里雲百鍊平台,在頁面切換不同的模型。在中刪除預設的模型,然後下拉選擇不同的百鍊模型。
支援手動輸入模型名,模型Code可以在百鍊模型廣場頁面查詢。
如何在OpenClaw中安裝或添加Skills?
OpenClaw 支援通過對話互動、連結安裝以及轉存安裝三種方式來添加 Skill,具體操作如下:
互動式建立(適用於建立 Skill)。
OpenClaw 內建了 Skill Creator 組件。可直接與 Skill Creator 進行對話聊天,描述需求,讓它自動建立一個全新的 Skill。
通過 URL 安裝(適用於複用現有 Skill)。
如需安裝已經開發好的 Skill,只需將該Skill的URL地址發送給 OpenClaw,系統即可自動完成安裝。例如安裝anthropics提供的網頁搭建工具Web Artifacts Builder,只需在對話中告訴 Agent 安裝該 Skill 即可系統自動完成。
中轉源安裝(適用於網路受限情境)。
如果所在的伺服器網路環境無法訪問 GitHub 等外部程式碼程式庫,可以採用轉存的方式:
是否支援從自訂檔案夾載入 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
支援在鏡像內部升級OpenClaw版本嗎/支援線上升級OpenClaw版本嗎?
目前暫不支援,可以通過重設當前應用鏡像至最新版本。
重設系統操作相當於重裝系統,會清空系統硬碟內的所有資料(包括已儲存的配置、日誌和資料庫)。在執行操作前,請務必備份重要資料(建議建立快照或將資料匯出到本地)。
如何重啟OpenClaw Gateway 網關服務?
OpenClaw 2026.2.9版本及以上
可以通過控制台頁面直接完成重啟操作:在中單擊重啟。
OpenClaw 2026.2.9之前的版本
需要通過命令列終端手動完成重啟操作:遠端連線至Simple Application Server,在終端用 Gateway 網關輔助命令:
openclaw gateway restart輕量伺服器裡安裝的OpenClaw不同設定檔是做什麼的?
設定檔目錄:
/root/.openclaw/主設定檔:
/root/.openclaw/openclaw.json(包含使用的模型)模型api-key設定檔:
/root/.openclaw/agents/main/agent/auth-profiles.json
可以直接修改設定檔,增加模型、增加api-key配置。
如何在OpenClaw中手動設定百鍊購買的Coding Plan?
複製並儲存Coding Plan的套餐專屬 API Key。
將下面代碼塊中"apiKey": "YOUR_API_KEY"中的YOUR_API_KEY替換為您的套餐專屬 API Key。
"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 } } },在Simple Application Server控制台-伺服器頁面,單擊部署了OpenClaw的伺服器卡片中的執行個體ID,進入伺服器概覽頁面。
單擊應用詳情頁簽,在存取控制頁面單擊開啟網站頁面右側的執行命令後,單擊彈窗中的網站地址URL連結可進入OpenClaw對話頁面。
單擊,開啟設定檔。複製上述修改完
"apiKey"參數的代碼塊,按照下圖所示操作替換您的配置代碼中的原"agents"{...}內容後儲存修改。
OpenClaw如何配置Brave Search連網搜尋功能?
僅中國香港和海外地區Simple Application Server執行個體可以配置Brave Search使用連網搜尋功能。
OpenClaw 2026.2.3及以上版本應用鏡像已預設內建基於SearXNG的連網搜尋Skill。
在Brave Search官網建立 Brave Search API 賬戶,並產生API密鑰。
在鏡像中配置,進入 OpenClaw 頁面,在左側導覽列單擊,開啟設定檔。將
BRAVE_API_KEY更改為Brave Search API密鑰,複製下面代碼塊到設定檔中,並粘貼到如圖所示位置。"tools": { "web": { "search": { "provider": "brave", "apiKey": "BRAVE_API_KEY", "maxResults": 5, "timeoutSeconds": 30 } } },
如何在OpenClaw中使用Docker容器運行工具?
OpenClaw 支援在 Docker 容器中運行工具,即降低潛在風險的影響範圍。該功能為可選項,當該功能啟用時,工具的執行將在隔離的沙箱環境中進行。具體配置操作可參見OpenClaw sandboxing功能介紹。
OpenClaw常用命令列工具(CLI)有哪些?
如果執行個體建立於 2026年1月30日之前,可能會因版本過舊導致無法使用以下命令。請先參照如何重設當前應用鏡像至最新版本?升級鏡像,新版鏡像已預裝所有必要的 CLI 工具。
登入伺服器終端,切換到 root 使用者執行以下命令。
核心管理工具:OpenClaw
OpenClaw 是系統內建的核心 CLI。查看已安裝技能 (Skills)。
openclaw skills list外掛程式與通道管理:Plugins
通過
openclaw plugins命令管理擴充外掛程式。查看外掛程式命令協助:擷取安裝、配置外掛程式的完整指令列表。
openclaw plugins -h
購買與費用問題
如何配置OpenClaw僅使用百鍊新加坡地區免費額度,不產生額外費用?
預設狀態下,百鍊大模型(新加坡地區)在免費額度消耗完後,繼續使用會計費,若希望不產生超出免費額度外的模型調用費用,可前往百鍊平台開啟免費額度用完即停。配置完成後,模型免費額度消耗完畢將無法使用,模型免費額度用完後可更換擁有免費額度的模型繼續使用。
如何配置百鍊模型的免費額度用完即停?
預設狀態下,免費額度消耗完後繼續使用會計費。啟用免費額度用完即停功能後,免費額度耗盡將無法繼續調用(返回錯誤 code:AllocationQuota.FreeTierOnly),避免產生額外費用。
方式一:在模型用量頁面開啟
為單個模型開啟:
在控制台的模型用量頁面,點擊免费额度頁簽。
在頁面列表中找到目標模型,在其右側操作列中開啟免费额度用完即停開關(若該模型沒有免費額度,則無法開啟)。
批量開啟:
在控制台的模型用量頁面,點擊免费额度頁簽。
點擊批量操作免费额度用完即停,在下拉式功能表中選擇批量开启。
勾選目標模型,點擊批量开启。若需為所有支援且未開啟的模型啟用此功能,可點擊一键开启所有模型。
在確認彈窗中,點擊开启免费额度用完即停。

方式二:在模型廣場頁面開啟
以 Qwen3-Coder-Plus 為例。前往Qwen3-Coder-Plus 模型詳情頁(新加坡地區)並開啟免费额度用完即停開關。

若模型沒有顯示開關,說明該模型免費額度已耗盡或到期,或模型本身沒有提供免費額度。
購買OpenClaw伺服器配置有要求嗎,是否所有配置都可以選擇OpenClaw鏡像?
需選擇2核2G及以上配置以保障服務效能。
購買部署OpenClaw應用鏡像的Simple Application Server執行個體後,使用執行個體時還會產生其他費用嗎?
若為執行個體中的OpenClaw配置了百鍊提供的 API Key進行模型調用,則會基於 token 用量產生費用,具體計費規則遵循百鍊平台的模型調用計費說明。
如何查詢新加坡地區百鍊中模型的免費額度還剩多少?
登入百鍊控制台後,在免費額度地區可查看到您賬戶下該模型的剩餘免費額度。
如何查看阿里雲百鍊的模型調用記錄?
模型調用完一小時後,在模型監控(新加坡或北京)版面設定查詢條件(例如,選擇時間範圍、業務空間等),再在模型列表地區找到目標模型並單擊操作列的監控,即可查看該模型的調用統計結果。具體請參見模型監控文檔。
資料按小時更新,高峰期可能有小時級延遲,請您耐心等待。

百鍊的國際(新加坡)、美國(維吉尼亞)和中國內地(北京)地區有什麼區別?
阿里雲百鍊提供國際(新加坡)、美國(維吉尼亞)和中國內地(北京)地區的模型服務,選擇鄰近地區調用可降低網路延遲。不同地區的服務存取點(Endpoint/Base URL)不同,且API Key不通用,支援的模型、平台功能及價格也有所不同,詳情請參見模型列表。
故障排查
在OpenClaw的Chat頁面對話無返回內容或無響應怎麼辦?
檢查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/completionsCoding 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": "你是誰?" } ] }'檢查模型服務是否欠費或限流情況。
Coding plan:套餐存在每 5 小時、每周、每月的限額請求次數,您可以在Coding Plan 控制台查看套餐額度消耗情況。當超出限制時會報錯
hour/week/month allocated quota exceeded。解決辦法:需等待額度自動回復或升級至 Pro 套餐。
按Token計費的百鍊API Key:
排查錯誤記錄檔:前往OpenClaw Chat頁面,在左側導覽列單擊Logs,並勾選
WARN、ERROR查看錯誤記錄檔,並在OpenClaw常見問題文檔中搜尋對應報錯的解決方案。
如果Logs日誌無錯誤輸出,可在控制台重啟網關。
重設鏡像
如果確認伺服器裡沒有重要資料,可以考慮重設Simple Application Server鏡像,重設為最新的openclaw應用鏡像,重新設定使用。
重要重設系統操作相當於重裝系統,會清空系統硬碟內的所有資料(包括已儲存的配置、日誌和資料庫)。在執行操作前,請務必備份重要資料(建議建立快照或將資料匯出到本地)。
OpenClaw頁面報錯 HTTP 401: invalid access token or token expired如何解決?
錯誤提示Token到期了,需到Simple Application Server控制台應用詳情頁面裡,重新擷取OpenClaw登入地址後,再訪問查看。
OpenClaw的Skills安裝為什麼提示blocked?
OpenClaw管理介面提供了部分skills組件的一鍵安裝能力,但是大部分組件安裝依賴brew軟體,所以無法一鍵安裝,如果使用者需要使用skills,可以給伺服器安裝brew,然後進行調試。
訪問OpenClaw網站報錯 "disconnected (1008): unauthorized" 怎麼解決?
這是因為您的訪問連結中缺少身分識別驗證 Token。OpenClaw 的 Web 控制台不允許直接通過 IP 訪問,必須在 URL 中攜帶正確的 Token 參數。可以在伺服器控制台,單擊伺服器卡片中的執行個體ID,進入伺服器概覽頁面。單擊應用詳情頁簽,在存取控制頁面的地區單擊執行命令擷取正確的token訪問地址。
訪問OpenClaw網站報錯 "disconnected (1008): control ui requires HTTPS or localhost (secure context)" 怎麼解決?
這個錯誤是token沒初始化導致的,需要Simple Application Server控制台的應用詳情頁面,第二步設定一下apikey ,然後再擷取訪問連結訪問。
訪問OpenClaw網站報錯 "disconnected (1006): no reason" 怎麼解決?
建議按以下步驟排查:
重建 token:請登入阿里雲Simple Application Server控制台,找到執行個體進入應用詳情頁,重建新的 token。
使用新 token 訪問:將新 token 拼接到訪問地址中,格式為
http://XXX:18789/?token= 新產生的token,並在無痕視窗中開啟測試。確認服務運行狀態:通過 SSH 登入伺服器,確認OpenClaw服務正在運行。
檢查防火牆規則:確保輕量伺服器的防火牆已允許存取監聽連接埠的入方向流量(協議類型為 TCP)。
若服務未正確綁定公網 IP 或反向 Proxy配置錯誤,也可能導致 WebSocket 串連失敗。建議優先通過本地 curl 或 telnet 測試是否可連通。
提示 "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 地區不一致,或者對應業務空間/帳號缺乏調用許可權導致。
排查與解決方案:
排查一:檢查 API Key 與地區配置是否一致
國內帳號使用的百鍊 API Key 通常屬於北京地區,預設對應的也是北京地區的 Base URL。如果地區配置錯位,將導致 401 錯誤。
控制台檢查: 在Simple Application Server控制台配置 API Key 時,請確認選擇的百鍊地區是否正確。北京地區的 API Key 只能用於北京地區,請勿錯誤配置為“新加坡”或“美國(維吉尼亞)”。
設定檔檢查: 可登入對應伺服器,查看底層設定檔,確認 API Key 被配置到了哪個地區。
執行以下命令查看配置:
cat /home/admin/.openclaw/agents/main/agent/auth-profiles.json
設定檔欄位說明:
alibaba-cloud:預設北京地區配置(北京地區的 API Key 必須配置在此節點下才能正常使用)。alibaba-cloud-international:新加坡地區配置。alibaba-cloud-us:美國(維吉尼亞)地區配置。
排查二:檢查業務空間的模型調用許可權
如果使用的 API Key 不屬於“預設業務空間”,請檢查該業務空間是否具備目標模型的調用許可權。
登入百鍊控制台,查看當前 API Key 所屬的業務空間。
非預設業務空間預設不開啟模型調用許可權。需要進入該業務空間設定內,手動開啟對應模型(如
qwen3-max-2026-01-23等)的調用許可權。
排查三:驗證 API Key 狀態是否正常
如果以上配置均正確,需驗證 API Key 本身是否存在填寫錯誤、帳號欠費或失效等情況。詳情可參考curl。
可在本地終端運行以下 curl 命令進行連通性測試(請將 DASHSCOPE_API_KEY 替換為實際的 API Key):
擷取 API Key 請訪問:擷取 API Key 文檔。以下命令使用的是北京地區的 URL。如果使用的是新加坡地區的模型,請將請求地址替換為:https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions。測試命令:
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": "你是誰?"
}
]
}'如果該命令同樣返回 401 錯誤,說明您的 API Key 本身無效或賬戶存在欠費,請前往阿里雲百鍊控制台重建 Key 或檢查賬戶餘額。
Simple Application Server終端中報錯顯示沒有openclaw命令如何解決?
可以添加軟串連,執行命令:
ln -sf /home/clawdbot/dist/entry.js /usr/bin/openclaw
openclaw --help啟用Tailscale 後無法擷取Token,該如何處理?
這是由於 Tailscale 修改路由策略導致的。請嘗試使用以下替代命令,直接在執行個體內部讀取 Token 資訊:
登入OpenClaw伺服器終端。
運行以下命令:
echo $(sed -z 's/.*"token": "\([^"]*\)".*/\1/' /root/.clawdbot/clawdbot.json | tr -d '\0')終端輸出的字串即為 Token。
OpenClaw 連接埠 18789 監聽在 127.0.0.1,外網無法訪問怎麼辦?
OpenClaw 的 18789 連接埠監聽地址顯示為 127.0.0.1,導致無法通過外網訪問該服務。
可能原因:OpenClaw 設定檔中的 bind 參數被更改。該參數預設配置為 lan(允許公網訪問),如果被修改為 loopback 並重啟了服務,連接埠就會僅監聽本地迴環地址 127.0.0.1。
解決方案:
登入伺服器並檢查配置。使用
admin使用者登入Simple Application Server,執行以下命令檢查bind參數的當前配置:cat /home/admin/.openclaw/openclaw.json | grep bind修改設定檔。查看命令輸出結果。如果發現配置為
"bind": "loopback",請編輯該設定檔,將其修改回預設的"lan"模式。重啟 Gateway 服務。修改並儲存設定檔後,執行以下命令重啟 Gateway 服務,使配置生效:
openclaw gateway restart重啟完成後,連接埠將恢複正常的監聽狀態,即可恢複外網訪問。
執行 openclaw gateway restart (重啟網關)命令報錯,服務重啟失敗怎麼辦?
在嘗試重啟網關服務時,執行 openclaw gateway restart 命令出現報錯,導致服務無法成功重啟。
解決方案:當常規重啟命令執行失敗時,可以通過手動結束進程並重新啟動服務來恢複。請按照以下步驟進行操作:
登入伺服器。使用
admin使用者登入Simple Application Server。結束當前進程。執行以下命令,強制結束當前的 OpenClaw Gateway 進程:
killall openclaw-gateway重新啟動服務。進程結束後,執行以下命令重新啟動 Gateway 服務:
openclaw gateway start說明: 在執行啟動命令時,系統如果輸出報錯提示,可暫時忽略。
驗證服務狀態。啟動命令執行完成後,執行命令
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 觸發、服務異常中斷等情況。