镜像更新与重置问题
OpenClaw 2026.2.3版本应用镜像相较于Moltbot 2026.1.27-beta.1版本应用镜像更新了什么?
内置软件版本升级为OpenClaw,并同步支持社区版本2026年2月3日前的最新能力。
在所有地域均默认提供基于内置SearXNG联网搜索Skill的联网搜索能力,无需额外配置,不收取额外费用。
支持文本处理与图像识别协同工作能力,其中用于图像识别的Image Model默认为
qwen3-vl-plus模型。OpenClaw 2026.2.3版本内置Docker,可以满足Agent使用Docker运行时作为Sandbox的需求。
如何将应用镜像更新为OpenClaw 2026.2.3版本?已购买的轻量应用服务器,如何部署OpenClaw镜像?
登录轻量应用控制台,选择对应实例单击重置系统。
选择重置为其他镜像,选择OpenClaw 2026.2.3版本。
重新配置OpenClaw。重置后之前配置的API Key和Token都会失效,需要到应用详情里重新配置API Key。
重置系统操作相当于重装系统,会清空系统盘内的所有数据(包括已保存的配置、日志和数据库)及停止轻量服务器中正在运行的业务程序。在执行操作前,请务必备份重要数据(建议创建快照或将数据导出到本地)。

如何重置当前应用镜像至最新版本?
重置系统操作相当于重装系统,会清空系统盘内的所有数据(包括已保存的配置、日志和数据库)。在执行操作前,请务必备份重要数据(建议创建快照或将数据导出到本地)。
若您当前镜像为Moltbot 2026.1.27-beta.1版本,希望体验最新OpenClaw能力,可参考如何将应用镜像更新为OpenClaw 2026.2.3版本?已购买的轻量应用服务器,如何部署OpenClaw镜像?更换镜像。登录轻量应用控制台,选择对应实例单击重置系统。
选择重置当前系统。
重新配置OpenClaw。重置后之前配置的API Key和Token都会失效,需要到应用详情里重新配置API Key。
OpenClaw功能配置问题
部署在轻量应用服务器上的OpenClaw,能否授权控制本地电脑的应用?
不支持。由于轻量应用服务器运行在云端网络环境,与您的本地电脑网络相互隔离,因此无法直接跨网络控制您本地桌面的应用程序。
为什么OpenClaw应用镜像更新至最新版本仍无法使用联网搜索功能?
请前往轻量应用服务器控制台,在镜像信息模块查看并确保您已更新至OpenClaw 2026.2.3版本应用镜像,若不是该版本需要参考如何将应用镜像更新为OpenClaw 2026.2.3版本?已购买的轻量应用服务器,如何部署OpenClaw镜像?进行更新。该版本应用镜像在所有地域均默认提供基于内置SearXNG联网搜索Skill的联网搜索能力,无需额外配置,不收取额外费用,您可以直接告诉OpenClaw使用SearXNG的Skill进行联网搜索。若您的服务器部署在中国香港或海外地域时,可参考OpenClaw如何配置Brave Search联网搜索?配置Brave Search API进行联网搜索。
OpenClaw如何配置其他模型服务商?如何更换第三方模型服务?
当前OpenClaw镜像默认已初始化阿里云百炼 (Bailian) Provider,可直接在设置中修改其使用的具体 Model。如果您需要接入 OpenAI、Anthropic、Google Gemini 或其他厂商的模型服务,请参考如下步骤进行配置。
登录服务器终端,切换到 root 用户。
sudo -i更改模型提供商(以OpenRouter为例)。
openclaw onboard
验证修改。登录网页控制台,查看模型配置,可以看到增加的模型配置。

