OpenClaw 常见问题

已购买的轻量应用服务器，如何部署OpenClaw镜像？

1. 登录轻量应用服务器控制台，选择对应实例单击重置系统。

2. 选择重置为其他镜像，选择版本OpenClaw 2026.5.19。

3. 重新配置OpenClaw。重置后之前配置的API Key和Token都会失效，需要到应用详情里重新配置API Key。

如何重置当前应用镜像至最新版本？

若当前镜像不是OpenClaw 2026.5.19版本，希望体验最新OpenClaw能力，可重置系统来更新镜像。

1. 登录轻量应用服务器控制台，选择对应实例单击重置系统。

2. 选择重置为其他镜像，选择版本OpenClaw 2026.5.19。

3. 重新配置OpenClaw。重置后之前配置的API Key和Token都会失效，需要到应用详情里重新配置API Key。

如何查看OpenClaw的镜像版本？

有两种方式可以查看当前OpenClaw的镜像版本：

• 通过控制台查看：登录轻量应用服务器控制台，进入对应OpenClaw实例的详情页，依次查看基本信息 > 镜像，即可看到当前实例的镜像版本。

• 通过终端命令查看：在轻量应用服务器控制台，单击远程连接 > 立即登录进入终端界面，然后执行以下命令查看版本：

  openclaw --version

以上两种方式返回的版本号含义不同：

• 控制台镜像版本：显示的是创建实例时选择的镜像版本号，即安装时的初始镜像版本。

• openclaw --version 返回的版本：显示的是当前运行的 OpenClaw 程序版本号，会随程序更新而变化。

两者来源不同，因此可能出现版本号不一致的情况，属于正常现象。

重置系统时报错如何处理？

如果在重置系统时遇到报错，请先确认轻量应用服务器是否已关机。重置系统操作需要在服务器处于已停止状态下执行。

1. 登录轻量应用服务器控制台，在服务器列表中单击对应实例。

2. 在实例详情页右上角单击关机，等待服务器状态变为已停止。

3. 服务器关机后，再执行重置系统操作。

OpenClaw获取端口放通命令执行失败如何处理？

在轻量应用服务器控制台对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

• 控制台限制说明：轻量应用服务器控制台的"应用详情"页面仅支持展示和修改阿里云百炼模型，不支持第三方模型的回显或修改。第三方模型配置以服务器内 ~/.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，确认对话中已使用新模型。

切换模型后飞书不回复消息怎么办？

切换大模型后，飞书通道配置会失效，导致飞书机器人不回复消息。请前往轻量应用服务器控制台的应用详情页面，重新配置飞书通道的 App ID 和 App Secret 即可恢复。

操作步骤

1. 登录轻量应用服务器控制台，在服务器列表中单击对应实例。

2. 进入应用详情页面，找到飞书通道配置。

3. 重新填写飞书 App ID 和 App Secret，保存后飞书机器人即可恢复正常。

调用模型时报错 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（如轻量应用服务器镜像）不支持直接调用用户本地局域网或本机部署的大模型。OpenClaw 需要访问公网可达的 API Endpoint。

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

• 确保本地模型服务已映射到公网并可被云服务器访问。

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

更换 OpenClaw 模型提供商是否影响其他应用？

更换 OpenClaw 底层模型提供商仅影响 OpenClaw 应用本身，通常不会影响服务器上部署的其他应用（如 Hermes 等）。

如果配置错误导致异常，可通过在轻量应用服务器控制台创建的实例快照回滚恢复。建议在每次修改配置前创建快照或备份配置文件（cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak）。

OpenClaw 是否支持同时连接多个大模型？

支持。OpenClaw 支持同时连接多个不同厂家的大模型。在轻量应用服务器控制台，进入对应 OpenClaw 实例的应用详情页面，模型配置区块提供了两种模式：

• 阿里云百炼 Coding Plan：支持阿里云自研的 Qwen 系列以及 MiniMax、GLM、Kimi 等第三方厂家模型。

• 阿里云百炼：支持 Qwen 系列模型，包括 qwen3-vl-plus、qwen3-vl-flash 等视觉模型。

从提供商下拉框中选择模型提供商，在模型下拉框中选择具体模型，单击应用即可完成配置。第三方模型已通过百炼平台集成，无需手动输入 Base URL 或 API Key。

如何查看OpenClaw的端口号？

为了防止恶意扫描与定向攻击，OpenClaw 在初始化时会自动生成一个随机端口。在应用详情 > 基础配置 > 查看端口中单击查看查看OpenClaw的端口号。

部署在轻量应用服务器上的OpenClaw，能否授权控制本地电脑的应用？

不支持。由于轻量应用服务器运行在云端网络环境，与本地电脑网络相互隔离，因此无法直接跨网络控制本地桌面的应用程序。

为什么OpenClaw应用镜像更新至最新版本仍无法使用联网搜索功能？

请前往轻量应用服务器控制台，在镜像信息模块查看并确保已更新至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。

适用场景：当您的轻量应用服务器部署在中国内地地域时，直接从默认源下载 Skill 可能存在网络延迟或速度慢的情况，建议使用中国镜像站加速下载。

