dingtalk-link

v1.0.0

钉钉机器人连接配置指南。用于安装、配置和排查 OpenClaw 钉钉连接器 (dingtalk-connector) 的问题。当用户需要连接钉钉机器人、配置 AppKey/AppSecret、或排查钉钉消息收发问题时使用。

⭐ 0· 133·0 current·0 all-time

by@chao980

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for chao980/dingtalk-link-smb.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "dingtalk-link" (chao980/dingtalk-link-smb) from ClawHub.
Skill page: https://clawhub.ai/chao980/dingtalk-link-smb
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install dingtalk-link-smb

ClawHub CLI

Package manager switcher

npx clawhub@latest install dingtalk-link-smb

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

Name and description match the content: the SKILL.md explains installing/configuring the dingtalk-connector, adding AppKey/AppSecret, restarting the gateway, and troubleshooting — all appropriate for a connector setup guide.

ℹ

Instruction Scope

Instructions stay within the connector setup/troubleshooting scope (install plugin, edit ~/.openclaw/openclaw.json, restart gateway, check logs). Minor inconsistency: the prerequisites list an 'OpenRouter API Key' but the guide does not explain where/how to provide it (no env var or CLI step shown).

✓

Install Mechanism

No install spec or code files are included in the skill bundle — it's instruction-only. The only install actions are user-directed CLI commands (openclaw plugins install, npm install -g) which are appropriate for a setup guide.

ℹ

Credentials

The skill does not request environment variables or credentials within the bundle. It does instruct the user to provide AppKey/AppSecret (correct for this purpose). The mention of an 'OpenRouter API Key' in prerequisites is plausible but not further justified or mapped to a config/env variable in the instructions.

✓

Persistence & Privilege

always is false and the skill is user-invocable only. There is no instruction to modify other skills' configs or system-wide settings beyond the connector's own OpenClaw config.

Assessment

This is a configuration guide, not executable code, and appears coherent for setting up a DingTalk connector. Before proceeding: (1) verify the plugin package name (@dingtalk-real-ai/dingtalk-connector) and GitHub repo to ensure you trust the publisher; (2) do not paste secrets into chat — enter AppKey/AppSecret only via the CLI or by editing your local ~/.openclaw/openclaw.json; (3) confirm where the 'OpenRouter API Key' should be stored in your environment or OpenClaw config if you use OpenRouter; (4) running npm install -g or plugin installs requires network and may require elevated privileges — perform those commands on a trusted machine; (5) back up your OpenClaw config before editing. If you want, I can check the referenced GitHub repo URL and the connector package name for authenticity before you install.

Like a lobster shell, security has layers — review code before you run it.

latestvk979e515y19y0k7x75pd3fvx6583k47j

133downloads

0stars

1versions

Updated 1mo ago

v1.0.0

MIT-0

钉钉机器人配置

配置 OpenClaw 与钉钉机器人连接，支持 AI Card 流式响应和会话管理。

前置要求

OpenClaw >= 2026.3.22（dingtalk-connector v0.8.6+ 必需）
钉钉企业账号
OpenRouter API Key

快速配置

1. 安装插件

openclaw plugins install @dingtalk-real-ai/dingtalk-connector

2. 创建钉钉应用

访问 https://open-dev.dingtalk.com/
应用开发 → 创建企业内部应用
添加应用能力 → 选择"机器人"
获取 AppKey 和 AppSecret（凭证与基础信息页面）
发布应用（版本管理与发布）

⚠️ 应用必须发布才能正常接收消息

3. 配置凭证

使用命令行配置：

openclaw channels add

选择 DingTalk，输入 AppKey 和 AppSecret。

或手动编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "你的AppKey",
      "clientSecret": "你的AppSecret"
    }
  }
}

4. 重启并验证

openclaw gateway restart
openclaw status

确认 DingTalk 状态为 ON / OK。

常见问题排查

机器人不回复

openclaw logs --follow

检查日志确认：

应用已发布
机器人模式为 Stream（非 Webhook）
AppKey/AppSecret 正确

版本不兼容错误

错误信息：Cannot find module '.../plugin-sdk/root-alias.cjs/channel-runtime'

原因：OpenClaw 版本过低

解决：

npm install -g openclaw@latest
openclaw gateway restart

HTTP 401 错误

检查 AppKey/AppSecret 是否正确（注意多余空格）
确认应用已发布

Stream 连接 400 错误

原因	解决方案
应用未发布	发布应用
凭证错误	检查 AppKey/AppSecret
非 Stream 模式	确认机器人配置为 Stream 模式
IP 白名单限制	检查应用是否设置了 IP 白名单

端口冲突

openclaw gateway stop
openclaw gateway start

进阶配置

异步模式（长时间任务）

{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "AppKey",
      "clientSecret": "AppSecret",
      "asyncMode": true,
      "ackText": "收到，处理中..."
    }
  }
}

会话配置

{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "AppKey",
      "clientSecret": "AppSecret",
      "separateSessionByConversation": true,
      "groupSessionScope": "group"
    }
  }
}

参考链接

插件文档：https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector
钉钉开放平台：https://open-dev.dingtalk.com/

Comments

Loading comments...