Skip to main content
工作管理

@Waker

配置 IM 连接,把单聊或群聊接入 Waker,并管理路由、申请和专家。

@Waker 把 IM 里的真实讨论直接变成可持续执行的任务:成员不必复制聊天记录或反复解释背景,只需在原聊天中提出工作,系统会结合上下文选择合适的 Waker,持续返回进度、结果和文件。群里只需要一个统一机器人,背后可以按职责路由到多位 Waker。 适合先在研发协作、客户答疑、故障处理或内容运营等已有明确讨论上下文的聊天中试用。涉及合并、发布、生产变更或外部发送时,让 Waker 先返回方案和风险,等待人工确认后再执行。
新版 @Waker 聊天管理页

准备 Waker

  • 至少有一个已启用且可执行任务的 Waker。
  • 多个 Waker 的名称和职责应容易区分,例如项目协调、研发执行和测试验收。
  • 确认每个 Waker 可以访问正确的项目、目录、Skills 和连接器。
  • 在普通对话中分别完成一次小范围验证。

配置 IM 连接

入口: 左侧导航 →「@Waker」→「IM 连接管理」。 新版 @Waker 首页提供三个管理入口:
  • 开通 @Waker: 主动选择 IM 聊天并配置 Waker。
  • IM 连接管理: 安装、授权和维护消息接入身份。
  • 待处理申请: 审批从群聊或单聊发起的聊天接入请求。
页面只显示当前区域、账号和版本可用的连接类型。常见类型包括:
连接类型用途@Waker 支持
钉钉机器人在钉钉群聊或机器人单聊中接收和回复消息支持
钉钉用户使用已登录用户身份接收群聊和单聊消息支持
飞书机器人在飞书聊天中接收和回复消息页面提供时支持
其他连接用于基础消息接入或由当前版本提供的特定能力以页面标记为准
在 @Waker 中统一管理当前版本可用的 IM 连接
  1. 选择连接类型,点击添加或配置。
  2. 按页面填写平台应用或机器人凭据,完成授权或扫码。以钉钉机器人为例,需要先创建机器人、把消息接收模式设为 Stream,并按页面提示调整安全设置;需要单聊时还要在开放平台开启单聊权限。
  3. 如需读取群聊上下文或把文档、图片和表格发回群中,按页面提示安装 DWS,并使用当前钉钉账号完成聊天与文件权限授权。
  4. 设置接入范围。使用“配对后使用”时,新聊天必须先申请并由管理员批准;允许范围应从测试账号或测试群开始。
  5. 选择回复样式。普通卡片在任务结束后一次性发送;AI 卡片会在生成过程中更新内容,使用前确认开放平台的网络白名单要求。
  6. 保存后确认状态为已连接或可用,再在测试聊天发送消息检查收发。
按照产品向导配置钉钉机器人和消息接收方式
连接名称应能区分平台、用途和环境,例如“钉钉机器人-客服测试”。同一平台配置多个身份时,先确认哪个身份负责接收消息,避免多个连接同时回复同一聊天。 凭据只填写在受保护的配置入口,不得写入 Waker 简介、知识库、记忆、任务描述或截图。

先理解开通后的四个对象

  • IM 连接: 实际接收和发送消息的机器人或用户账号。删除连接会立即停止收发,依赖它的聊天会变为失效。
  • IM 聊天: 允许使用 @Waker 的单聊或群聊。授权范围按聊天隔离,不等于机器人所在的所有群都自动可用。
  • 处理该聊天任务的 Waker: 负责执行从该聊天发起的任务。
  • 觉醒模式: 决定该聊天是普通 IM 连接,还是启用任务认领、智能路由、任务记录、话题和记忆沉淀的完整 @Waker 模式。
开通前先把每位 Waker 的名称和职责写清楚。职责边界重叠时,相似任务可能被路由给不同 Waker;配置两位以上 Waker 后应运行「职责冲突检测」,按建议调整职责或保存自定义路由规则。

开通并配置 @Waker

完整配置链路是:先让 IM 连接处于可用状态,再建立聊天配对,然后配置 Waker,最后开启觉醒模式并验证。点击「开通 @Waker」后,向导会依次显示“选择 IM 连接”“接入聊天”“配置 Waker”。如果第一步提示“暂无可用 IM 连接”,先返回「IM 连接管理」完成连接。 建立聊天配对有两种主要方式:已经能搜索到目标聊天时,直接通过搜索开通;目标聊天尚未出现在搜索结果中时,先在 IM 中发消息生成申请,再由管理员审批。两种方式最终都会进入同一套 Waker 配置。

方式一:搜索聊天并直接开通

适合管理员已经知道目标单聊或群聊,且当前 IM 连接具备聊天搜索能力的情况。
  1. 在 @Waker 首页点击「开通 @Waker」,选择负责收发消息的 IM 连接,进入下一步。
  2. 选择「单聊」或「群聊」,接入方式选择「搜索聊天」。群聊配对前,先把机器人加入目标群。
  3. 输入聊天名称、成员姓名或页面要求的聊天 ID,执行搜索并选中目标聊天。不同渠道的搜索条件不同;飞书可能需要先完成用户授权,钉钉可能需要 DWS 已安装并登录。
