QoderWake 与数字员工：从概念到部署

一、什么是数字员工？什么是 QoderWake？

数字员工（Digital Employee / Waker）是 QoderWake 中的核心概念。它是一个具备以下特征的 AI 工作单元：

特征	说明
可对话	能在钉钉群聊、单聊中被 @，像真人一样沟通
有身份	可以以"钉钉用户"或"钉钉机器人"身份接入
有技能	可加载前端开发、代码审查、文档生成等 Skill
可协作	多个 Waker 可在同一个群里分工处理不同任务
可沉淀	工作中的上下文、记忆、产出会沉淀下来

一个数字员工本质上是一个 Agent + 身份 + 技能 + 工作目录 的组合。你可以为不同场景创建不同 Waker：

• 前端开发 Waker：处理 UI 组件、样式问题
• 代码审查 Waker：Review PR、检查代码规范
• 运维值班 Waker：查询日志、处理告警
• 文档助手 Waker：生成和更新文档

QoderWake 是 Qoder 生态中的本地运行引擎，负责把 AI Agent 部署到你的服务器或本地机器上，并让它们与外部系统（如钉钉、邮件、代码仓库等）建立连接。

简单理解：

• 如果你把 AI 模型比作"大脑"，QoderWake 就是连接大脑与现实世界的"神经系统 + 手脚"。
• 它提供一个本地 Daemon（守护进程）、一套 Web 控制台、以及标准化的 IM 连接能力。
• 通过 QoderWake，你可以让企业内的 AI Agent 以"真实用户"或"机器人"的身份进入钉钉群聊，接收消息、执行任务、回复问题。

QoderWake 的典型运行形态是一台常驻运行的服务器（推荐通过阿里云计算巢一键部署），上面部署着 qoderwake daemon，并通过浏览器访问其 Web UI 进行配置管理。

二、为什么数字员工必须部署到云上？

QoderWake 需要部署到云上，一句话总结：数字员工必须长期在线、稳定收发消息，并被团队共享访问。

具体三点：

1. 7×24 小时运行：它是守护进程，个人电脑关机就"下班"。
2. 稳定的网络入口：接收钉钉事件、开放 Web UI，云上固定 IP 更可靠。
3. 团队共享：配置和会话状态需要多人通过浏览器统一访问。
4. 部署和运维更简单：计算巢等方案能一键完成环境准备，省去自己配 ECS、安全组、代理的麻烦。

所以 QoderWake 是数字员工的"工位"，云就是这个工位所在机房。

三、QoderWake 的核心价值

1. 本地化部署：数据和运行环境都在你自己的机器上，满足企业对数据可控的要求。
2. IM 原生集成：通过钉钉用户/机器人模式，让 AI 无缝进入现有工作流。
3. 多 Waker 协同：一个群里可以有多个数字员工，各自负责不同领域。
4. Skill 生态扩展：通过 Skill 让 Waker 获得特定能力，无需重复开发。
5. 统一控制台：在 Web UI 中管理认证、连接、会话和状态。

四、数字员工部署流程

下面以官方内置的 IM 渠道为例，介绍如何为自己的团队招募一位数字员工。整个流程分为 4 步：

通过计算巢部署 → 初始化配置 → 创建 Waker → 配置钉钉渠道

4.1 通过计算巢部署

推荐通过阿里云计算巢一键部署 QoderWake，无需自己准备 ECS、配置安全组、安装依赖。

计算巢部署完成后，会自动创建好运行环境，接下来只需要进入实例执行初始化配置即可。

4.2 初始化配置

计算巢部署完成后，参考以下步骤完成初始化：

1. 登录实例并启动 qodercli

sudo su
cd /root
source /root/.profile
qodercli

AI 代码解读

2. 在交互式界面完成授权启动 qodercli 后，选择 Login with Qoder Platform (Browser)，复制完整的授权链接在浏览器中打开并批准登录。

3. 退出 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 &

AI 代码解读

服务启动后，通过计算巢提供的安全代理或公网入口访问 Web UI（建议全屏显示），即可进入 QoderWake 控制台。进入后需二次登陆。

4.3 创建 Waker

方式一：快速定义Waker点击新建Waker，可从预设中自选角色。

输入基本信息后即可创建完成。

方式二：自定义Waker参考 QoderWake 官方文档：https://qoder.com/zh/qoderwake

创建一个 Waker（数字员工）时，核心是定义它的角色模板。QoderWake 通过三个模板文档来定义 Waker 的行为：

文件	核心问题	主要内容	不适合放什么
Identity.md	我是谁、负责什么	角色定位、目标、职责范围、能力边界、完成标准	详细工作步骤、措辞风格
Persona.md	我以什么方式思考和沟通	性格特质、表达方式、判断倾向、沟通策略、反模式	业务流程、工具操作步骤
Bible.md	我具体怎样把事情做完	标准工作流、阶段门禁、技能编排、验证规则、异常处理、交付要求	角色介绍、纯粹的语气描述

4.4 配置钉钉渠道

进入 QoderWake 控制台 → IM 连接，点击添加机器人。

步骤一：配置 IM 连接

1. 首次点击“安装并登录”后，“已安装”会变为绿色，但“已认证”仍为红色，但已认证将仍然会是红色，使用钉钉扫描二维码：

   

2. 在手机端授权：

   

3. 再次点击安装并登录，将会跳转设备授权页面，授权码请回到qoderwake页面：

   

   

4. 按照提示授权，最终完成：

   

5. 点击“重新检查”，即可看到配置完成（若始终无法检测认证完成，请参考步骤二设置 CLI 权限）。

点击保存。

步骤二：开启钉钉组织 CLI 权限（可选）

如果步骤一中认证失败或无法收到消息，需要让组织管理员登录钉钉开放平台，进入 基本信息 → CLI 设置，确保：

• 允许成员通过 CLI 访问个人数据 开关已打开
• 使用范围管理 中选择"全员可用"或"指定人员范围可用"，并将目标成员加入

否则即使个人授权成功，DWS CLI 也无法读取组织内的消息数据。

3. 将 Waker 接入会话并测试

切换为Waker回话，点击开通Waker，把创建好的 Waker 接入到具体钉钉会话（群聊或单聊）。

按照提示配置即可。完成配置后，在钉钉群里或私聊，让其他成员 @ Waker 对应的身份：

如果 Waker 成功回复，说明整条链路已经跑通。

五、总结

QoderWake 让 AI Agent 从"工具"变成了"员工"：

• 它以本地化引擎的形式承载 Agent 运行
• 以"数字员工"的形态进入企业协作场景
• 通过标准化流程完成认证、接入、响应和沉淀

对企业而言，部署一个数字员工的本质流程可以归纳为：

通过计算巢部署 → 初始化配置 → 创建 Waker → 配置钉钉渠道 → 测试验证

一旦跑通，你就可以根据业务需要，批量复制出前端开发、代码审查、运维值班、文档助手等不同类型的数字员工，让他们在群聊中协同工作，持续沉淀团队知识。