💬 钉钉接入
👤 适合谁：使用钉钉办公的企业用户
⏱️ 阅读时长：约 5 分钟
💡 一句话：让 YingClaw 出现在你的钉钉里，企业内部 AI 助手随时待命。
将 YingClaw 接入钉钉，通过 Stream Mode WebSocket 实现实时消息收发，无需公网 IP 即可完成接入。
接入概览
YingClaw 通过钉钉开放平台的 Stream Mode 与钉钉网关建立 WebSocket 长连接，无需公网 IP 即可实现消息推送。
| 场景 | 说明 |
|---|---|
| 💼 企业内部助手 | 员工在钉钉中直接咨询 AI |
| 📋 工作流程自动化 | 审批、通知、数据查询一键完成 |
| 📢 定时推送 | 日报、周报定时发送到钉钉群 |
配置步骤
1. 获取钉钉应用凭证
前往 钉钉开放平台 创建企业内部应用，获取：
- Client ID：应用唯一标识
- Client Secret：应用密钥
2. 在 YingClaw 中配置
登录 YingClaw Web 控制台，进入「通信频道」页面，打开钉钉开关，填写配置：
| 参数 | 说明 |
|---|---|
client_id | 钉钉开放平台分配的 Client ID |
client_secret | 钉钉开放平台分配的 Client Secret |
allowed_users | 允许使用 Bot 的员工白名单，* 表示所有员工 |
3. 启动通道
保存配置后，YingClaw 自动通过 Stream Mode 连接钉钉网关。Stream Mode 无需配置回调地址，也无需公网 IP。
消息交互
私聊场景
员工直接向 Bot 发送消息，YingClaw 实时响应，支持：
- 💬 智能问答和对话
- 📊 数据查询和报表生成
- 📝 文档编写和编辑
- ⏰ 日程管理和提醒
群聊场景
将 Bot 添加到钉钉群后，群成员 @ Bot 即可触发响应。
白名单控制
channels:
dingtalk:
allowed_users:
- "manager001" # 仅允许特定员工
# - "*" # 允许所有员工
注意事项
- Stream Mode 无需公网 IP，适合内网部署环境
- 使用企业内部应用类型，数据不出企业范围
- 群聊场景建议配置 @ 触发以避免干扰