在当前开通向导中选择聊天类型,并通过搜索或发消息完成接入
  1. 选择一位或多位 Waker,并指定一位默认 Waker。没有明确匹配时,由默认 Waker 接单或澄清。
  2. 逐个检查响应模型、工作目录、文件访问范围和其他权限。多个 Waker 不应同时写同一目录中的同一文件。
  3. 开启「觉醒模式」,确认向导中的 IM 连接、聊天和 Waker 均已完成,再保存开通。
搜索不到目标聊天时,不要反复新建连接。先确认机器人已经加入群、连接状态正常以及搜索授权可用;仍无法搜索时,改用“发消息配对”。

方式二:发消息后审批配对申请

适合目标聊天还没有被 QoderWake 发现,或不便由管理员搜索的情况。发消息只会创建待处理申请,不会自动授权该聊天使用 Waker。
  1. 确认 IM 连接可用。群聊先加入机器人;单聊直接打开机器人聊天。
  2. 单聊中向机器人发送任意消息;群聊中必须 @ 机器人并发送消息。系统据此记录聊天身份和申请人。
  3. 管理员返回 @Waker 首页,打开「待处理申请」。可按接入来源和聊天类型筛选申请。
  4. 核对聊天名称、申请人和 IM 连接,选择要允许的申请。来源无法确认时不要批准。
  5. 为该聊天选择 Waker 和默认 Waker,检查模型、工作目录和权限,开启「觉醒模式」后允许申请。
  6. 回到原单聊或群聊重新发送一条验证任务。群聊仍需 @ 同一个机器人。
通过 IM 发消息创建申请,再回到 QoderWake 审批配对

配对码(页面提供时)

部分渠道还会提供配对码作为补充方式。选择 Waker 后,系统生成有效期通常为 10 分钟的配对消息;将完整消息发送到目标群并 @ 机器人,或直接发送到机器人单聊。完成后回到 @Waker 列表核对聊天、Waker 和启用状态。配对码不要发到无关群组或长期保存。

开通后立即验证

聊天会出现在「已开通的 @Waker」表格或卡片视图中。先确认 IM 连接、Waker、默认 Waker、工作目录、模型、觉醒模式和启用状态,再在同一测试聊天发送两条任务:一条职责明确,应该路由到对应 Waker;一条职责模糊,应该交给默认 Waker 或请求补充信息。

配置 Waker 高级选项

每位 Waker 都可以有独立配置。保存前逐项确认:
选项建议
响应模型为该 Waker 选择稳定可用的默认模型;Auto 会跟随当前推荐配置
允许在 IM 中修改模型默认关闭;只在成员理解模型能力、额度和数据边界时开启
工作目录或项目只授予完成该职责所需的范围;多人协作时避免同时修改同一文件
文件与工具权限从只读和最小权限开始,外发、删除和生产写入保留人工确认
允许 QoderWake 管理操作默认关闭;仅为受信成员和明确的管理场景开启
设为默认 Waker只设置一位,用于接收职责不明确的请求或发起澄清
开启「允许在 IM 中修改模型」后,成员可以在任务消息中明确写“本次使用页面可用的某模型”。该选择只作用于本次任务;未指定、名称不可用或配置不允许时,仍使用该 Waker 的默认模型。选择不同模型会产生对应模型的额度消耗,正式群上线前应先在测试聊天验证。 「允许 QoderWake 管理操作」属于高风险权限。开启后,Waker 可以按请求创建自主工作,或管理 Waker、Skill 和 MCP 等 QoderWake 资源;涉及权限变化、凭据、删除和其他受保护动作时仍应经过产品授权与人工确认。普通研发、答疑或内容群通常不需要开启。

什么是觉醒模式

觉醒模式让一个普通 IM 聊天变成可以持续推进工作的 @Waker 聊天。开启后,@Waker 会识别成员意图,把任务交给合适的 Waker,记录后续补充与执行结果,并在聊天内沉淀话题和记忆。成员仍然只需要面对同一个机器人,不必了解后台分工。 如果聊天只用于简单收发消息、固定问答或始终由同一位 Waker 处理,可以关闭觉醒模式;需要多 Waker 分工、连续跟进和上下文沉淀时,应开启觉醒模式。
能力开启觉醒模式关闭觉醒模式
工作方式@Waker 认领请求并智能分派任务普通 IM 聊天连接
Waker可配置多位,并设置默认 Waker 和路由规则只保留一位 Waker;多于一位时不能关闭
任务上下文持续记录任务及每次继续执行不提供 @Waker 任务编排
话题与记忆按聊天沉淀群通用记忆、成员记忆和话题不沉淀 @Waker 话题和记忆
适合场景研发协作、故障处置、运营生产等持续工作简单收发、固定单 Waker 响应
群组或群聊答疑专员作为工作对象时只能使用普通 IM 模式。切换模式前先确认现有任务、Waker 和路由规则;关闭后,原来的多 Waker 分派、任务记录和记忆能力不再继续工作。

