AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

OpenClaw应用镜像AppFlow故障排查

更新时间：
复制为 MD 格式
产品详情
我的收藏

配置了钉钉机器人，Appflow日志报错RobotCode如何处理?

出现RobotCode错误，常见的就是钉钉机器人配置流程有异常，配置过程中参数填写错误或者步骤操作不对，建议参考文档的配置步骤重新配置一下，注意配置步骤中填写的参数，不要填写错误。

AppFlow日志报错：“The provided parameter "input" is invalid.”如何解决？

image.png

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

AppFlow日志报错："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. 策略检查：若上述配置无误，请排查云账户下的云防火墙或其他安全策略是否产生拦截。

image.png

AppFlow日志报错："Unsafe url：http://http"如何解决？

image.png

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

AppFlow日志报错："param.empty"如何解决？

常见原因有以下两种：

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

  2. 钉钉AI卡片未发布，请检查卡片发布状态，确保AI卡片已发布后重新运行。

AppFlow日志报错："unknown error"如何解决？

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

AppFlow报错：Bad Request http response: Missing user message in "input"如何解决？

这个报错是因为没有给钉钉机器人输入信息，不要在AppFlow控制台点击"运行一次"进行测试，这样测试会产生错误，直接到钉钉群里@机器人进行问答测试。

AppFlow报错："code":"Forbidden.AccessDenied.AccessTokenPermissionDenied"如何解决？

钉钉开放平台机器人设置中缺少权限，参考钉钉机器人配置步骤：授予应用发送卡片消息权限中的 Card.Streaming.Write 和 Card.Instance.Write 是否已开通。

AppFlow报错："Connect to IP:18789 failed: connect timed out"如何解决？

进入AppFlow控制台，查看连接流，确认此处公网地址是否为轻量应用服务器的IP地址，IP和端口填写是否正确，如果IP地址和端口填写错误会报错超时。

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

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

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

    image

  2. 获取最新的 AppKey 和 AppSecret。

    image

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

OpenClaw Token 变更，如何在 AppFlow 中修改？

  1. 访问 AppFlow 连接流管理控制台。

  2. 在左侧导航栏中选择连接凭证。

  3. 在凭证列表中单击Moltbot，选择对应的凭证名称，修改Token并保存。

image

AppFlow报错："Stream Input Node Run Timeout"如何解决？

建议您执行以下方法进行修复试试（注意：修复方法会清空历史会话文件，请评估后再决定是否操作）：

  1. 备份并清理会话文件：

cp ~/.clawdbot/agents/main/sessions/sessions.json ~/.clawdbot/agents/main/sessions/sessions.json.backup

  1. 清空会话文件（保留基本结构）：

echo '{"sessions":{}}' > ~/.clawdbot/agents/main/sessions/sessions.json

  1. 重启Gateway服务：

openclaw gateway restart

AppFlow报错：Unauthorized http response: {"error": "message": "Unauthorized" "type": "unauthorized"}如何解决？

通常为设置的OpenClaw服务token不对，可以在轻量服务器控制台找到服务器应用，在应用详情查看token，参考以下截图步骤。

image

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

image

如何根据AppFlow的日志信息排查钉钉机器人出现的问题？

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