{"_id":"@adongguo/openclaw-dingtalk","name":"@adongguo/openclaw-dingtalk","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@adongguo/openclaw-dingtalk","version":"0.1.1","type":"module","description":"OpenClaw DingTalk channel plugin","license":"MIT","repository":{"type":"git","url":"git+https://github.com/adongguo/openclaw-dingtalk.git"},"keywords":["openclaw","dingtalk","钉钉","chatbot","ai","claude"],"openclaw":{"extensions":["./index.ts"],"channel":{"id":"dingtalk","label":"DingTalk","selectionLabel":"DingTalk (钉钉)","docsPath":"/channels/dingtalk","docsLabel":"dingtalk","blurb":"钉钉/DingTalk enterprise messaging.","aliases":["dingding"],"order":70},"install":{"npmSpec":"@adongguo/openclaw-dingtalk","localPath":".","defaultChoice":"npm"}},"dependencies":{"dingtalk-stream":"^2.1.4","zod":"^4.3.6"},"devDependencies":{"@types/node":"^25.0.10","clawdbot":"2026.1.24-2","tsx":"^4.21.0","typescript":"^5.7.0"},"peerDependencies":{"clawdbot":">=2026.1.24"},"gitHead":"8127fc43a2381de1f4ce399c6996829d61929b89","_id":"@adongguo/openclaw-dingtalk@0.1.1","bugs":{"url":"https://github.com/adongguo/openclaw-dingtalk/issues"},"homepage":"https://github.com/adongguo/openclaw-dingtalk#readme","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-BT6Md9Imo+G6MyWuQMBkPyV1FhmBb7daN6ow9PWAt7Aq/zpvYSnsY7YIhGVVQbZ5MKGcKeQUp5JnWruHKzFwxg==","shasum":"0d4e330e30a1b64a9d2f1a10007bb23a694b0eaa","tarball":"https://registry.npmjs.org/@adongguo/openclaw-dingtalk/-/openclaw-dingtalk-0.1.1.tgz","fileCount":28,"unpackedSize":131913,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFj5HbK3WyK+HYfSWV3Ehl/EAsWeSKawQd1Z7N6Uv2eZAiBsBW71g8REbCQgyYVrsBpaOP/RfLPTcM7sRA2AHeyI3g=="}]},"_npmUser":{"name":"adongguo","email":"adongguo666@gmail.com"},"directories":{},"maintainers":[{"name":"adongguo","email":"adongguo666@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/openclaw-dingtalk_0.1.1_1769795382996_0.16771228323051135"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-30T17:49:42.941Z","0.1.1":"2026-01-30T17:49:43.170Z","modified":"2026-01-30T17:49:43.315Z"},"maintainers":[{"name":"adongguo","email":"adongguo666@gmail.com"}],"description":"OpenClaw DingTalk channel plugin","homepage":"https://github.com/adongguo/openclaw-dingtalk#readme","keywords":["openclaw","dingtalk","钉钉","chatbot","ai","claude"],"repository":{"type":"git","url":"git+https://github.com/adongguo/openclaw-dingtalk.git"},"bugs":{"url":"https://github.com/adongguo/openclaw-dingtalk/issues"},"license":"MIT","readme":"# openclaw-dingtalk\n\nDingTalk (钉钉) channel plugin for [OpenClaw](https://github.com/openclaw/openclaw).\n\n[English](#english) | [中文](#中文)\n\n---\n\n## English\n\n### Installation\n\n```bash\nopenclaw plugins install @adongguo/openclaw-dingtalk\n```\n\nOr install via npm:\n\n```bash\nnpm install @adongguo/openclaw-dingtalk\n```\n\n### Configuration\n\n1. Create an enterprise internal application on [DingTalk Open Platform](https://open-dev.dingtalk.com)\n2. Get your AppKey (ClientID) and AppSecret (ClientSecret) from the Credentials page\n3. Enable Robot capability and select **Stream mode**\n4. Configure event subscriptions (see below)\n5. Configure the plugin:\n\n#### Required Steps\n\n1. **Create Application**: Go to DingTalk Developer Console → Application Development → Enterprise Internal Development → Create Application\n\n2. **Enable Robot**: In your application, go to Application Capabilities → Robot → Enable Robot Configuration → Select **Stream mode**\n\n3. **Get Credentials**: Go to Basic Information → Application Information to get AppKey and AppSecret\n\n4. **Publish Application**: Publish the app (at least to test version) to make the bot available\n\n```bash\nopenclaw config set channels.dingtalk.appKey \"dingXXXXXXXX\"\nopenclaw config set channels.dingtalk.appSecret \"your_app_secret\"\nopenclaw config set channels.dingtalk.enabled true\n```\n\n### Configuration Options\n\n```yaml\nchannels:\n  dingtalk:\n    enabled: true\n    appKey: \"dingXXXXXXXX\"\n    appSecret: \"secret\"\n    # Robot code (optional, for media download)\n    robotCode: \"dingXXXXXXXX\"\n    # Connection mode: \"stream\" (recommended) or \"webhook\"\n    connectionMode: \"stream\"\n    # DM policy: \"pairing\" | \"open\" | \"allowlist\"\n    dmPolicy: \"pairing\"\n    # Group policy: \"open\" | \"allowlist\" | \"disabled\"\n    groupPolicy: \"allowlist\"\n    # Require @mention in groups\n    requireMention: true\n    # Max media size in MB (default: 30)\n    mediaMaxMb: 30\n    # Render mode for bot replies: \"auto\" | \"raw\" | \"card\"\n    renderMode: \"auto\"\n```\n\n#### Render Mode\n\n| Mode | Description |\n|------|-------------|\n| `auto` | (Default) Automatically detect: use ActionCard for messages with code blocks or tables, plain text otherwise. |\n| `raw` | Always send replies as plain text. Markdown tables are converted to ASCII. |\n| `card` | Always send replies as ActionCard with full markdown rendering. |\n\n### Features\n\n- Stream mode connection (WebSocket-based)\n- Direct messages and group chats\n- Message replies\n- Image and file support (via OpenAPI)\n- Pairing flow for DM approval\n- User and group directory lookup (config-based)\n- ActionCard render mode for markdown rendering\n\n### Limitations\n\n- **No message editing**: DingTalk doesn't support editing messages via sessionWebhook\n- **No reactions**: Bot API doesn't support message reactions\n- **sessionWebhook expiration**: Reply URLs are temporary and expire\n\n### FAQ\n\n#### Bot cannot receive messages\n\nCheck the following:\n1. Is Robot capability enabled in your application?\n2. Is **Stream mode** selected (not HTTP mode)?\n3. Is the application published?\n4. Are the appKey and appSecret correct?\n\n#### Failed to send messages\n\n1. Check if sessionWebhook has expired\n2. Verify message format is correct\n3. Ensure bot has necessary permissions\n\n#### How to clear history / start new conversation\n\nSend `/new` command in the chat.\n\n#### Why is the output not streaming\n\nDingTalk API has rate limits. Streaming updates can easily trigger throttling. We use complete-then-send approach for stability.\n\n#### Cannot find the bot in DingTalk\n\n1. Ensure the app is published (at least to test version)\n2. Search for the bot name in DingTalk search box\n3. Check if your account is in the app's availability scope\n\n---\n\n## 中文\n\n### 安装\n\n```bash\nopenclaw plugins install @adongguo/openclaw-dingtalk\n```\n\n或通过 npm 安装：\n\n```bash\nnpm install @adongguo/openclaw-dingtalk\n```\n\n### 配置\n\n1. 在 [钉钉开放平台](https://open-dev.dingtalk.com) 创建企业内部应用\n2. 在凭证页面获取 AppKey (ClientID) 和 AppSecret (ClientSecret)\n3. 开启机器人能力并选择 **Stream 模式**\n4. 配置事件订阅（见下方）\n5. 配置插件：\n\n#### 必需步骤\n\n1. **创建应用**：进入钉钉开发者后台 → 应用开发 → 企业内部开发 → 创建应用\n\n2. **开启机器人**：在应用页面，进入 应用功能 → 机器人 → 开启机器人配置 → 选择 **Stream 模式**\n\n3. **获取凭证**：进入 基础信息 → 应用信息，获取 AppKey 和 AppSecret\n\n4. **发布应用**：发布应用（至少发布到测试版本）使机器人可用\n\n```bash\nopenclaw config set channels.dingtalk.appKey \"dingXXXXXXXX\"\nopenclaw config set channels.dingtalk.appSecret \"your_app_secret\"\nopenclaw config set channels.dingtalk.enabled true\n```\n\n### 配置选项\n\n```yaml\nchannels:\n  dingtalk:\n    enabled: true\n    appKey: \"dingXXXXXXXX\"\n    appSecret: \"secret\"\n    # 机器人 code（可选，用于媒体下载）\n    robotCode: \"dingXXXXXXXX\"\n    # 连接模式: \"stream\" (推荐) 或 \"webhook\"\n    connectionMode: \"stream\"\n    # 私聊策略: \"pairing\" | \"open\" | \"allowlist\"\n    dmPolicy: \"pairing\"\n    # 群聊策略: \"open\" | \"allowlist\" | \"disabled\"\n    groupPolicy: \"allowlist\"\n    # 群聊是否需要 @机器人\n    requireMention: true\n    # 媒体文件最大大小 (MB, 默认 30)\n    mediaMaxMb: 30\n    # 回复渲染模式: \"auto\" | \"raw\" | \"card\"\n    renderMode: \"auto\"\n```\n\n#### 渲染模式\n\n| 模式 | 说明 |\n|------|------|\n| `auto` | （默认）自动检测：有代码块或表格时用 ActionCard，否则纯文本 |\n| `raw` | 始终纯文本，表格转为 ASCII |\n| `card` | 始终使用 ActionCard，支持完整 Markdown 渲染 |\n\n### 功能\n\n- Stream 模式连接（基于 WebSocket）\n- 私聊和群聊\n- 消息回复\n- 图片和文件支持（通过 OpenAPI）\n- 私聊配对审批流程\n- 用户和群组目录查询（基于配置）\n- ActionCard 渲染模式支持 Markdown 渲染\n\n### 限制\n\n- **不支持消息编辑**：钉钉不支持通过 sessionWebhook 编辑消息\n- **不支持表情回复**：机器人 API 不支持消息表情回复\n- **sessionWebhook 过期**：回复 URL 是临时的，会过期\n\n### 常见问题\n\n#### 机器人收不到消息\n\n检查以下配置：\n1. 是否在应用中开启了机器人能力？\n2. 是否选择了 **Stream 模式**（而非 HTTP 模式）？\n3. 应用是否已发布？\n4. appKey 和 appSecret 是否正确？\n\n#### 发送消息失败\n\n1. 检查 sessionWebhook 是否已过期\n2. 验证消息格式是否正确\n3. 确保机器人有必要的权限\n\n#### 如何清理历史会话 / 开启新对话\n\n在聊天中发送 `/new` 命令即可开启新对话。\n\n#### 消息为什么不是流式输出\n\n钉钉 API 有请求频率限制，流式更新消息很容易触发限流。当前采用完整回复后一次性发送的方式，以保证稳定性。\n\n#### 在钉钉里找不到机器人\n\n1. 确保应用已发布（至少发布到测试版本）\n2. 在钉钉搜索框中搜索机器人名称\n3. 检查应用可用范围是否包含你的账号\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-f6a1df4304d96de43324857962938bb1"}