首次使用qoderwake需先完成设备绑定与权限配置，再创建task_first.qw任务并用qwrun执行验证；最后通过qoderwork或cli提交结构化任务，实现钉钉/飞书自动通知。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake真正动起来，执行第一个自动化任务，但安装完软件、打开界面后却卡在“不知道从哪点开始”——这很常见，因为QoderWake不提供默认任务模板，首次运行必须手动创建并触发，否则界面始终显示空闲状态。
完成首次设备绑定与权限准备
QoderWake启动后默认处于锁定状态，未完成设备绑定和系统权限授权前，任何任务提交都会被拦截并返回403 Device not enrolled错误。
1、启动QoderWake应用，点击右上角用户图标 → 选择「绑定新设备」→ 使用Qoder账号登录（支持GitHub快捷登录）。
2、等待界面显示「设备指纹生成中…」，【此时切勿切换窗口或最小化应用，8秒内中断会导致绑定失败且需重置设备码】。
3、成功后弹出形如QW-7X9F-M2T4-B8KZ的唯一设备码，复制保存备用。
4、打开系统设置 → 隐私与安全性 → 开启麦克风、文件和文件夹访问权限，并将QoderWake添加至开机自启列表。
创建并运行HelloWorld任务
这是验证整个执行链路是否通畅的最小闭环，仅三行代码，不依赖外部服务，5秒内可见结果。
1、在QoderWake安装目录下找到scripts子文件夹（例如D:\qoderwake\scripts），新建文本文件，重命名为task_first.qw。
2、用记事本打开该文件，输入以下内容：
trigger: immediate<br>action: log "任务已启动"<br>timeout: 3000
3、保存文件，回到命令行，进入QoderWake根目录（D:\qoderwake），执行：qwrun --script scripts/task_first.qw。
4、终端立即输出[LOG] 任务已启动及耗时信息，说明任务已成功执行。
通过QoderWork桌面端提交第一条结构化任务
如果你需要让任务结果自动推送到钉钉或飞书群聊，就不能只靠命令行跑日志，而要走QoderWork内置IM通道——这是实现“任务完成后自动发送提醒”的唯一前置路径。
方法一：直连式提交（推荐新手）
1、启动QoderWork桌面客户端 → 左下角「设置」→ 「频道管理」→ 点击「钉钉」图标扫码授权。
2、在「目标群组」中选择一个已开通「自定义机器人」的群聊，粘贴Webhook地址和加签密钥。
3、返回QoderWake控制台 → 「任务编排」→ 「新建工作流」→ 选择「通用通知模板」。
4、在「消息内容」字段输入：QoderWake首条任务已就绪，设备码：{device_id}，变量{device_id}会自动替换为你刚生成的QW-7X9F-M2T4-B8KZ。
5、点击「立即执行」，10秒内查看钉钉群，应收到含绿色对勾图标和设备码的卡片消息。
方法二：CLI提交（适合已有脚本习惯者）
1、终端执行qoderwake login，浏览器完成身份认证。
2、运行：qoderwake submit --event-type=system-init --target-context="local:device" --metadata='{"device_id":"QW-7X9F-M2T4-B8KZ"}'。
3、该命令会触发QoderWake内部初始化事件，自动激活QoderWork监听通道，并向已绑定的钉钉/飞书群推送结构化欢迎卡片。