使用方式：

1. 访问 ClawHub 中国镜像站，浏览或搜索所需的 Skill。

2. 找到目标 Skill 后，复制该 Skill 在镜像站上的安装地址。

3. 在 OpenClaw 对话中，将镜像站的 Skill 地址发送给 Agent，系统即可自动完成安装。

中国镜像站与默认 ClawHub 源内容一致，区别仅在于下载节点位于中国内地，网络访问速度更快。非中国地域用户可继续使用默认源。

Skills 下载速度慢怎么办？

在中国内地地域的轻量应用服务器上下载或安装 Skills 时，可能会遇到下载速度慢或连接超时的问题。这通常是因为默认的 Skill 资源托管在海外节点，网络延迟较高。

解决方案：

• 使用 ClawHub 中国镜像站：访问 ClawHub 中国镜像站获取 Skill 的镜像下载地址，从中国内地节点加速下载。具体操作请参见如何使用 ClawHub 中国镜像站。

• 使用中转源安装：如果网络环境无法访问 GitHub 等外部代码库，可以将 Skill 文件先下载到本地，再上传至可访问的存储空间（如 OSS），最后通过新地址发送给 OpenClaw 进行安装。具体操作请参见如何在OpenClaw中安装或添加Skills中的中转源安装方式。

如何重启OpenClaw Gateway 网关服务?

openclaw gateway restart

OpenClaw如何配置Brave Search联网搜索功能？

仅中国香港和海外地域轻量应用服务器实例可以配置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 目录下，只要不重置系统或删除该目录，配置和技能均保留。

接入飞书、钉钉后出现多个会话是正常的吗？

接入飞书、钉钉等渠道时，系统会自动生成对应的平台接入会话，属正常现象。若需清理，可在 Web UI 中手动删除，但删除后将无法接收该渠道消息。

OpenClaw 是否支持集群部署？

OpenClaw 基于轻量应用服务器的应用镜像部署，每台轻量应用服务器实例独立运行一个 OpenClaw 服务，不支持多台实例组成集群统一调度。

如需扩展服务能力，可购买多台轻量应用服务器分别部署 OpenClaw，各实例独立运行、独立管理。

如何配置OpenClaw仅使用百炼新加坡地域免费额度，不产生额外费用？

默认状态下，百炼大模型（新加坡地域）在免费额度消耗完后，继续使用会扣费，若希望不产生超出免费额度外的模型调用费用，可前往百炼平台开启免费额度用完即停。配置完成后，模型免费额度消耗完毕将无法使用，模型免费额度用完后可更换拥有免费额度的模型继续使用。

如何配置百炼模型的免费额度用完即停？

默认状态下，免费额度消耗完后继续使用会扣费。启用免费额度用完即停功能后，免费额度耗尽将无法继续调用（返回错误 code：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. 在轻量应用服务器控制台-服务器页面，单击部署了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应用镜像的轻量应用服务器实例后，使用实例时还会产生其他费用吗？

若为实例中的OpenClaw配置了百炼提供的 API Key进行模型调用，则会基于 token 用量产生费用，具体计费规则遵循百炼平台的模型调用计费说明。

通过 API 调用 OpenClaw 时如何计费？

轻量应用服务器采用套餐计费模式，套餐费用已包含计算、存储和带宽资源，调用轻量应用服务器的 OpenAPI 接口（如查询实例信息、管理防火墙规则等）本身不额外收费。

通过 OpenClaw 调用大模型（如百炼平台的模型）时产生的费用属于模型调用费用，按 Token 用量计费，与轻量应用服务器套餐费用相互独立。

如何查询新加坡地域百炼中模型的免费额度还剩多少？

登录百炼控制台后，在免费额度区域可查看到您账户下该模型的剩余免费额度。

如何查看阿里云百炼的模型调用记录？

百炼的国际（新加坡）、美国（弗吉尼亚）和中国内地（北京）地域有什么区别？

阿里云百炼提供国际（新加坡）、美国（弗吉尼亚）和中国内地（北京）地域的模型服务，选择邻近地域调用可降低网络延迟。不同地域的服务接入点（Endpoint/Base URL）不同，且API Key不通用，支持的模型、平台功能及价格也有所不同，详情请参见选择模型。

海外地域的服务器能否使用北京地域的百炼 API Key？

可以。海外地域的轻量应用服务器可以正常调用中国内地（北京）地域的百炼模型服务，但跨地域网络延迟会导致响应明显变慢。

Coding Plan 是否支持跨地域使用？

支持。Coding Plan 订阅后全局生效，不区分轻量应用服务器所在地域。例如，在华北地域购买的 Coding Plan，美国、新加坡等其他地域的轻量应用服务器均可直接使用该 Plan 的专属 API Key 调用模型，无需按服务器地域重复购买。

如何在服务器上管理文件（上传、下载和查找）？

在使用 OpenClaw 过程中，Agent 生成的文件（如代码文件、报告、图片等）默认存放在 /home/admin/.openclaw/ 目录下。

查找生成的文件：

