镜像更新与重置问题
已购买的轻量应用服务器,如何部署OpenClaw镜像?
登录轻量应用控制台,选择对应实例单击重置系统。
选择重置为其他镜像,选择版本
Openclaw 2026.3.28。重新配置OpenClaw。重置后之前配置的API Key和Token都会失效,需要到应用详情里重新配置API Key。
重置系统操作相当于重装系统,会清空系统盘内的所有数据(包括已保存的配置、日志和数据库)及停止轻量服务器中正在运行的业务程序。在执行操作前,请务必备份重要数据(建议创建快照或将数据导出到本地)。
如何重置当前应用镜像至最新版本?
重置系统操作相当于重装系统,会清空系统盘内的所有数据(包括已保存的配置、日志和数据库)。在执行操作前,请务必备份重要数据(建议创建快照或将数据导出到本地)。
若当前镜像不是Openclaw 2026.3.28版本,希望体验最新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的端口号。
如何使用AppFlow为钉钉/飞书/企业微信机器人配置定时任务?
钉钉
访问定时调用OpenClaw并发送钉钉消息使用模板创建App连接流。
在用户授权区域,单击添加凭证添加OpenClaw的Token。
单击使用生成工具快速生成规则命令,以每小时重复任务为例,选择时页签,并选中每小时,单击确定后系统会按照设置自动生成cron表达式。单击验证cron和预览后5次执行时间,可预览验证cron表达式是否符合预期。
如果生成工具生成的频率无法满足需求,可参考Cron表达式的使用自行编写。
配置执行动作:
输入指令:填写想要定时执行的指令,如“帮我查询阿里云当前杭州地域下的ecs.g8i.large规格的抢占式实例市场价格”。
公网地址:端口:格式为
轻量应用服务器公网IP:服务端口,若公网IP为47.0.XX.XX,服务端口为18789(服务端口获取参考如何查询服务端口号),则应填写47.0.XX.XX:18789。Webhook地址:在已添加机器人的群聊中单击右上角,单击机器人管理中的OpenClaw机器人头像,复制机器人的Webhook并粘贴。
重要钉钉机器人的Webhook地址需要在PC端获取,暂不支持从移动端获取。
发布AppFlow。填写基本信息,并单击发布。流程发布后定时功能才会生效。
(可选)验证消息发送。单击去列表查看,找到刚创建的连接流,在操作列单击运行一次,可以触发一次运行并验证是否符合预期。
飞书
飞书机器人的Webhook地址需要在PC端获取,暂不支持从移动端获取。
访问定时调用OpenClaw并发送飞书消息使用模板创建App连接流。
在用户授权区域,单击添加凭证添加OpenClaw的Token。
单击使用生成工具快速生成规则命令,以每小时重复任务为例,选择时页签,并选中每小时,单击确定后系统会按照设置自动生成cron表达式。单击验证cron和预览后5次执行时间,可预览验证cron表达式是否符合预期。
如果生成工具生成的频率无法满足您的需求,可参考Cron表达式的使用自行编写。
配置执行动作:
输入指令:填写想要定时执行的指令,如“提醒我每小时定点喝水100ml”。
公网地址:端口:格式为
您的轻量应用服务器公网IP:服务端口,若公网IP为47.0.XX.XX,服务端口为18789(服务端口获取参考如何查看服务端口号),则应填写47.0.XX.XX:18789。Webhook地址:
单击群。
单击添加机器人,选择自定义机器人。填写机器人名称和描述,单击添加,复制Webhook地址并粘贴至AppFlow。
如果不想要所有ip地址都能访问webhook地址,可以单击IP白名单将
121.40.82.220, 47.97.73.42, 47.98.226.113, 47.96.151.112, 118.178.89.160, 120.27.202.100地址加入。
发布AppFlow。填写基本信息,并单击发布。流程发布后定时功能才会生效。
(可选)验证消息发送。单击去列表查看,找到刚创建的连接流,在操作列单击运行一次,可以触发一次运行并验证是否符合预期。
企业微信
点击群设置,打开消息推送,填写机器人名称和简介,复制Webhook地址,单击保存。
访问AppFlow链接用模板创建连接流。
在用户授权区域,单击添加凭证添加OpenClaw的Token。
单击使用生成工具,选择任务重复的频率。单击验证cron和预览后5次执行时间,验证cron表达式是否符合预期。
如果生成工具生成的频率无法满足您的需求可以参考Cron表达式的使用自行编写Cron表达式。
填写想要定时执行的指令和OpenClaw公网IP端口,并填写复制的机器人的Webhook地址。
发布AppFlow。填写基本信息,并发布。流程发布后定时功能才会生效。
验证消息发送。单击去列表查看,找到刚创建的连接流,单击运行一次,可以触发一次运行并验证是否符合预期。
如何更改AppFlow配置的定时任务的执行周期?
钉钉
可前往AppFlow控制台-连接流,找到定时调用任务连接流,单击连接流ID/名称,在右上角单击编辑,找到第一个触发事件节点,单击后在入参配置中可重新配置定时任务的cron表达式。编辑完成后单击发布即可完成更新。
飞书
可前往AppFlow控制台-连接流,找到定时调用任务连接流,单击连接流ID/名称,在右上角单击编辑,找到第一个触发事件节点,单击后在入参配置中可重新配置定时任务的cron表达式。编辑完成后单击发布即可完成更新。
企业微信
可前往AppFlow控制台-连接流,找到定时调用任务连接流,单击连接流ID/名称,在右上角单击编辑,找到第一个触发事件节点,单击后在入参配置中可重新配置定时任务的cron表达式。编辑完成后单击发布即可完成更新。
部署在轻量应用服务器上的OpenClaw,能否授权控制本地电脑的应用?
不支持。由于轻量应用服务器运行在云端网络环境,与本地电脑网络相互隔离,因此无法直接跨网络控制本地桌面的应用程序。
为什么OpenClaw应用镜像更新至最新版本仍无法使用联网搜索功能?
请前往轻量应用服务器控制台,在镜像信息模块查看并确保已更新至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用户登录轻量应用服务器。更改模型提供商(以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之前的版本
需要通过命令行终端手动完成重启操作:远程连接至轻量应用服务器,在终端用 Gateway 网关辅助命令:
openclaw gateway restart轻量服务器里安装的OpenClaw不同配置文件是做什么的?
配置文件目录:
/root/.openclaw/主配置文件:
/root/.openclaw/openclaw.json(包含使用的模型)模型api-key配置文件:
/root/.openclaw/agents/main/agent/auth-profiles.json
可以直接修改配置文件,增加模型、增加api-key配置。
OpenClaw如何配置Brave Search联网搜索功能?
仅中国香港和海外地域轻量应用服务器实例可以配置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中手动配置百炼购买的Coding Plan概述?
复制并保存Coding Plan的步骤二:获取套餐专属 API Key 和 Base URL。
将下面代码块中"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}}},在轻量应用服务器控制台-服务器页面,单击部署了OpenClaw的服务器卡片中的实例ID,进入服务器概览页面。
单击应用详情页签,在访问控制页面单击打开网站页面右侧的执行命令后,单击弹窗中的网站地址URL链接可进入OpenClaw对话页面。
单击,打开配置文件。复制上述修改完
"apiKey"参数的代码块,按照下图所示操作替换您的配置代码中的原"agents"{...}内容后保存修改。
购买OpenClaw服务器配置有要求吗,是否所有配置都可以选择OpenClaw镜像?
需选择2核2G及以上配置以保障服务性能。
购买部署OpenClaw应用镜像的轻量应用服务器实例后,使用实例时还会产生其他费用吗?
若为实例中的OpenClaw配置了百炼提供的 API Key进行模型调用,则会基于 token 用量产生费用,具体计费规则遵循百炼平台的模型调用计费说明。
如何查询百炼中模型的免费额度还剩多少?
登录百炼控制台后,在免费额度区域可查看到您账户下该模型的剩余免费额度。

如何查看阿里云百炼的模型调用记录?
模型调用完一小时后,在模型监控(北京或新加坡)页面设置查询条件(例如,选择时间范围、业务空间等),再在模型列表区域找到目标模型并单击操作列的监控,即可查看该模型的调用统计结果。具体请参见模型监控文档。
数据按小时更新,高峰期可能有小时级延迟,请您耐心等待。

百炼的中国内地(北京)、美国(弗吉尼亚)和国际(新加坡)地域有什么区别?
阿里云百炼提供中国内地(北京)、美国(弗吉尼亚)和国际(新加坡)地域的模型服务,选择邻近地域调用可降低网络延迟。不同地域的服务接入点(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/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日志无错误输出,可在控制台重启网关。
重置镜像
如果确认服务器里没有重要数据,可以考虑重置轻量应用服务器镜像,重置为最新的openclaw应用镜像,重新配置使用。
重要重置系统操作相当于重装系统,会清空系统盘内的所有数据(包括已保存的配置、日志和数据库)。在执行操作前,请务必备份重要数据(建议创建快照或将数据导出到本地)。
如何重启OpenClaw网关?
当遇到连接中断或服务不可用等场景时,可在控制台页面重启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:请登录阿里云轻量应用服务器控制台,找到实例进入应用详情页,重新生成新的 token。
使用新 token 访问:将新 token 拼接到访问地址中,格式为
http://XXX:18789/?token= 新生成的token,并在无痕窗口中打开测试。确认服务运行状态:通过 SSH 登录服务器,确认OpenClaw服务正在运行。
检查防火墙规则:确保轻量服务器的防火墙已放行监听端口的入方向流量(协议类型为 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 配置项中添加域名访问地址。
登录轻量应用服务器控制台。在服务器列表中,找到目标服务器卡片,单击卡片中的远程连接。在Workbench一键连接区域,单击立即登录。
在OpenClaw 的配置文件,找到
allowedOrigins字段,添加域名访问地址。"allowedOrigins": [ "http://47.**.**.59:15386", "http://openclaw-us.hewushui.cn:15386" ]请将上述示例替换为实际使用的协议 + 域名或 IP + 端口。
保存文件后,重启OpenClaw网关使配置生效。
OpenClaw Web UI打不开如何排查?
当无法正常打开OpenClaw Web UI页面时,请登录轻量应用服务器控制台逐一排查:
开放OpenClaw使用的端口:在服务器列表中,找到目标服务器卡片,单击管理 OpenClaw进入应用详情,在OpenClaw使用步骤区域的端口放通中单击一键放通。
若执行过重置镜像,还需重新初始化并获取新的WebUI地址。
检查配置文件是否被修改:返回服务器列表,找到目标服务器卡片,单击卡片中的远程连接。在Workbench一键连接区域,单击立即登录。执行:
openclaw doctor --fix该命令会自动移除
openclaw.json中不支持的字段(如allowlist)。修复完成后,重启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 地域不一致,或者对应业务空间/账号缺乏调用权限导致。
排查与解决方法:
排查一:检查 API Key 与地域配置是否一致
国内账号使用的百炼 API Key 通常属于北京地域,默认对应的也是北京地域的 Base URL。如果地域配置错位,将导致 401 错误。
控制台检查: 在轻量应用服务器控制台配置 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 或检查账户余额。
轻量应用服务器终端中报错显示没有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。
钉钉机器人对话没有反应如何排查?
检查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 2026.2.3及之前版本,或配置了AppFlow的连接流,还可按照以下步骤排查:
检查AppFlow连接流运行日志,第二个节点输出的text是不是为空,如果输出是空的,可能是OpenClaw不稳定,建议看看OpenClaw log进行分析或者重启下OpenClaw服务。
首先查看AppFlow菜单,执行日志,是否有日志,如果没有日志,那么常见原因是钉钉应用没有发布最新版本导致,需要在钉钉机器人控制台页面,创建新版本并发布。
不仅要发布机器人,还需要发布钉钉应用。
检查消息接收地址URL是否正确。URL格式一定为
https://xxxxx.appflow.aliyunnest.com/webhook/xxxxxxxxx。强烈建议自己拉群测试,不要使用钉钉提供的测试群进行测试。
机器人回答日期错误,不能准确识别当前最新日期如何解决?
可能是模型能力的原因,可尝试将模型更改为 qwen3.5-plus 模型。或者让Openlcaw执行date系统命令获取系统时间。
报错:ClawdBot Method Not Allowed http response: Method Not Allowed如何解决?
需要打开http配置选项

钉钉机器人有响应,但只有“处理中”,不输出内容怎么解决?
先在Chat页面对话测试是否有正常响应,如果没有。
请检查OpenClaw的模型API Key是否正确。
如果API Key正确,则配置OpenClaw中执行命令重启OpenClaw服务。
连接流配置有误,如何修改连接流?
进入连接流列表,建议通过 Webhook URL 精准定位目标连接流。进入详情页调整配置并发布后,请在客户端(如钉钉)进行对话验证。
AppFlow报错:Unauthorized http response: {"error": "message": "Unauthorized" "type": "unauthorized"}如何解决?
通常为设置的OpenClaw服务token不对,可以在轻量服务器控制台找到服务器应用,在应用详情查看token,参考以下截图步骤。

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

OpenClaw 端口 18789 监听在 127.0.0.1,外网无法访问怎么办?
OpenClaw 的 18789 端口监听地址显示为 127.0.0.1,导致无法通过外网访问该服务。
可能原因:OpenClaw 配置文件中的 bind 参数被更改。该参数默认配置为 lan(允许公网访问),如果被修改为 loopback 并重启了服务,端口就会仅监听本地回环地址 127.0.0.1。
解决方法:
登录服务器并检查配置。使用
admin用户登录轻量应用服务器,执行以下命令检查bind参数的当前配置:cat /home/admin/.openclaw/openclaw.json | grep bind修改配置文件。查看命令输出结果。如果发现配置为
"bind": "loopback",请编辑该配置文件,将其修改回默认的"lan"模式。重启 Gateway 服务。修改并保存配置文件后,执行以下命令重启 Gateway 服务,使配置生效:
openclaw gateway restart重启完成后,端口将恢复正常的监听状态,即可恢复外网访问。
执行 openclaw gateway restart (重启网关)命令报错,服务重启失败怎么办?
在尝试重启网关服务时,执行 openclaw gateway restart 命令出现报错,导致服务无法成功重启。
解决方法:当常规重启命令执行失败时,可以通过手动结束进程并重新启动服务来恢复。请按照以下步骤进行操作:
登录服务器。使用
admin用户登录轻量应用服务器。结束当前进程。执行以下命令,强制结束当前的 OpenClaw Gateway 进程:
killall openclaw-gateway重新启动服务。进程结束后,执行以下命令重新启动 Gateway 服务:
openclaw gateway start说明: 在执行启动命令时,系统如果输出报错提示,可暂时忽略。
验证服务状态。启动命令执行完成后,执行命令
ps aux | grep gate查看openclaw-gateway 进程是否已经成功拉起,并执行netstat -nltp确认相关端口是否已处于正常的监听状态。
轻量应用服务器经常宕机/内存满/OOM Killer触发怎么办?
升级实例配置
建议升级实例配置,将服务器配置升级至 2核2G及以上,以提升 OpenClaw 运行稳定性,降低因资源不足导致的服务器宕机、网站无法访问、内存占满等问题。检查并补充 Swap 分区
2026年2月26日之后的 OpenClaw 应用镜像已默认配置 Swap 分区;若实例是更早版本镜像,建议手动配置 Swap 分区,或直接重置当前应用镜像至最新版本,可在内存不足时提供缓冲,减少 OOM Killer 触发、服务异常中断等情况。
在 openclaw 中接入并使用阿里云百炼 MCP 服务
以网页解析 (WebParser) 服务为例,通过 mcporter 工具,完成整个接入和调用的流程。
步骤一:获取百炼 MCP 调用凭证
登录 阿里云百炼控制台。
在左侧导航栏或主页进入 MCP 广场,选择需要接入的服务(本例中为网页解析 WebParser)。
进入服务详情页,在下方外部调用,单击立即开通。
在接入方式中选择Cursor,复制服务凭证,选择一个API Key,单击确定。
步骤二:在 openclaw 中安装工具并配置服务
安装
mcporter工具向 openclaw 发送以下指令,它将自动安装工具:
执行 npm install -g mcporter 安装mcporter 工具。配置 MCP 服务
安装成功后,向 openclaw 发送指令,告诉它使用
mcporter来接入在步骤一中获取的服务凭证。使用 mcporter 工具,接入这个MCP服务,配置成openclaw可以自己调用的方式。 步骤一获取的配置内容
步骤三:调用并验证 MCP 服务
测试一下接入的 webparser 服务,让它抓取一个网页的标题。
向 openclaw 发送指令:
请使用 MCP 服务 webparser,抓取这个网站 https://help.aliyun.com/zh/model-studio/coding-plan 的标题内容。


