必须选择「从零创建角色」才能进入自定义流程；角色描述需用“扫描”“提取”等可执行动词；需挂载pdf-parser、openclaw、wiki-sync技能或绑定合规脚本；监听路径须小写通配符；webhook密钥丢失需重置通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在QoderWake中创建一个完全贴合自己工作流的Waker角色，而不是用预置的后端工程师或产品经理模板——这意味着你需要绕过“新建模板”页面里的快捷入口，手动进入自定义角色构建流程，否则系统会直接跳转到预置角色配置页，根本不会出现角色定义界面。
进入自定义角色创建入口
左侧导航栏点击“我的员工”→“新建模板”，【必须立刻点击右上角的「高级选项」下拉箭头，选择「从零创建角色」】。如果直接点“后端工程师”等预设项，后续所有步骤都将被锁定在该角色框架内，无法修改核心行为逻辑。
这一步操作起来很简单，直接把文件拖进去就行。
定义角色基础元信息
填写角色名称（如“风控策略分析师”）、岗位描述（限200字，需明确写出“每日扫描监管新规PDF→提取关键词→生成适配建议→同步至内部Wiki”这类动宾结构句式）、所属团队（可选“AI合规组”等已有分组）。
【岗位描述中禁止出现“可能”“建议”“协助”等模糊动词，必须使用“扫描”“提取”“生成”“同步”等可执行动词，否则后续任务编排将无法触发自动执行】
配置角色技能栈与上下文锚点
方法一：挂载现成Skill模块
在“技能接入”区域点击“+添加Skill”，从列表中勾选openclaw（用于钉钉消息触发）、pdf-parser（用于解析监管文件）、wiki-sync（用于自动更新知识库）三项——这三者构成闭环能力链，缺一不可。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
方法二：绑定本地脚本路径
在“自定义工具”栏粘贴绝对路径：D:\qoderwakescripts\risk_policy_extractor.py，该脚本需满足QoderWake工具协议：接收JSON输入（含file_path字段），输出标准JSON格式的关键词数组与建议段落。路径错误或脚本无输出将导致角色初始化失败。
设置事件触发规则
第一步：选择触发源类型
勾选“文件系统监听”和“Webhook接收”，取消勾选“语音唤醒”（自定义角色默认不启用本地麦克风权限）。
第二步：配置监听路径
在“文件监听路径”框中输入：C:\Users\YourName\Documents\Regulatory\*.pdf，注意末尾必须带通配符*且扩展名全小写，大写.PDF会导致监听失效。
第三步：定义Webhook校验密钥
生成32位随机字符串（如e8f2a1d9b4c7f65038219a7b6c4d5e8f），填入“Secret Key”字段并保存——该密钥将用于下游系统签名验证，丢失后需重置整个Webhook通道。
验证角色可用性
点击右上角「保存并测试」，系统自动生成测试事件：向监听路径写入一个空PDF文件 → 触发pdf-parser Skill → 调用risk_policy_extractor.py → 输出模拟结果。
终端显示[SUCCESS] risk_policy_extractor executed with 2 keywords and 1 suggestion即表示角色构建完成。