• 在终端中使用 ls 命令查看当前目录下的文件列表。

• 使用 find / -name "文件名" 命令在整个服务器中搜索指定文件。

• 也可以直接在 OpenClaw 对话中询问 Agent 文件存放的具体路径。

上传文件到服务器 / 下载文件到本地：

可以通过 Workbench 文件管理功能完成文件上传和下载操作，具体步骤请参见通过Workbench上传或下载文件。

在OpenClaw的Chat页面对话无返回内容或无响应怎么办？

1. 检查API Key配置是否正确：远程连接至轻量应用服务器中，将配置的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. 重置镜像

   如果确认服务器里没有重要数据，可以考虑重置轻量应用服务器镜像，重置为最新的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. 在轻量应用服务器控制台进入对应实例的应用详情页面，重新在初始化步骤中配置百炼API Key或Coding Plan。

2. 重启OpenClaw网关。

3. 重新获取最新的WebUI地址并访问，确认报错是否消失。

OpenClaw 配置保存失败（修改后无法保存、保存后仍显示旧值）怎么办？

在控制台"应用详情"页面修改 API Key 或模型配置后，出现保存失败、保存后显示旧值等现象，请按以下场景排查：

场景一：第三方模型配置在控制台显示旧值

轻量应用服务器控制台的"应用详情"页面仅支持展示和修改阿里云百炼模型，不支持第三方模型（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. 登录轻量应用服务器控制台。在服务器列表中，找到目标服务器卡片，单击卡片中的远程连接。在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：请登录阿里云轻量应用服务器控制台，找到实例进入应用详情页，重新生成新的 token。

2. 使用新 token 访问：将新 token 拼接到访问地址中，格式为 http://<公网IP>:<端口号>/?token=新生成的token（端口号以控制台生成的访问 URL 为准），并在无痕窗口中打开测试。

3. 确认服务运行状态：通过 SSH 登录服务器，确认OpenClaw服务正在运行。

4. 检查防火墙规则：确保轻量服务器的防火墙已放行监听端口的入方向流量（协议类型为 TCP）。

   若服务未正确绑定公网 IP 或反向代理配置错误，也可能导致 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. 登录轻量应用服务器控制台。在服务器列表中，找到目标服务器卡片，单击卡片中的远程连接。在Workbench 一键连接区域，单击立即登录。

2. 在OpenClaw 的配置文件，找到 allowedOrigins 字段，添加域名访问地址。

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

   请将上述示例替换为实际使用的协议 + 域名或 IP + 端口。

3. 保存文件后，重启OpenClaw网关使配置生效。

OpenClaw Web UI打不开如何排查？

当无法正常打开OpenClaw Web UI页面时，请登录轻量应用服务器控制台逐一排查：

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": "你是谁？"
        }
    ]
}'

轻量应用服务器终端中报错显示没有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 用户登录轻量应用服务器，执行以下命令检查 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 用户登录轻量应用服务器。

2. 结束当前进程。执行以下命令，强制结束当前的 OpenClaw Gateway 进程：

   killall openclaw-gateway

3. 重新启动服务。进程结束后，执行以下命令重新启动 Gateway 服务：

   openclaw gateway start

   说明： 在执行启动命令时，系统如果输出报错提示，可暂时忽略。

4. 验证服务状态。启动命令执行完成后，执行命令ps aux | grep gate查看openclaw-gateway 进程是否已经成功拉起，并执行netstat -nltp确认相关端口是否已处于正常的监听状态。

轻量应用服务器经常宕机/内存满/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 团队版。

选择以下任一方式修改配置文件：

关闭轻量应用服务器后OpenClaw的聊天记录会丢失吗？

不会。关闭（停止）轻量应用服务器不会丢失OpenClaw的聊天记录，聊天数据持久化存储在服务器的磁盘上，关机不影响磁盘数据。但服务器处于关机状态时OpenClaw无法使用，无法发起新的对话，需要重新启动服务器后才能恢复正常使用。

以下操作会导致聊天记录丢失：

• 重置系统：重置系统相当于重装系统，会清空系统盘内的所有数据，包括OpenClaw的聊天记录、配置和数据库。如需保留OpenClaw的工作区数据（如记忆、身份配置、Skills等），请在重置前参见升级OpenClaw版本的数据备份与恢复。

• 释放实例：释放轻量应用服务器实例会删除实例及其所有数据，聊天记录将无法恢复。

服务器资源不足导致宕机/OOM 怎么处理？OpenClaw 与其他 Agent 能否共存？

• 资源配置要求：建议轻量应用服务器配置至少 2 核 2G，以保障 OpenClaw 稳定运行。低配实例易因内存不足触发 OOM Killer 导致服务中断。

• Swap 分区：2026年2月26日后的镜像已默认配置 Swap。旧版本镜像建议手动配置 Swap 或重置为最新镜像，以缓解内存压力。

• 共存风险：不建议在同一台低配服务器上同时部署 OpenClaw 和 Hermes 等其他 Agent 服务，可能导致资源竞争、性能下降或功能冲突。建议分别部署在不同实例上。