https://github.com/soimy/openclaw-channel-dingtalk
Dingtalk channel plugin for OpenClaw
https://github.com/soimy/openclaw-channel-dingtalk
dingtalk openclaw openclaw-plugin
Last synced: 16 days ago
JSON representation
Dingtalk channel plugin for OpenClaw
- Host: GitHub
- URL: https://github.com/soimy/openclaw-channel-dingtalk
- Owner: soimy
- License: mit
- Created: 2026-01-27T07:17:48.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T08:40:32.000Z (about 2 months ago)
- Last Synced: 2026-04-02T08:43:18.150Z (about 2 months ago)
- Topics: dingtalk, openclaw, openclaw-plugin
- Language: TypeScript
- Homepage: https://soimy.github.io/openclaw-channel-dingtalk/
- Size: 2.41 MB
- Stars: 1,580
- Watchers: 9
- Forks: 212
- Open Issues: 57
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-openclaw-plugins - dingtalk - DingTalk (钉钉) enterprise bot with Stream mode, AI interactive cards. By [@soimy](https://github.com/soimy). `openclaw plugins install https://github.com/soimy/openclaw-channel-dingtalk.git` (Skills vs Plugins: What's the Difference? / Bundled Plugins)
- awesome-claw-cn - openclaw-channel-dingtalk
- awesome-openclaw - soimy/openclaw-channel-dingtalk - channel-dingtalk?style=social) - DingTalk channel plugin for OpenClaw. (🔌 Plugins & Channel Integrations)
- awesome-openclaw - soimy/openclaw-channel-dingtalk - DingTalk-Enterprise-Channel-Plugin mit Stream-Unterstuetzung.  (Plugins und Integrationen)
README
# DingTalk Channel for OpenClaw
针对 OpenClaw 的钉钉企业内部机器人 Channel 渠道插件，使用 Stream 模式，无需公网 IP。
## 功能特性
- Stream 模式，无需 Webhook 和公网入口
- 支持私聊、群聊和 @机器人
- 支持文本、图片、语音、视频、文件和钉钉文档/文件卡片
- 支持引用消息恢复和常见文本附件正文抽取
- 支持 Markdown 回复与 AI 卡片流式回复（v2 结构化 block 渲染、taskInfo 元数据、图片内联）
- 支持多 Agent、多机器人绑定和实验性的 `@多助手路由`
- 支持 `/btw` 旁路问答，绕过主会话锁立即获得独立快答
- 支持 DingTalk Device Flow 自动注册，扫码授权后自动获取凭证，无需手动复制
- 支持实时中止当前 AI generation。常用停止指令包括 `停止`、`stop`、`/stop`、`esc` 等
- 接入 OpenClaw 消息处理与 outbound 能力
> [!IMPORTANT]
> 根据钉钉开放平台公告《[关于限时开放钉钉PaaS资源不限量额度以助力企业AI智能体集成的公告](https://open.dingtalk.com/document/development/open-ai-paas-report)》（更新于 `2026-03-11`），OpenClaw 调用钉钉 `API/Webhook/Stream` 的免费“不限量”额度默认有效至 `2026-03-31`；如已通过官方申请通道获批，豁免权益最晚有效至 `2026-04-30`。部署前请前往“钉钉开发者后台 -> 资源管理”核对当前额度状态。
## 文档入口
- 线上文档站点：
- 用户文档入口：[docs/user/index.md](docs/user/index.md)
- 参与贡献入口：[docs/contributor/index.md](docs/contributor/index.md)
- 发布记录：[docs/releases/index.md](docs/releases/index.md)
- 英文入口：[docs/en/index.md](docs/en/index.md)
## 引用与署名
- GitHub / 机器可读引用元数据：[CITATION.cff](https://github.com/soimy/openclaw-channel-dingtalk/blob/main/CITATION.cff)
- 维护者对复用、引用与 AI 协作场景的署名请求：[docs/contributor/citation-and-attribution.md](docs/contributor/citation-and-attribution.md)
## 安装
> [!IMPORTANT]
> 最小兼容版本为 `OpenClaw 2026.3.24`。安装前请先升级到最新版 OpenClaw。
```bash
openclaw plugins install @soimy/dingtalk
```
### 本地开发或联调可使用源码链接安装
如需本地开发、调试或联调，可使用源码链接安装：
```bash
git clone https://github.com/soimy/openclaw-channel-dingtalk.git
cd openclaw-channel-dingtalk
npm install # 或 pnpm install
openclaw plugins install -l .
```
安装后建议显式配置 `plugins.allow`：
```json5
{
"plugins": {
"enabled": true,
"allow": ["dingtalk"]
}
}
```
详细说明：
- [安装指南](docs/user/getting-started/install.md)
## 更新
ClawHub 安装来源：
```bash
openclaw plugins update dingtalk
```
本地源码 / 链接安装来源：
```bash
git pull
openclaw gateway restart
```
详细说明：
- [更新指南](docs/user/getting-started/update.md)
## 配置
推荐优先使用交互式配置：
```bash
openclaw onboard
```
或：
```bash
openclaw configure --section channels
```
最小手动配置示例：
```json5
{
"plugins": {
"enabled": true,
"allow": ["dingtalk"]
},
"channels": {
"dingtalk": {
"enabled": true,
"clientId": "dingxxxxxx",
"clientSecret": "your-app-secret",
"dmPolicy": "open",
"groupPolicy": "open",
"messageType": "markdown"
}
}
}
```
详细说明：
- [配置指南](docs/user/getting-started/configure.md)
- [钉钉权限与凭证](docs/user/getting-started/permissions.md)
- [配置项参考](docs/user/reference/configuration.md)
## 重要功能文档
- [消息类型支持](docs/user/features/message-types.md)
- [回复模式](docs/user/features/reply-modes.md)
- [AI 卡片](docs/user/features/ai-card.md)
- [/btw 旁路问答](docs/user/features/btw.md)
- [钉钉文档 API](docs/user/features/dingtalk-docs-api.md)
- [反馈学习](docs/user/features/feedback-learning.md)
- [多 Agent 与多机器人绑定](docs/user/features/multi-agent-bindings.md)
- [@多助手路由](docs/user/features/at-agent-routing.md)
- [安全策略](docs/user/reference/security-policies.md)
- [API 消耗说明](docs/user/reference/api-usage-and-cost.md)
- [故障排查](docs/user/troubleshooting/index.md)
## 开发简述
```bash
git clone https://github.com/soimy/openclaw-channel-dingtalk.git
cd openclaw-channel-dingtalk
npm install
npm run type-check
npm run lint
pnpm test
```
更多开发与维护说明：
- [本地开发](docs/contributor/development.md)
- [测试与验证](docs/contributor/testing.md)
- [架构说明（中文详版）](docs/contributor/architecture.zh-CN.md)
- [NPM 发布](docs/contributor/npm-publish.md)
## 许可
[MIT](https://github.com/soimy/openclaw-channel-dingtalk/blob/main/LICENSE)