QoderWork 默认在桌面端完成对话和任务。但你的工作沟通大多发生在 IM 里——打开 IM 频道,QoderWork 就能接入你常用的聊天工具。走在路上、开会间隙,随手在 IM 里 @一下,AI 就能帮你跑任务、查数据、整理文档,结果直接回到当前聊天窗口。
桌面端依然是管控中心:所有 IM 会话在桌面端都有对应的会话窗口,你可以随时查看进度、接管操作,或调整 MCP、Skill、连接器等配置——这些配置对所有 IM 会话同样生效。
QoderWork 目前支持以下 IM 平台:
| 平台 | 接入方式 | 适用场景 |
|---|
| 钉钉 | 需先在钉钉开放平台创建机器人 | 企业团队协作 |
| 飞书 | 扫码自动创建应用 | 个人或团队快速接入 |
| 个人微信 | 扫码绑定,即开即用 | 移动端轻量交互 |
所有 IM 频道均在 IM 频道 页面统一管理。
工作原理
IM 集成遵循一个核心原则:哪里来的,回哪里去。
你在某个 IM 聊天窗口中发送的消息,QoderWork 处理完后,结果会自动回传到同一个聊天窗口。桌面端直接创建的任务,结果则留在桌面端,不会推送到任何 IM。每个 IM 会话在 QoderWork 桌面端映射为一个独立的会话窗口,上下文完全隔离——不同 IM 平台、不同聊天窗口之间互不干扰。你可以在桌面端查看所有 IM 会话的历史和状态,也可以在桌面端对应的会话窗口中继续操作,产出结果依然会同步回 IM。
支持的消息类型
在任意已连接的 IM 频道中,你可以发送以下类型的消息:
| 消息类型 | 说明 |
|---|
| 文本消息 | 直接发送文字指令 |
| 图片 | 发送图片,支持 OCR 识别、背景替换等处理 |
| 文件 | 支持 PDF、Excel、PPT、Word、CSV、TXT 等常见格式 |
| 语音消息 | 发送语音,自动识别内容并执行操作 |
| 合并转发消息 | 转发的多条消息会被正确解析 |
| 图片 + 文字组合 | 图片和文字指令关联理解,比如发一张图说「提取表格」 |
连续发送多条消息时,系统会按顺序依次处理,不会丢消息或乱序。
IM 频道和定时任务可以配合使用。创建定时任务时指定结果发送到某个 IM 会话,任务执行完毕后结果会自动推送到该聊天窗口。比如「每天早上 9 点生成数据日报,发送到钉钉群」。
准入策略
钉钉和飞书在配置时都支持设置准入策略,用于控制谁可以与机器人对话:
| 策略 | 说明 |
|---|
| 开放模式 | 所有人和群可直接与机器人对话,无需额外操作 |
| 配对模式 | 需经你允许后,对应会话才能使用机器人 |
开放模式适合团队内部快速推广使用;配对模式适合需要控制使用范围的场景,比如只允许特定人员使用。
配对模式下,用户私聊机器人或在群中 @机器人 时会自动触发配对请求。你可以在频道卡片的「配对管理」中点击 允许 来通过请求。配对以会话为单位:私聊允许后该用户可对话,群聊允许后群内所有成员均可对话。
接入微信
扫码即可完成绑定,无需额外配置。
打开微信配置页面
在 QoderWork 中进入 IM 频道,找到「微信」卡片,点击 配置。
扫码授权
页面会显示一个二维码。打开微信,扫描二维码并确认授权。
开始使用
绑定完成后,等待状态变为「已连接」,在微信中直接向 QoderWork 发送消息即可开始对话。
接入钉钉
钉钉集成需要先在钉钉开放平台创建一个机器人应用,获取凭证后再回到 QoderWork 完成配置。
创建钉钉机器人
本节详细介绍如何在钉钉开放平台创建机器人应用。如果你已经有现成的钉钉机器人,可以跳过直接在 QoderWork 进行配置。
第一步:创建应用
登录开发者后台
打开浏览器,访问 钉钉开放平台,使用管理员账号登录。如果你不是企业管理员,需要联系管理员授予你应用开发权限,或由管理员代为创建。
创建应用
在开发者后台,点击应用开发,并点击创建应用,填写应用基本信息:
- 应用名称:给应用起一个名字,比如「QoderWork 助手」
- 应用描述:简单描述用途即可
点击 保存 完成创建。 添加机器人能力
应用创建后,进入应用页面,找到 机器人 选项并点击添加。填写机器人名称等必填项,最后单击发布即可。在配置机器人信息时,选择消息接收模式为 Stream 模式。
第二步:配置权限
为了让机器人正常收发消息,需要开通以下 API 权限:
进入权限管理
在应用详情页左侧菜单中,点击 权限管理。
搜索并开通权限
在搜索框中依次搜索以下权限标识,逐一点击 立即开通:
Card.Streaming.Write — 流式卡片写入
Card.Instance.Write — 卡片实例写入
qyapi_robot_sendmsg — 机器人发送消息
第三步:发布应用
应用必须发布后才能在钉钉中搜索和使用。
创建版本
在应用页面左侧找到「版本管理与发布」,点击 创建新版本。
填写版本信息并发布
填写版本号和更新说明,点击 确认发布 提交。审批完成后,机器人即可在钉钉中被搜索和使用。拿到 Client ID 和 Client Secret 后,回到 QoderWork 继续配置钉钉。
第四步:获取凭证
在应用详情页左侧菜单中,点击 凭证与基础信息,找到以下两个字段:
| 字段 | 说明 |
|---|
| Client ID(原 AppKey) | 应用唯一标识 |
| Client Secret(原 AppSecret) | 应用密钥 |
将 Client ID 和 Client Secret 复制保存,后续在 QoderWork 中填写。
Client Secret 是应用的密钥凭证,请妥善保管,不要泄露给无关人员或提交到代码仓库。
在 QoderWork 中配置
如果你还没有钉钉机器人,请先参考创建钉钉机器人章节完成创建,拿到 Client ID 和 Client Secret 后再继续以下步骤。
进入钉钉配置页面
在 QoderWork 中进入 IM 频道,找到「钉钉」卡片,点击 配置。
填写凭证
在弹出的「配置钉钉」面板中填入从钉钉开放平台获取的凭证:
- Client ID(即 AppKey)
- Client Secret(即 AppSecret)
选择准入策略
选择准入策略:
- 开放模式:所有人 / 群可直接对话
- 配对模式:需经你允许后,对应会话才能使用机器人
完成配置
回到 QoderWork,确认钉钉状态显示为「已连接」。现在可以在钉钉中使用机器人了。
使用方式
单聊:在钉钉顶部搜索框中搜索机器人名称,点击进入对话窗口,直接发送消息。
群聊:将机器人添加到群聊后,在群里 @机器人 发送消息。添加方式:点击群设置(右上角) → 机器人 → 添加机器人 → 搜索并选择你创建的机器人。
群聊的「归属组织」需要与创建机器人时的组织一致,否则搜索不到机器人。
接入飞书
在 QoderWork 中配置
打开飞书配置页面
在 QoderWork 中进入 IM 频道,找到「飞书」卡片,点击 配置。
扫码授权
页面上方会显示一个二维码。打开飞书 App,扫描二维码并确认授权。系统会自动在你的飞书组织下创建应用,并配置好所需的权限和事件回调。
完成配置
回到 QoderWork,确认飞书状态显示为「已连接」。现在可以在飞书中使用机器人了。
使用方式
单聊:在飞书搜索框中搜索机器人名称,点击进入对话窗口。
群聊:将机器人添加到群聊中,@机器人 发送消息。
管理 IM 频道
所有 IM 频道的配置和状态均在 IM 频道 页面集中管理。
开启与关闭
每个频道卡片上都有一个开关。打开开关后状态显示为「已连接」,IM 端即可正常使用;关闭后 IM 端发送消息将不再收到回复。关闭不会清除配置,重新打开即可恢复。
删除频道
如果需要彻底移除某个频道的配置,点击频道卡片上的 移除配置。移除后该频道的所有配置信息将被清除,IM 端不再响应。如需启用,需要重新配置。
切换准入策略
钉钉和飞书频道支持在开放模式和配对模式之间随时切换:
- 从开放切换到配对:切换后,之前未配对的用户将无法继续使用,需要重新触发配对请求并获得允许。
- 从配对切换到开放:切换后,所有用户可直接使用,无需配对。
多频道并行
可以同时开启所有 IM 频道。各频道之间完全独立,互不干扰——钉钉、飞书、微信的会话各自拥有独立的上下文和历史记录。
典型场景
移动端轻量对话
在 IM 中直接向机器人提问,适合简单的问答和快速查询:
机器人会调用已配置的 MCP 工具和数据源,在 IM 中直接回复结果。
图片和文件处理
手机上收到或拍摄的图片、文件,直接发给机器人就能处理:
(发送一份 PDF 合同)审核一下这份合同,重点看违约责任条款的风险点
支持 OCR 文字识别、背景替换、票据信息提取、文件摘要、格式转换、数据分析等处理能力。
远程派活
人在外面,临时想让电脑上的 QoderWork 干活:
帮我把桌面上的「Q1 销售数据.xlsx」整理成一份分析报告,
包含销售趋势、客户分布和环比变化,保存为 PDF 到桌面。
QoderWork 在后台执行,完成后将结果摘要和文件自动回传到 IM 会话。
定时任务结果推送
配合定时任务使用,让执行结果自动推送到 IM:
帮我创建一个定时任务:每天早上 9 点生成昨日运营数据摘要,
完成后将结果发送到钉钉「运营日报」群。
群聊协作
在团队群聊中 @机器人,所有群成员都能使用:
@QoderWork 帮我总结一下今天群里讨论的要点