- A+
所属分类：解决方案
OpenClaw 安装钉钉频道插件完整教程
本教程记录在已有 OpenClaw 实例上安装和配置钉钉频道插件的完整步骤。
一、安装钉钉插件
1.1 执行安装命令
1.2 验证插件安装
期望看到：
如果显示 disabled，说明插件未启用，请检查配置。
1.3 重启网关
二、配置钉钉开发者应用
2.1 创建企业内部应用
- 访问 钉钉开发者后台
- 登录企业管理员账号
- 点击「创建应用」→「企业内部应用」
- 填写应用名称（如「OpenClaw助手」）、描述等
- 在「开发管理」→「机器人」中启用机器人能力
2.2 添加权限
在「权限管理」页面，搜索并添加以下权限：
- Card.Instance.Write
- Card.Streaming.Write
- im:message
2.3 发布应用
「版本管理与发布」→ 创建版本 → 填写版本号 → 提交审核（如需要）→ 发布
三、配置 OpenClaw 钉钉频道
3.1 编辑配置文件
打开 ~/.openclaw/openclaw.json（如果没有则创建），添加 channels.dingtalk 配置，完整示例如下：
- 注意：如果你安装的是 clawdbot-dingtalk，则配置节点为 clawdbot-dingtalk
- robotCode 通常与 clientId 相同
3.2 重启网关生效
四、在钉钉中使用机器人
4.1 群聊中使用
- 打开钉钉群 → 右上角「...」
- 选择「机器人」→「添加机器人」→ 选择你的应用
- 完成后，在群里发送 @你的机器人 你好
4.2 私聊（单聊）机器人
方式一：从群聊成员列表点击机器人头像 → 发消息
方式二：通讯录 → 我的企业 → 找到机器人应用 → 发消息
五、故障排查
5.1 插件未加载
确认 dingtalk 状态为 loaded。
5.2 配置文件语法错误
5.3 钉钉无响应
查看日志：
检查：
- 钉钉应用是否已发布
- 消息接收模式是否为 Stream 模式（不是 Webhook）
- clientId / clientSecret 是否正确
- 权限是否包含 Card.Streaming.Write
5.4 API 401/403
- 重新生成 clientSecret
- 在开发者后台确认应用状态为「已上线」
六、安全与维护
- 定期检查插件更新：openclaw plugins update
- 不要泄露 clientSecret，可配置环境变量：DINGTALK_CLIENT_SECRET
- 低配服务器注意内存使用：htop 或 free -h
- OpenClaw 日志位置：~/.openclaw/logs/ 或通过 journalctl 查看
教程完成。有问题欢迎反馈。🦊