如何更改OpenClaw调用的模型?
在轻量应用服务器控制台-服务器页面,单击部署了OpenClaw的服务器卡片中的实例ID,进入服务器概览页面。
单击应用详情页签,在访问控制页面单击快速查看可进入Clawdbot对话页面。
单击,搜索Primary Model或Image Model,更改为百炼中支持的模型,填写格式为
alibaba-cloud/模型Code,如alibaba-cloud/qwen3-max-2026-01-23,模型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。
如何重启OpenClaw Gateway 网关服务
远程连接至轻量应用服务器,在终端界面使用 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.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 } } },在轻量应用服务器控制台-服务器页面,单击部署了OpenClaw的服务器卡片中的实例ID,进入服务器概览页面。
单击应用详情页签,在访问控制页面单击打开网站页面右侧的执行命令后,单击弹窗中的网站地址URL链接可进入OpenClaw对话页面。
单击,打开配置文件。复制上述修改完
"apiKey"参数的代码块,按照下图所示操作替换您的配置代码中的原"agents"{...}内容后保存修改。
OpenClaw如何配置Brave Search联网搜索?
默认提供基于内置SearXNG联网搜索Skill的联网搜索能力,中国香港及海外地域可以配置联网搜索,可配置Brave Search的API Key使用Brave Search联网搜索,可以参考OpenClaw官方文档或阿里云文档:部署OpenClaw镜像并构建钉钉AI员工进行配置。
如果您已经有了Brave Search的API Key,可以登录轻量应用服务器,执行以下命令来开启设置Brave Search。
openclaw configure --section web轻量应用服务器终端中报错显示没有openclaw命令如何解决?
可以添加软连接,执行命令:
ln -sf /home/clawdbot/dist/entry.js /usr/bin/openclaw
openclaw --help支持配置的Brave Search API进行联网搜索吗?
中国香港及海外地域可以配置 Brave Search API使用联网搜索功能,中国内地服务器暂不支持。
在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技能市场工具:Molthub
molthub是专属的技能市场管理工具,用于搜索、安装和管理第三方技能。目前镜像中已预装了 50+ 常用技能。搜索技能(以 weather 为例):
molthub search weather安装技能:
molthub install weather其他命令详见:
molthub --help
插件与通道管理:Plugins
通过
openclaw plugins命令管理扩展插件。查看插件命令帮助:获取安装、配置插件的完整指令列表。
openclaw plugins -h
购买与费用问题
如何配置OpenClaw仅使用百炼免费额度,不产生额外费用?
默认状态下,百炼大模型在免费额度消耗完后,继续使用会扣费,若您希望不产生超出免费额度外的模型调用费用,可前往百炼平台开启免费额度用完即停。配置完成后,模型免费额度消耗完毕将无法使用,模型免费额度用完后可更换拥有免费额度的模型继续使用。
购买OpenClaw服务器配置有要求吗,是否所有配置都可以选择OpenClaw镜像?
需选择2核2G及以上配置以保障服务性能。
购买部署OpenClaw应用镜像的轻量应用服务器实例后,使用实例时还会产生其他费用吗?
若您为实例中的OpenClaw配置了百炼提供的 API Key进行模型调用,则会基于 token 用量产生费用,具体计费规则遵循百炼平台的模型调用计费说明。
如何查询百炼中模型的免费额度还剩多少?
登录百炼控制台后,在免费额度区域可查看到您账户下该模型的剩余免费额度。

为什么开通了Coding Plan还有模型 API 调用费用产生?
可能有以下原因:
-
如果在 AI 工具中配置的是百炼通用 API Key(格式为
sk-xxxxx)和通用 Base URL(不含 coding 关键字),系统会将这些调用识别为百炼按量计费请求,无法抵扣 Coding Plan 套餐额度,仍会产生按量计费的账单。您需要正确地配置套餐专属的凭证信息,详情参见2. 获取套餐专属 API Key 和 Base URL。 -
该费用可能产生于开通 Coding Plan 之前的模型 API 调用。因账单按小时结算,如遇高峰期可能存在小时级延时。例如:在 16:00 调用 API,19:00 开通 Coding Plan 并使用,19:30 系统出账时显示的费用实为 16:00 调用所产生的。具体以实际出账时间为准,详情请参见账单查询与成本管理。
如何查看阿里云百炼的模型调用记录?
模型调用完一小时后,在模型监控(北京或新加坡)页面设置查询条件(例如,选择时间范围、业务空间等),再在模型列表区域找到目标模型并单击操作列的监控,即可查看该模型的调用统计结果。具体请参见模型监控文档。
数据按小时更新,高峰期可能有小时级延迟,请您耐心等待。

