OpenClaw（原MoltBot、Clawbot）常见问题

钉钉机器人对话没有反应

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

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

   

   

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

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

   

3. 如果有执行日志，点击详情，查看报错信息，根据报错信息修正，例如api key错误等

钉钉有响应，但只有“处理中”，不输出内容

1. 先在Chat页面对话测试是否有正常响应，如果没有。

2. 请检查OpenClaw的模型API Key是否正确。

3. 如果API Key正确，则配置OpenClaw中执行命令重启OpenClaw服务。

连接流配置有误，如何修改连接流？

进入连接流列表，建议通过 Webhook URL 精准定位目标连接流。进入详情页调整配置并发布后，请在客户端（如钉钉）进行对话验证。

如何查看执行日志？

访问执行日志页面，可以点击详情，查看每个节点的输入、输出、错误日志信息

报错信息“The provided parameter "input" is invalid.”如何解决？

不要在控制台选择点击“运行一次”，直接到钉钉@机器人进行测试。

执行日志报错提示：ClawdBot Method Not Allowed http response: Method Not Allowed如何解决？

需要打开http配置选项

报错：Connect to xxxxxxxx failed: Connection refused (Connection refused)如何解决？

1. 端口配置：请确认公网地址已包含默认端口内18789。

2. 白名单放行：请检查轻量服务器防火墙或 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。

3. 策略检查：若上述配置无误，请排查云账户下的云防火墙或其他安全策略是否产生拦截。

报错Unsafe url：http://http如何解决？

公网地址填写不正确，正确的公网地址应该是IP:端口，例如47.11.XX.XX:18789，不需要带上http/https的协议头

报错： Unauthorized http response: ('error" ("message" "Unauthorized" "type" 'unauthorized")

常见原因是token配置错误导致。

1. 查看token：从轻量服务器控制台找到对应应用，在应用详情查看token。

   

2. 更新token配置： 访问AppFlow连接凭据管理页面，找到OpenClaw，点击编辑，重新修改token，然后单击保存，重新进行测试。

报错：钉钉最后节点报错unknown error

常见原因是钉钉AI卡片创建有问题， 在钉钉平台重新创建AI卡片， 不要使用任何预设模板，直接创建，也不要有任何修改，直接保存，然后更新连接流中钉钉节点的模板ID为最新的

构建钉钉员工时，是否支持使用个人钉钉账号？

不支持。该功能依赖于钉钉的企业级能力，无法使用个人账号直接操作。您需要先创建或加入一个钉钉组织（企业或团队）。

AppFlow中提示“无效的 ClientId 或者 ClientSecret”，如何解决？

该报错表示您在 AppFlow 中配置的钉钉机器人凭据（AppKey 或 AppSecret） 不正确。请您前往钉钉开放平台重新获取凭据并更新配置。

1. 登录钉钉开发者后台，找到对应的应用/机器人。

   

2. 获取最新的 AppKey 和 AppSecret。

   

3. 返回 AppFlow 界面，填入正确的凭据即可。

如何在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链接可进入Moltbot对话页面。

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

如何升级OpenClaw到最新版本？

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

2. 选择重置当前系统。

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

如何更换OpenClaw使用的模型？

1. 在服务器页面，单击服务器卡片中的实例ID，进入服务器概览页面。

2. 单击应用详情页签，在访问控制页面单击快速查看可进入OpenClaw对话页面。

3. 单击Config > Agents，搜索Primary Model，更改为你想用的模型。

   

OpenClaw如何配置其他模型服务商？

当前OpenClaw镜像默认已初始化阿里云百炼 (Bailian) Provider，可直接在设置中修改其使用的具体 Model。如果您需要接入 OpenAI、Anthropic、Google Gemini 或其他厂商的模型服务，请参考如下步骤进行配置。

1. 登录服务器终端，切换到 root 用户。

   sudo -i

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

   moltbot onboard

   

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

   

1. 核心管理工具：Moltbot

moltbot 是系统内置的核心 CLI。

查看已安装技能 (Skills)。

moltbot skills list

2. 技能市场工具：Molthub

molthub 是专属的技能市场管理工具，用于搜索、安装和管理第三方技能。目前镜像中已预装了 50+ 常用技能。

• 搜索技能（以 weather 为例）：

  molthub search weather

• 安装技能：

  molthub install weather

• 其他命令详见：

  molthub --help

3. 插件与通道管理：Plugins

通过 moltbot plugins 命令管理扩展插件。

查看插件命令帮助：获取安装、配置插件的完整指令列表。

moltbot plugins -h