OpenClaw接入钉钉全场景踩坑解决方案：从无响应到报错全搞定

检查并发布钉钉应用（关键步骤）：

• 登录钉钉开放平台，进入目标应用的“版本管理与发布”；
• 点击“创建新版本”，填写版本号（如1.0.1）和描述（如“测试OpenClaw连接”）；
• 选择可见范围（测试阶段选“仅自己可见”），点击“保存→直接发布”，等待5-10秒生效。

核对消息接收地址URL：

• 若用AppFlow对接（推荐）：URL格式必须为https://xxxxx.appflow.aliyunnest.com/webhook/xxxxxxxxx（从AppFlow连接流详情页复制，勿手动修改）；
• 若用直连模式：URL格式为http://公网IP:18789/wecom（替换为服务器公网IP，端口固定18789，勿加https）。

自建测试群，避免默认测试群：

• 在钉钉手动创建1个新群（仅添加自己和机器人），进入“群设置→群机器人→添加机器人”，选择目标OpenClaw应用；
• 在新群@机器人发送“你好”，测试是否有响应（默认测试群可能屏蔽第三方机器人消息）。

检查AppFlow连接流配置：

• 访问阿里云AppFlow工作台，通过“Webhook URL”搜索定位目标连接流；
• 进入“详情页”，确认“OpenClaw凭证”（Token）、“钉钉Client ID/Secret”、“公网地址（IP:18789）”均正确；
• 点击“发布”，重新进入钉钉测试。

验证并更新大模型API Key：

• 打开OpenClaw Web UI（http://公网IP:8080），进入“Settings→Config→Authentication→Raw”；
• 找到models.providers节点（如豆包/阿里云百炼），核对apiKey是否与平台一致（从大模型平台后台重新复制，避免空格/字符缺失）；
• 修改后点击“Save→Update”，保存配置。

重启OpenClaw网关：

• 登录服务器终端，执行命令：openclaw gateway restart
• 等待10秒后，执行openclaw gateway status，确认状态为running。

修正连接流模型配置：

• 进入AppFlow连接流详情页，在“执行动作配置”中修改“模型名称”；
• 正确格式为alibaba-cloud/模型Code（如alibaba-cloud/qwen3-max-2026-01-23，勿直接填qwen3-max）；
• 模型Code可在阿里云百炼模型广场查询，选择“支持流式调用”的版本。

找到并编辑monitor.ts文件：

• 路径（Windows）：C:\\Users\\你的用户名\\.openclaw\\extensions\\dingtalk\\src\\monitor.ts；
• 路径（macOS/Linux）：~/.openclaw/extensions/dingtalk/src/monitor.ts。

修改handleDingTalkWebhookRequest函数开头：

• 在函数最顶部添加“仅处理钉钉专属请求”的判断（其余代码不变）：export async function handleDingTalkWebhookRequest(
  req: import('node:http').IncomingMessage,
  res: import('node:http').ServerResponse
  ): Promise<boolean> {
  // 仅处理钉钉专属路径的POST请求，放行其他请求（如Web UI）
  const url = req.url || '';
  const isDingTalkPath = url.includes('/dingtalk') || url.includes('/webhook');
  if (req.method !== 'POST' || !isDingTalkPath) {
  return false;
  }
  // 以下为原有代码，无需修改
  console.log(`[dingtalk] HTTP request received: ${req.method} ${req.url}`);
  // …
  }

重启网关生效：

openclaw gateway restart

修正公网地址格式：

• 正确格式：公网IP:18789（如47.11.XX.XX:18789），勿加http/https协议头；
• 在AppFlow连接流、钉钉机器人配置中，统一更新为公网地址。

配置服务器安全组（阿里云为例）：

• 登录阿里云轻量应用服务器控制台，进入目标实例的“防火墙”；
• 点击“添加规则”，按以下配置：
  • 端口范围：18789；
  • 授权对象：添加钉钉官方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；
  • 备注：OpenClaw钉钉连接，保存规则。

排查云防火墙拦截：

• 若开启阿里云“云防火墙”，进入“访问控制→入站规则”，确认上述IP和18789端口已放行；
• 临时关闭云防火墙测试（若恢复正常，说明规则需调整）。

禁止使用“运行一次”，直接在钉钉测试：

• 关闭AppFlow“运行一次”页面，直接在自建测试群@机器人发送消息（如“你好”），触发真实请求；
• 若仍报错，进入连接流详情页，检查“输入参数”是否完整（如“公网地址”“模板ID”是否填写）。

核对连接流关键参数：

• 公网地址：必须带18789端口（如47.11.XX.XX:18789）；
• 模板ID：从钉钉“卡片平台”新建空白AI卡片（勿用预设模板），复制模板ID填入；
• 模型名称：格式为alibaba-cloud/模型Code（如alibaba-cloud/qwen3-max-preview）。

打开OpenClaw Gateway HTTP配置：

• 访问Web UI，进入“Settings→Config→Gateway”；
• 找到“Gateway Server Settings”，启用“HTTP Methods Support”（勾选GET、POST）；
• 若使用大模型流式调用，启用“OpenAI Chat Completions Endpoint”。

保存并重启网关：

• 点击“Save”保存配置，执行命令重启：openclaw gateway restart

重新创建空白AI卡片：

• 登录钉钉开放平台，进入“卡片平台→新建模板”；
• 配置：卡片类型选“消息卡片”，场景选“AI卡片”，关联目标应用；
• 关键：勿使用任何预设模板，直接点击“保存→发布”，不做任何自定义修改。

更新连接流模板ID：

• 复制新创建的AI卡片“模板ID”；
• 进入AppFlow连接流详情页，在“执行动作配置”中替换“模板ID”；
• 点击“发布”，重新在钉钉测试。

第一步：查执行日志（所有问题的起点）

• 访问阿里云AppFlow→“执行日志”，筛选目标连接流：
  • 无日志：优先查“应用发布”“URL配置”“测试群”（对应场景1）；
  • 有日志：看报错关键词（如Connection refused→场景4，input invalid→场景5）。

第二步：核对接入核心要素

• 凭证：钉钉Client ID/Secret、OpenClaw Token、大模型API Key是否正确；
• 网络：公网地址格式（IP:18789）、18789端口放行、钉钉IP白名单；
• 模式：AppFlow对接需用“HTTP模式”（Stream模式不支持），直连可用Stream模式。

第三步：重启验证

• 若配置无明显错误，执行以下命令重启关键服务：# 重启OpenClaw网关
  openclaw gateway restart
  # 重启钉钉插件（可选）
  openclaw plugins reload dingtalk