百炼的中国内地(北京)、美国(弗吉尼亚)和国际(新加坡)地域有什么区别?
阿里云百炼提供中国内地(北京)、美国(弗吉尼亚)和国际(新加坡)地域的模型服务,选择邻近地域调用可降低网络延迟。不同地域的服务接入点(Endpoint/Base URL)不同,且API Key不通用,支持的模型、平台功能及价格也有所不同,详情请参见模型列表。
故障排查
在OpenClaw的Chat页面对话无返回内容或无响应怎么办?
检查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/completionsCoding Plan套餐:
https://coding.dashscope.aliyuncs.com/v1
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日志无错误输出,可以远程连接至轻量应用服务器后,在终端中执行以下命令尝试重启网关服务。
moltbot gateway restart重置镜像
如果确认服务器里没有重要数据,可以考虑重置轻量应用服务器镜像,重置为最新的openclaw应用镜像,重新配置使用。
重要重置系统操作相当于重装系统,会清空系统盘内的所有数据(包括已保存的配置、日志和数据库)。在执行操作前,请务必备份重要数据(建议创建快照或将数据导出到本地)。
OpenClaw页面报错 HTTP 401: invalid access token or token expired如何解决?
错误提示Token过期了,需到轻量应用服务器控制台应用详情页面里,重新获取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没初始化导致的,需要轻量应用服务器控制台的应用详情页面,第二步设置一下apikey ,然后再获取访问链接访问。
访问OpenClaw网站报错 "disconnected (1006): no reason" 怎么解决?
建议您按以下步骤排查:
重新生成 token:请登录阿里云轻量应用服务器控制台,找到您的实例(ID: t-gz06aj39x9e5ukg),进入应用详情页,重新生成新的 token。
使用新 token 访问:将新 token 拼接到访问地址中,格式为
http://XXX:18789/?token= 新生成的token,并在无痕窗口中打开测试。确认服务运行状态:通过 SSH 登录服务器,确认OpenClaw服务正在运行且监听 18789 端口。
检查安全组规则:确保轻量服务器的安全组已放行 18789 端口 的入方向流量(协议类型为 TCP)。
若服务未正确绑定公网 IP 或反向代理配置错误,也可能导致 WebSocket 连接失败。建议优先通过本地 curl 或 telnet 测试 8.138.139.147:18789 是否可连通。
报错"Failed to discover Alibaba Cloud models: 401 Unauthorized "怎么解决?
可能是欠费、没有模型调用权限等。可以参考检查API Key步骤调用百炼模型进行测试,查看详细错误,确认API Key是否可以正常使用。
轻量应用服务器终端中报错显示没有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。
钉钉机器人对话没有反应如何排查?
首先查看AppFlow菜单,执行日志,是否有日志,如果没有日志,那么常见原因是钉钉应用没有发布最新版本导致,需要在钉钉机器人控制台页面,创建新版本并发布。
不仅要发布机器人,还需要发布钉钉应用。


检查消息接收地址URL是否正确。URL格式一定为
https://xxxxx.appflow.aliyunnest.com/webhook/xxxxxxxxx。强烈建议自己拉群测试,不要使用钉钉提供的测试群进行测试。

检查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/completionsCoding Plan套餐:
https://coding.dashscope.aliyuncs.com/v1
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:
查看免费额度,登录后,在免费额度区域可查看到您账户下该模型的剩余免费额度。
查看账号欠费,您可以访问费用与成本中心,确保您的账户没有欠费。
检查AppFlow连接流运行日志,第二个节点输出的text是不是为空,如果输出是空的,可能是OpenClaw不稳定,建议看看OpenClaw log进行分析或者重启下OpenClaw服务。
如何根据日志信息排查钉钉机器人出现的问题?
访问执行日志页面,可以点击详情,查看每个节点的输入、输出、错误日志信息
机器人回答日期错误,不能准确识别当前最新日期如何解决?
可能是模型能力的原因,可尝试将模型更改为 qwen3-max-2026-01-23 模型。或者让Openlcaw执行date系统命令获取系统时间。
配置了钉钉机器人,Appflow日志报错RobotCode如何处理?
出现RobotCode错误,常见的就是钉钉机器人配置流程有异常,配置过程中参数填写错误或者步骤操作不对,建议参考文档的配置步骤重新配置一下,注意配置步骤中填写的参数,不要填写错误。
报错:“The provided parameter "input" is invalid.”如何解决?

不要在控制台选择点击“运行一次”,直接到钉钉@机器人进行测试。
报错:ClawdBot Method Not Allowed http response: Method Not Allowed如何解决?
需要打开http配置选项

