一、什么是值班助手？什么是 QoderWake？
1.1 值班助手
值班助手（On-Call Assistant）是 QoderWake 中面向值班、告警、事件响应场景的数字员工。它不只是能在群里回复消息的机器人，而是能：
能力 |
说明 |
接收告警/事件 |
在钉钉群被 @，或对接告警系统收到事件推送 |
查询知识库 |
基于历史值班记录、SOP、服务文档、故障手册做 RAG 检索 |
辅助定位 |
根据告警内容给出可能根因、排查命令、关联服务 |
记录与交接 |
自动生成值班纪要、处理时间线，沉淀到知识库 |
升级与协同 |
必要时 @ 相关责任人、创建工单或移交二线 |
简单说，值班助手 = Agent + 值班身份 + 运维技能 + 知识库 + 工作目录。你可以把它理解为一位“不会疲劳、熟悉历史案例、能随时被 @”的虚拟值班同事。
1.2 QoderWake 是什么？
QoderWake 是 Qoder 生态中的本地运行引擎，负责把 AI Agent 部署到你的服务器或本地机器，并让它们与外部系统（如钉钉、邮件、代码仓库等）建立连接。
它提供：
- 一个常驻运行的 Daemon（守护进程）；
- 一个通过浏览器访问的 Web 控制台；
- 标准化的 IM 连接能力，让 Agent 以“真实用户”或“机器人”身份进入钉钉群聊。
一句话：QoderWake 是数字员工的“工位”，云就是这个工位所在的机房。
二、值班助手落地后的典型效果
把值班助手接进群聊和告警流程后，主要带来六方面变化：
- 响应更快：常见告警自动给出标准处置步骤，减少翻文档时间。
- 上手更快：处理流程、命令模板都沉淀在知识库，新人随时问、随时学。
- 负担更轻：重复性问题由助手先兜底，值班人员只需确认关键动作。
- 风险更低：高危操作建议附带风险提示，关键动作需人工确认。
- 经验沉淀：每次事件处理过程自动生成值班纪要，回收到知识库，形成可复用的故障案例。
- 协同更顺：一个群里可同时存在值班、代码审查、文档等助手，复杂故障可接力处理。
三、为什么值班助手必须部署到云上？
值班助手需要长期在线、稳定收发消息，并被团队共享访问。核心原因有三点：
- 7×24 小时运行：它是守护进程，个人电脑关机就“下班”。
- 稳定的网络入口：接收钉钉事件、开放 Web UI，云上固定 IP 更可靠。
- 团队共享：配置、会话状态和知识库需要多人通过浏览器统一访问。
- 部署和运维更简单：计算巢等方案能一键完成环境准备，省去自己配 ECS、安全组、代理的麻烦。
四、QoderWake 的核心价值
价值 |
说明 |
本地化部署 |
数据和运行环境都在你自己的机器上，满足企业对数据可控的要求 |
IM 原生集成 |
通过钉钉用户/机器人模式，让 AI 无缝进入现有工作流 |
多 Waker 协同 |
一个群里可以有多个数字员工，各自负责不同领域 |
Skill 生态扩展 |
通过 Skill 让 Waker 获得特定能力，无需重复开发 |
统一控制台 |
在 Web UI 中管理认证、连接、会话和状态 |
五、值班助手部署流程
整个流程分为 4 步：
通过计算巢部署 → 初始化配置 → 配置钉钉渠道 → 创建值班助手 Waker
5.1 通过计算巢部署
推荐通过阿里云计算巢一键部署 QoderWake，无需自己准备 ECS、配置安全组、安装依赖。 
计算巢部署完成后，会自动创建好运行环境，接下来只需要进入实例执行初始化配置即可。
5.2 初始化配置
计算巢部署完成后，参考以下步骤完成初始化：
- 登录实例并启动 qodercli
sudo su cd /root source /root/.profile qodercli
- 在交互式界面完成授权
启动 qodercli 后，选择 Login with Qoder Platform (Browser)，复制完整的授权链接在浏览器中打开并批准登录。
- 退出 qodercli，启动 qoderwake 服务
登录完成后，按 Ctrl+C 退出 qodercli，然后执行：
qoderwake start --host 0.0.0.0 -y nohup socat TCP-LISTEN:19821,fork,reuseaddr TCP:127.0.0.1:19820 >/dev/null 2>&1 &
服务启动后，通过计算巢提供的安全代理或公网入口访问 Web UI（建议全屏显示），即可进入 QoderWake 控制台。进入后需二次登录。 
5.3 配置钉钉渠道
进入 QoderWake 控制台 → IM 连接，点击添加机器人。
步骤一：配置 IM 连接
- 首次点击“安装并登录”后，“已安装”会变为绿色，但“已认证”仍为红色，但已认证将仍然会是红色，使用钉钉扫描二维码：
- 在手机端授权：
- 再次点击安装并登录，将会跳转设备授权页面，授权码请回到qoderwake页面：
- 按照提示授权，最终完成：
- 点击“重新检查”，即可看到配置完成（若始终无法检测认证完成，请参考步骤二设置 CLI 权限）。
点击保存。
步骤二：开启钉钉组织 CLI 权限（可选）
如果步骤一中认证失败或无法收到消息，需要让组织管理员登录钉钉开放平台，进入 基本信息 → CLI 设置，确保：
- 允许成员通过 CLI 访问个人数据 开关已打开；
- 使用范围管理 中选择“全员可用”或“指定人员范围可用”，并将目标成员加入。
否则即使个人授权成功，DWS CLI 也无法读取组织内的消息数据。
5.4 创建值班助手 Waker
- 进入‘我的Wakers’，点击新建Wakers，选择群聊答疑专员
- 依据提示创建Waker：
- 页面将会跳转到快速上手，依据提示配置即可，这里可选择手动配对，选择所需群聊：
- 群聊选择完成后，点击下一步
- 前往绑定知识库、专家配置等内容。
- 最后，将机器人添加至群聊（需要在群聊中添加机器人），即可实现自动答疑：
5.5 接入告警/事件推送（可选进阶）
除了被 @ 之外，值班助手还可以对接告警系统：
- 通过 钉钉群机器人 Webhook 把告警消息发到群里；
- 助手收到事件后自动检索知识库并给出初步响应。
这一步根据你现有的监控体系灵活接入即可。
六、总结
QoderWake 让 AI Agent 从“工具”变成了“员工”，而值班助手是其中最容易快速见效的场景之一：
- 它以本地化引擎的形式承载 Agent 运行；
- 以“数字员工”的形态进入企业协作场景；
- 通过知识库让历史经验被持续复用；
- 通过标准化流程完成认证、接入、响应和沉淀。
对企业而言，部署一个值班助手的本质流程可以归纳为：
通过计算巢部署 → 初始化配置 → 配置钉钉渠道 → 创建值班助手 Waker → 挂载知识库 → 测试验证
一旦跑通，你就可以继续复制出代码审查助手、文档助手、运维值班助手等不同类型的数字员工，让他们在群聊中协同工作，持续沉淀团队知识。
