OpenClaw（原MoltBot、Clawbot）常见问题

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

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

2. 选择重置为其他镜像，选择版本Openclaw 2026.3.3。

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

警告

重置系统操作相当于重装系统，会清空系统盘内的所有数据（包括已保存的配置、日志和数据库）及停止轻量服务器中正在运行的业务程序。在执行操作前，请务必备份重要数据（建议创建快照或将数据导出到本地）。

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

重要

重置系统操作相当于重装系统，会清空系统盘内的所有数据（包括已保存的配置、日志和数据库）。在执行操作前，请务必备份重要数据（建议创建快照或将数据导出到本地）。

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

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

2. 选择重置当前系统。

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

如何查看OpenClaw的端口号？

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

如何使用AppFlow为钉钉/飞书/企业微信机器人配置定时任务？

如何更改AppFlow配置的定时任务的执行周期？

部署在轻量应用服务器上的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 或其他厂商的模型服务，请参考如下步骤进行配置。

1. 使用 admin 用户登录轻量应用服务器。

2. 更改模型提供商（以OpenRouter为例）。

    

   openclaw onboard

   

3. 验证修改。登录网页控制台，查看模型配置，可以看到增加的模型配置。

   

如何更改OpenClaw调用的模型？

如何在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。

如何重启OpenClaw Gateway 网关服务?

轻量服务器里安装的OpenClaw不同配置文件是做什么的？

• 配置文件目录：/root/.openclaw/

• 主配置文件：/root/.openclaw/openclaw.json（包含使用的模型）

• 模型api-key配置文件：/root/.openclaw/agents/main/agent/auth-profiles.json

可以直接修改配置文件，增加模型、增加api-key配置。

如何在OpenClaw中手动配置百炼购买的Coding Plan？

1. 复制并保存Coding Plan的套餐专属 API Key。

2. 将下面代码块中"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
         }
       }
     },

3. 在轻量应用服务器控制台-服务器页面，单击部署了OpenClaw的服务器卡片中的实例ID，进入服务器概览页面。

4. 单击应用详情页签，在访问控制页面单击打开网站页面右侧的执行命令后，单击弹窗中的网站地址URL链接可进入OpenClaw对话页面。

5. 单击Config > All Settings > Raw，打开配置文件。复制上述修改完"apiKey"参数的代码块，按照下图所示操作替换您的配置代码中的原"agents"{...}内容后保存修改。

轻量应用服务器终端中报错显示没有openclaw命令如何解决？

可以添加软连接，执行命令：

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

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

仅中国香港和海外地域轻量应用服务器实例可以配置Brave Search使用联网搜索功能。

OpenClaw 2026.2.3及以上版本应用镜像已默认内置基于SearXNG的联网搜索Skill。

1. 在Brave Search官网创建 Brave Search API 账户，并生成API密钥。

2. 在镜像中配置，进入 OpenClaw 页面，在左侧导航栏单击Config > All Settings > Raw，打开配置文件。将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服务器配置有要求吗，是否所有配置都可以选择OpenClaw镜像？

需选择2核2G及以上配置以保障服务性能。

购买部署OpenClaw应用镜像的轻量应用服务器实例后，使用实例时还会产生其他费用吗？

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

如何查询百炼中模型的免费额度还剩多少？

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

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

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

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

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

1. 检查API Key配置是否正确：远程连接至轻量应用服务器中，将配置的API Key及对应地域的Base URL替换进下方代码块，复制并粘贴至终端后测试模型调用。若返回报错信息，可在错误信息文档中搜索报错内容并根据方案处理。不同地域的 Base URL 不通用

    

   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（北京）： 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.dashscope.aliyuncs.com/v1

2. 检查模型服务是否欠费或限流情况。

1. 查看免费额度，登录后，在免费额度区域可查看到账户下该模型的剩余免费额度。

2. 查看账号欠费，可以访问费用与成本中心，确保账户没有欠费。

3. Coding plan：套餐存在每 5 小时、每周、每月的限额请求次数，您可以在Coding Plan 控制台查看套餐额度消耗情况。当超出限制时会报错hour/week/month allocated quota exceeded。

   解决办法：需等待额度自动恢复或升级至 Pro 套餐。

4. 按Token计费的百炼API Key：

3. 排查错误日志：前往OpenClaw Chat页面，在左侧导航栏单击Logs，并勾选WARN、ERROR查看错误日志，并在OpenClaw常见问题文档中搜索对应报错的解决方案。

   

   如果Logs日志无错误输出，可以远程连接至轻量应用服务器后，在终端中执行以下命令尝试重启网关服务。

    

   moltbot gateway restart

4. 重置镜像

   如果确认服务器里没有重要数据，可以考虑重置轻量应用服务器镜像，重置为最新的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" 怎么解决？

建议按以下步骤排查：

1. 重新生成 token：请登录阿里云轻量应用服务器控制台，找到实例进入应用详情页，重新生成新的 token。

2. 使用新 token 访问：将新 token 拼接到访问地址中，格式为 http://XXX:18789/?token= 新生成的token，并在无痕窗口中打开测试。

3. 确认服务运行状态：通过 SSH 登录服务器，确认OpenClaw服务正在运行且监听 18789 端口。

4. 检查安全组规则：确保轻量服务器的安全组已放行 18789 端口 的入方向流量（协议类型为 TCP）。

   若服务未正确绑定公网 IP 或反向代理配置错误，也可能导致 WebSocket 连接失败。建议优先通过本地 curl 或 telnet 测试 8.138.139.147:18789 是否可连通。

提示 "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。

钉钉机器人对话没有反应如何排查？

1. 首先查看AppFlow菜单，执行日志，是否有日志，如果没有日志，那么常见原因是钉钉应用没有发布最新版本导致，需要在钉钉机器人控制台页面，创建新版本并发布。

   不仅要发布机器人，还需要发布钉钉应用。

   

   

2. 检查消息接收地址URL是否正确。URL格式一定为https://xxxxx.appflow.aliyunnest.com/webhook/xxxxxxxxx。

   强烈建议自己拉群测试，不要使用钉钉提供的测试群进行测试。

   

3. 检查API Key配置是否正确：远程连接至轻量应用服务器中，将您配置的API Key及对应地域的Base URL替换进下方代码块，复制并粘贴至终端后测试模型调用。若返回报错信息，可在错误信息文档中搜索报错内容并根据方案处理。

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

2. 美国（弗吉尼亚）： https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions

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

4. Coding Plan套餐：https://coding.dashscope.aliyuncs.com/v1

5. 不同地域的 Base URL 不通用

    

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

4. 检查模型服务是否欠费或限流情况。

1. 查看免费额度，登录后，在免费额度区域可查看到账户下该模型的剩余免费额度。

2. 查看账号欠费，可以访问费用与成本中心，确保账户没有欠费。

3. Coding plan：套餐存在每 5 小时、每周、每月的限额请求次数，可以在Coding Plan 控制台查看套餐额度消耗情况。当超出限制时会报错hour/week/month allocated quota exceeded。

   解决办法：需等待额度自动恢复或升级至 Pro 套餐。

4. 按Token计费的百炼API Key：

5. 检查AppFlow连接流运行日志，第二个节点输出的text是不是为空，如果输出是空的，可能是OpenClaw不稳定，建议看看OpenClaw log进行分析或者重启下OpenClaw服务。

报错：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。

解决方法：

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确认相关端口是否已处于正常的监听状态。