QoderWake未触发需检查五类配置：一、关键词触发需在控制台设置监听词并关联启用Skill；二、API回调需配置Webhook URL、签名密钥及JSON Schema校验；三、定时触发需填写Cron表达式并授权Connector权限；四、事件总线需绑定消息源并配置认证与JSONPath过滤；五、手动触发需发布入口并设置可见范围与二次确认。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望QoderWake在特定业务场景下自动响应并执行任务，但发现其未按预期触发，则可能是由于触发条件未正确配置或事件源未接入。以下是设置QoderWake触发条件的具体路径：
一、配置关键词触发条件
关键词触发适用于自然语言指令驱动的轻量级任务，QoderWake将实时监听用户输入中是否包含预设关键词，并据此激活对应Skill。该方式无需外部系统集成，适合内部协作场景下的快速响应。
1、登录QoderWake管理控制台，进入「触发管理」页面。
2、点击「新建关键词触发」，填写触发名称与描述。
3、在「关键词列表」中输入至少一个完整词或短语，支持中英文混合，例如：“生成周报”、“紧急回滚”。
4、勾选关联的高阶Skill，确保该Skill已通过参数校验阶段且处于启用状态。
5、点击「保存并启用」，系统将立即编译关键词匹配规则至边缘监听模块。
二、绑定API回调触发源
API回调触发用于对接企业已有系统（如CRM、监控告警平台、审批流引擎），当外部系统发出HTTP POST请求时，QoderWake接收有效载荷并启动指定任务流程。该方式要求严格的身份认证与数据格式校验。
1、在「触发管理」页面选择「API回调触发」，点击「创建新端点」。
2、系统自动生成唯一Webhook URL，形如https://wake.qoder.ai/v1/webhook/abc123，请妥善保存。
3、配置签名密钥：点击「生成密钥」，获取HMAC-SHA256密钥字符串，并同步配置至调用方系统。
4、在「请求体映射」区域定义JSON Schema，明确声明必需字段，例如："event_type"、"target_env"、"urgency_level"。
5、保存后，QoderWake将对所有到达该URL的请求执行签名验证与Schema校验，任一失败即拒绝处理并返回401错误。
三、启用定时触发策略
定时触发适用于周期性运维任务（如日志归档、指标快照、备份检查），基于Cron表达式精确控制执行时间点，所有任务在独立沙盒中运行并写入审计日志。
1、进入「触发管理」→「定时触发」，点击「添加计划」。
2、输入计划名称，选择执行时区（默认为服务器本地时区）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、填写标准Cron表达式，例如："0 0 * * 1" 表示每周一凌晨0点执行。
4、从下拉菜单中选择目标Skill，并确认其具备所需Connector权限（如访问OSS Bucket或发送邮件）。
5、启用「失败重试」开关，设置最大重试次数（1–5次）及间隔秒数（最小30秒）。
四、接入事件总线实现多源联动
事件总线触发支持从阿里云EventBridge、自建Kafka集群或Slack事件网关等异构消息源订阅事件，QoderWake以消费者身份拉取消息，解析后路由至对应Skill。此方式适用于复杂协同流程中的解耦调度。
1、在「触发管理」中选择「事件总线触发」，点击「绑定新源」。
2、选择消息源类型：从下拉列表中选取Alibaba Cloud EventBridge、Kafka Cluster或Slack Events API。
3、按向导完成认证配置：对于EventBridge需输入RAM角色ARN；对于Kafka需提供Bootstrap Servers与SASL凭证；对于Slack需粘贴Verification Token与Signing Secret。
4、在「事件过滤器」中定义JSONPath表达式，例如：$.type == "issue_created" 或 $.action == "approved"。
5、保存后，QoderWake将建立长连接并开始消费匹配事件，首次同步延迟不超过15秒。
五、配置人工手动触发入口
人工手动触发作为安全兜底机制，允许用户在QoderWake客户端界面、IDE插件侧边栏或企业微信机器人中一键启动预设任务，所有操作均强制记录操作人身份与设备指纹。
1、进入「触发管理」→「手动触发」，点击「发布新入口」。
2、填写入口名称（如生产环境热修复）与可见范围（全部成员 / 指定角色组）。
3、上传图标文件（PNG格式，尺寸48×48像素），图标将显示在客户端快捷操作区。
4、勾选「执行前二次确认」，启用弹窗提示，内容可自定义，例如：“即将在PROD环境执行SQL变更，确认继续？”。
5、点击「发布」，入口将在5秒内同步至所有已授权终端。
