核心用法
本 skill 提供 OpenClaw 钉钉通道的自动化安装与配置方案，解决钉钉与 OpenClaw 双向通信的集成难题。支持两种部署方式：一键安装脚本（推荐）和手动分步配置。用户只需提供钉钉应用的 Client ID 和 Client Secret，即可完成从插件安装、凭证配置到网关重启的全流程自动化。
核心功能包括：
- 智能脚本安装：
install_dingtalk.py支持 10+ 可选参数（robot-code、corp-id、agent-id、card-template-id 等），灵活适配个人应用、企业应用及卡片消息场景 - 双消息模式：支持 Markdown 富文本和 Interactive Card 交互卡片两种消息类型
- 细粒度权限控制：通过
dmPolicy/groupPolicy控制私聊/群聊权限，allowFrom实现白名单过滤 - 思考状态反馈：可配置
showThinking和thinkingMessage，提升交互体验
显著优点
1. 极低上手门槛：一条命令完成全套配置，无需手动编辑 JSON 配置文件
2. 企业级适配：支持 corpId、agentId 等企业应用必备参数，满足组织级部署需求
3. 安全合规前置：文档明确警示"切勿提交真实凭证到代码仓库"，引导安全实践
4. 完整故障排查：内置常见错误解决方案（插件重复警告、配置验证失败、消息发送失败等）
潜在局限
- 依赖外部生态：必须预先在钉钉开放平台创建应用并获取凭证，无法独立完成全流程
- 调试门槛较高：卡片模板需理解钉钉卡片 JSON 结构，对非技术人员不够友好
- 单点依赖风险：配置集中存储于
openclaw.json，误操作可能导致网关服务中断
适合人群
- DevOps/平台工程师：需要快速打通 IM 与 AI 工作流的技术团队
- 企业 IT 管理员：负责内部钉钉机器人部署与权限管控
- OpenClaw 生态用户：已使用 OpenClaw 框架、需要扩展钉钉渠道的场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **凭证泄露** | Client Secret 泄露可导致钉钉应用被恶意调用 | 使用环境变量或密钥管理服务注入，禁止硬编码 |
| **权限过度开放** | `allowFrom: ["*"]` 配合 `dmPolicy: open` 可能暴露于垃圾消息 | 生产环境建议配置具体用户白名单 |
| **网关服务中断** | 配置错误可能导致 OpenClaw Gateway 无法启动 | 修改前备份配置，使用 `--skip-restart` 验证后再重启 |