报错:"Connect to xxxxxxxx failed: Connection refused (Connection refused)"如何解决?
端口配置:请确认公网地址已包含默认端口内
18789。白名单放行:请检查轻量服务器防火墙或 ECS 安全组,确保已放行以下 IP对
18789端口的入方向访问:121.40.82.220, 47.97.73.42, 47.98.226.113, 47.96.151.112, 118.178.89.160, 120.27.202.100。策略检查:若上述配置无误,请排查云账户下的云防火墙或其他安全策略是否产生拦截。

报错:"Unsafe url:http://http"如何解决?

公网地址填写不正确,正确的公网地址应该是IP:端口,例如47.11.XX.XX:18789,不需要带上http/https的协议头。
报错:"param.empty"如何解决?
常见原因有以下两种
是钉钉AI卡片创建有问题, 在钉钉平台重新创建AI卡片, 不要使用任何预设模板,直接创建,也不要有任何修改,直接保存,然后更新连接流中钉钉节点的模板ID为最新的。
钉钉AI卡片未发布,请检查卡片发布状态,确保AI卡片已发布后重新运行。
报错:"unknown error"如何解决?
常见原因是钉钉AI卡片创建有问题, 在钉钉平台重新创建AI卡片, 不要使用任何预设模板,直接创建,也不要有任何修改,直接保存,然后更新连接流中钉钉节点的模板ID为最新的。
报错:Bad Request http response: Missing user message in "input"如何解决?
这个报错是因为没有给钉钉机器人输入信息,不要在AppFlow控制台点击"运行一次"进行测试,这样测试会产生错误,直接到钉钉群里@机器人进行问答测试。
报错:"code":"Forbidden.AccessDenied.AccessTokenPermissionDenied"如何解决?
钉钉开放平台机器人设置中缺少权限,参考钉钉机器人配置步骤:授予应用发送卡片消息权限中的 Card.Streaming.Write 和 Card.Instance.Write 是否已开通。
报错:"Connect to IP:18789 failed: connect timed out"如何解决?
进入AppFlow控制台,查看连接流,确认此处公网地址是否为轻量应用服务器的IP地址,IP和端口填写是否正确,如果IP地址和端口填写错误会报错超时。
报错提示“无效的 ClientId 或者 ClientSecret”,如何解决?
该报错表示您在 AppFlow 中配置的钉钉机器人凭据(AppKey 或 AppSecret) 不正确。请您前往钉钉开放平台重新获取凭据并更新配置。
登录钉钉开发者后台,找到对应的应用/机器人。

获取最新的 AppKey 和 AppSecret。

返回 AppFlow 界面,填入正确的凭据即可。
OpenClaw Token 变更,如何在 AppFlow 中修改?
访问 AppFlow 连接流管理控制台。
在左侧导航栏中选择连接凭证。
在凭证列表中单击Moltbot,选择对应的凭证名称,修改Token并保存。

报错:"Stream Input Node Run Timeout"如何解决?
建议您执行以下方法进行修复试试(注意:修复方法会清空历史会话文件,请评估后再决定是否操作):
备份并清理会话文件:
cp ~/.clawdbot/agents/main/sessions/sessions.json ~/.clawdbot/agents/main/sessions/sessions.json.backup清空会话文件(保留基本结构):
echo '{"sessions":{}}' > ~/.clawdbot/agents/main/sessions/sessions.json重启Gateway服务:
openclaw gateway restart钉钉机器人有响应,但只有“处理中”,不输出内容怎么解决?
先在Chat页面对话测试是否有正常响应,如果没有。
请检查OpenClaw的模型API Key是否正确。
如果API Key正确,则配置OpenClaw中执行命令重启OpenClaw服务。
连接流配置有误,如何修改连接流?
进入连接流列表,建议通过 Webhook URL 精准定位目标连接流。进入详情页调整配置并发布后,请在客户端(如钉钉)进行对话验证。
报错:Unauthorized http response: {"error": "message": "Unauthorized" "type": "unauthorized"}如何解决?
通常为设置的OpenClaw服务token不对,可以在轻量服务器控制台找到服务器应用,在应用详情查看token,参考以下截图步骤。

获取并复制保存token后, 访问AppFlow连接凭据管理页面,找到AppFlow工作流中配置的MoltBot凭证,更新token,单击确定保存后重新测试。








