Octop v0.9.18 通过自定义 Connector 集成钉钉机器人实现消息推送:需先配置钉钉加签机器人获取 Webhook 和密钥,再在 connectors/ 下创建 dingtalk.yaml 定义 POST 请求,最后在 Agent Flow 中调用该 Connector 发送结构化消息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.18 本身不内置钉钉消息推送功能,但可通过其 Connector 机制与钉钉自定义机器人 Webhook 集成,实现消息主动推送。关键在于利用 Octop 的 HTTP 调用能力(如 HTTP Request Agent 或自定义 Connector),将结构化消息发送至钉钉机器人地址。
确认钉钉机器人已就绪
确保已在目标钉钉群中添加并配置好自定义机器人,获取到有效的 Webhook 地址(含 access_token)及对应安全策略(推荐启用加签)。若尚未配置,请按以下要点操作:
- 进入钉钉群 → 群设置 → 机器人 → 添加自定义机器人
- 命名机器人(如“Octop通知”),勾选“加签”并保存,复制生成的 Webhook URL
- 记录下加签所需的 timestamp 和 secret(后续需在 Octop 中参与签名计算)
在 Octop 中创建钉钉推送 Connector
Octop 支持通过 YAML 定义 Connector,用于封装外部服务调用逻辑。v0.9.18 版本中可在 connectors/ 目录下新增一个 dingtalk.yaml:
- 指定 method: POST,url: 为钉钉 Webhook 地址
- 设置 headers: Content-Type: application/json;若启用加签,需动态注入
timestamp和sign字段(可通过 Octop 的表达式语法或前置脚本生成) - body 使用 Markdown 或 text 类型结构,支持 @all 或指定手机号(需开启“@所有人”权限)
构建推送工作流(Agent Flow)
在 Octop 工作区中新建一个 Agent,选择触发方式(如定时、事件监听或手动执行),然后添加步骤:
- 使用 Set Variables 步骤准备消息内容(例如:{{input.title}} + {{input.content}})
- 调用上一步定义的
dingtalkConnector,传入拼装好的 payload - 可选:添加 Error Handler 捕获 HTTP 4xx/5xx 响应,记录失败原因
验证与调试建议
首次运行前建议做最小闭环测试:
- 用 curl 手动模拟一次加签请求,确认 Webhook 可正常接收
- 在 Octop 日志中查看 Connector 请求的原始 body 和响应 status
- 检查钉钉群是否收到消息;若无反应,重点排查 timestamp 是否过期(钉钉要求 30 分钟内)、sign 计算是否一致

















