Skip to main content
Skill 提供可复用的工作方法；连接器让 Waker 调用外部应用或 MCP 工具；IM 渠道让外部会话把消息交给 Waker。三者作用不同：
选择入口： 工作方法在「技能」中安装；外部工具和 DingTalk DWS 在「连接器」中配置；外部会话在「IM」中配对。

​
安装和管理 Skill

​
从技能市场安装

  1. 进入目标 Waker →「技能」→「技能市场」。
  2. 搜索并打开目标 Skill，确认用途和来源后点击「安装」。
  3. 到「我的技能」确认状态为已安装。
只安装与 Waker 职责直接相关的 Skill，避免同类能力冲突。

​
上传自有 Skill

  1. 在「技能」页点击「上传 Skill」，选择 .md 或页面支持的压缩包。
  2. .md 文件需包含 name 和 description；压缩包需包含 SKILL.md。
  3. 上传后到「我的技能」确认结果。
不要上传来源不明或会读取敏感目录的 Skill；上传前应检查 SKILL.md 及其引用内容。

​
变更后验证

需要回滚或卸载时，进入「我的技能」→ 目标 Skill →「更多操作」。操作前先检查自动任务和 WakerFlow 是否依赖该 Skill；变更后新建对话，用最小任务验证。 完成判断： 当前版本或安装状态符合预期；新会话中的能力变化已经生效；依赖该 Skill 的流程没有出现缺失能力错误。 安装或上传失败时，检查网络、文件结构及同名版本，再重新上传或安装。

​
添加连接器和 MCP 服务

连接器用于管理外部应用和 MCP 服务。进入 Waker 详情 →「连接器」，再根据配置来源选择添加方式：

​
添加自定义 MCP

  1. 在「应用」中点击「添加」。
  2. 只有单个服务信息时选择「手动填写配置」，填写名称、启动命令或服务器地址，并按需设置环境变量、Headers 和超时时间。
  3. 已有完整配置时选择「粘贴 JSON 配置」，粘贴包含 mcpServers 的完整 JSON，确认页面正确识别服务后点击「导入」。
  4. 保存前确认命令或 URL 可用，只开放必要目录；凭据保存在受保护的环境变量中。

​
授权并验证

添加或导入后按顺序操作：
  1. 状态为「需要授权」时完成授权。
  2. 点击「检测」或「重新检测」，等待状态变为「已连接」。
  3. 刷新工具，只启用当前 Waker 需要的工具。
  4. 新建对话，用最小任务验证调用。
状态不是「已连接」或工具数量为 0 时，重新检查配置、授权和启动命令，再执行检测。

​
启用并验证 DingTalk DWS MCP

DingTalk DWS MCP 是「系统」连接器，可在授权范围内读取、总结和发送钉钉群消息。
  1. 进入目标 Waker →「连接器」→「系统」，找到「DingTalk DWS」。
  2. 按页面提示安装、更新或授权 DWS CLI。
  3. 刷新页面，确认连接器状态为已连接。
授权后先在普通对话中验证：读取测试群的少量消息、生成总结、向指定测试群发送固定文案。 完成判断： DWS 工具调用成功，读取和发送目标正确，总结与原消息一致。正式自动发消息前，应限制目标群和发送频率，并在任务描述中写明”错误时不发送”。修改连接器后需新开对话测试。

​
配置 IM 渠道和会话配对

主导航「IM」用于统一管理渠道和会话；Waker 详情中的「IM」用于查看当前 Waker 接管的会话。

​
新增渠道

  1. 进入「IM」→「渠道配置」→「添加渠道」。
  2. 选择渠道并按向导完成授权或填写凭据。
  3. 设置配对模式、响应 Waker、模型和工作目录；生产环境优先使用配对模式。
  4. 保存并确认状态为已连接。
可见渠道以当前账号和页面为准。

​
处理配对申请

  1. 进入「IM」→「会话管理」→「待处理配对申请」。
  2. 核对会话名称、发起人、渠道和类型。
  3. 选择响应 Waker、模型和工作目录，点击「允许」；不可信请求选择「忽略」。
  4. 在「已配对会话」确认状态为活跃。
也可使用「添加配对」手动选择群聊或单聊。
Q仔配对提示（仅适用于 Qmate 模板）： Q仔默认由预置答疑 WakerFlow 处理消息，配对页无需选择工作流；节点模型在 WakerFlow 中配置，单聊优先填写 Open ID。创建配对后，应确认渠道已启用，并在测试群检查答疑记录和执行记录。

​
验证消息链路

  1. 确认渠道已连接、目标 Waker 正在运行。
  2. 从已配对会话发送测试消息。
  3. 检查回复使用的 Waker、模型和工作目录；按需验证非敏感附件。
消息或配对异常时，检查渠道连接、配对状态、响应 Waker 和工作目录；Q仔还需检查预置答疑流程。 “钉钉用户”一类代发模式会以本人身份发送 AI 回复，启用前应严格限制监听会话范围，并对自动回复内容负责。

​
集成上线前检查

  • 按最小权限启用 Skill、连接器和 IM 渠道，先验证只读能力，再开放写入或发消息能力。
  • Token、Cookie、AppSecret 和个人访问令牌应放在受保护的凭据或环境变量中，不得写入正文、日志或截图。
  • 删除或变更集成前先检查依赖，变更后用新会话做一次最小验证。