在 IM 中工作

  • 群聊: @ 统一机器人并写清任务。系统根据名称、职责、默认 Waker 和路由规则选择执行者;任务状态会显示实际工作的 Waker。
  • 单聊: 直接发送任务,后续消息可以继续原任务;目标或工作目录改变时明确创建新任务。
  • 继续工作: 引用上一条结果或说明“继续当前任务”,补充新的约束和验收要求。
  • 交付文件: 是否能直接返回文件取决于渠道连接能力。无法展示原生附件时,以聊天中的可点击链接或产品中的任务产物为准。
不要在 IM 中发送密码、Token、客户隐私或其他敏感凭据。重要结论和最终文件应回到团队可访问的项目或知识库中沉淀。

查看任务、话题与记忆

进入「@Waker」→ 已开通聊天 → 聊天详情,可以分别查看任务、话题和记忆:
内容作用范围适合保存
群共享记忆当前群内所有成员团队约定、稳定事实和已确认结论
成员记忆当前群中的指定成员职责、偏好和个人协作习惯
单聊记忆机器人与该成员的单聊只适用于这段单聊的长期上下文
话题当前群聊或单聊的一段讨论任务摘要、阶段结论和后续讨论上下文
查看记忆时先按范围、成员、时间或来源筛选。不要把成员偏好写成群共享规则,也不要把一次讨论的临时结论直接当作长期记忆。需要维护 Waker 的个人或项目记忆时,前往 《记忆系统》

群聊消息怎么写

群里始终只需要 @ 同一个机器人。成员不必知道背后有多少 Waker,系统会根据职责、默认 Waker 和自定义路由规则选择执行者。
@机器人 新任务:根据今天群内讨论整理发布阻塞项。
范围:只读取本群消息和已发送附件。
交付:按负责人、影响、下一步和截止时间输出表格。
约束:不要执行发布或修改外部系统;需要操作时先给方案并等待确认。
继续同一工作时引用上一条结果并写“继续当前任务”;目标、项目或主要目录改变时明确写“新任务”。不要把代码合并、生产变更和分析任务塞进同一条消息。

配置响应规则

进入聊天详情的「响应规则」页签,可以控制群消息何时触发 Waker:
  • @响应: 默认规则。群成员 @ 机器人时触发;关闭后只按自定义规则判断。
  • 消息规则: 按发送人、关键字或正则匹配,无需 @;可设置冷却时间和追加指令。
  • 定时规则: 按小时、每天、每周、每月或自定义 Cron 在群内发起任务。
响应规则只对当前群聊生效,当前版本暂仅支持钉钉。若关闭「@响应」且没有任何启用的自定义规则,该群不会响应消息。规则上线前先用测试群验证正则、冷却时间和追加指令,避免误触发或重复执行。

配置专家

专家用于在 Waker 缺少信息或需要专业判断时提供人工协助,不代替 Waker 执行任务。
  1. 在 Waker 管理中打开用于 @Waker 的目标 Waker。
  2. 进入专家配置,添加专家身份、专业标签和可接收请求的渠道。
  3. 写清什么时候求助、需要提供哪些上下文,以及专家回复后如何继续任务。
  4. 使用测试问题触发一次求助,确认专家收到足够信息,且回复能回到原任务。
不要把审批责任和专家咨询混在一起。生产变更、外部发布等审批仍应使用明确的人工确认步骤。

管理与验证

在「已开通的 @Waker」中按聊天、连接、模型、觉醒模式或状态筛选。进入聊天详情后可查看概览、任务记录、记忆、专家和响应规则;也可编辑 Waker、默认角色、目录和权限,或暂停、恢复和解除聊天。
  • 暂停聊天: 暂停接收新任务,但保留当前配置和历史。
  • 关闭觉醒模式: 退回普通 IM 模式;先把 Waker 减少为一位。
  • 删除聊天: 解除该聊天与 @Waker 的关系,不会删除 IM 群本身。
  • 删除 IM 连接: 立即停止收发;重新添加同一机器人后,原聊天会恢复为暂停状态,需要手动启用。
修改 Waker、默认 Waker、模型、工作目录或专家后,使用同一测试聊天分别发起职责明确和职责模糊的任务。前者应路由到对应专业 Waker,后者应由默认 Waker 处理或请求补充信息。 上线前至少验证:
  1. 单聊消息可以创建并继续任务。
  2. 群聊中只需 @ 一个机器人,不同任务能路由给不同 Waker。
  3. 未授权聊天按策略进入待处理申请或被拒绝。
  4. 文件、进度和最终结果可以由群成员找到并验收。
  5. 高风险任务会停在人工确认前,停用连接后不再接收新消息。
  6. 觉醒模式的开启状态与预期一致,任务记录、话题和记忆能够在聊天详情中找到。