必须完成角色绑定、身份初始化、上下文配置与能力激活四步闭环才能创建可用waker;需基于预置模板选角色、设名称团队及设备绑定、配置工作区锚点、最后启用唤醒并验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在QoderWake中创建一个可被调用、可执行任务的数字员工(Waker),必须完成角色绑定、身份初始化、上下文配置与能力激活四步闭环,缺一不可;跳过任一环节将导致Waker无法响应唤醒指令或执行失败。
选择并加载Waker角色
QoderWake不支持从零编写角色定义,所有Waker必须基于预置岗位模板创建,自定义仅限于参数微调和技能挂载。
启动QoderWake应用后,点击左上角「+ New Waker」→ 从弹出列表中选择最匹配的岗位,例如「前端工程师」;【切勿选择“自定义”角色作为首次创建项,该选项需手动编写YAML且无UI校验,极易因格式错误导致Waker静默不可用】。
点击所选角色卡片右下角「Load Role」,等待状态栏显示“Role schema validated, assets fetched”。
命名、设岗与设备绑定
角色加载成功后,进入基础信息填写页:
第一步:在「Waker Name」栏输入中文或英文名称(如“小前端阿哲”),名称将出现在所有日志与通知中,不可含空格或特殊符号;
第二步:在「Team Assignment」下拉菜单中选择已有团队,若首次使用则点击「Create new team」新建,输入团队名后点确认;
第三步:勾选「Bind to this device」,系统立即生成本机唯一设备指纹,并自动填充至「Device ID」字段;【此ID与当前硬件强绑定,复制到其他设备将触发安全拒绝,无法绕过】。
点击「Confirm & Initialize」,界面跳转至初始化进度条,约6秒后出现绿色对勾图标。
Qoder Linux版是由阿里推出的智能体自主开发工作台,支持开发者通过定义需求即可让Agent团队“自动驾驶”,自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力,并支持跨项目多任务并行处理,显著提升开发效率。此外,Qoder还提供专家团模式与团队级知识引擎,适配复杂开发场景。
配置专属工作区与上下文锚点
每个Waker需明确其操作边界,否则可能误读项目结构或越权访问文件。
方法一:拖拽式绑定
点击「Set Workspace」按钮→ 弹出系统文件选择器→ 导航至你的代码根目录(如 ~/projects/my-vue-app)→ 选中该文件夹后点击「Open」;QoderWake会自动识别.git并标记为上下文锚点。
方法二:命令行注入
打开终端,cd进入项目根目录,执行:
qodercli waker bind --name "小前端阿哲" --path "$(pwd)";
该命令将绕过UI直接写入配置,适合CI/CD集成场景。
注意:若未设置工作区,Waker默认以用户主目录为根,所有路径解析将失准,补全、调试、PR生成等功能全部失效。
启用唤醒与验证连通性
完成上述三步后,Waker仍处于休眠态,必须显式激活才能响应指令。
进入「Settings」→「Activation」→ 将「Local Wake」与「Terminal Trigger」两个开关同时设为开启;
返回主界面,在搜索框输入「qwake 小前端阿哲 status」并回车;
若终端输出类似「[OK] Waker “小前端阿哲” is awake, bound to team “Frontend-Squad”, context: /home/user/projects/my-vue-app」,表示创建完成且已就绪。










