必须直接编辑Waker专属config.yaml文件:先通过qoderwake list-wakers获取ID,再进入对应配置目录修改contextRoot、permissionRedlines、connectors等字段,最后用qoderwake reload-waker重载并验证日志与响应头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

创建Waker后发现配置项不匹配实际项目结构或权限策略,需要直接编辑其运行时配置文件,不能依赖UI界面二次修改,否则部分底层参数会被忽略。
定位并打开Waker专属配置文件
每个Waker实例在创建时会生成独立的配置目录,路径由设备指纹和Waker ID联合决定,不可通过设置面板跳转。
在终端中执行:qoderwake list-wakers,找到目标Waker名称(如api-gateway-prod)对应的ID(形如wk_8a3f9b1c)。
进入其配置目录:
Windows:打开%APPDATA%\QoderWake\wakers\wk_8a3f9b1c\
macOS/Linux:进入~/.config/QoderWake/wakers/wk_8a3f9b1c/
该目录下必须存在config.yaml——这是唯一生效的运行时配置源,【不要编辑同级的settings.json或config.toml】。
修改核心配置项
用文本编辑器打开config.yaml,按需调整以下字段:
方法一:修改执行上下文路径
将contextRoot值从"./"改为绝对路径,例如"/home/user/projects/api-gateway"。若仍用相对路径,Waker启动时会以QoderWake主进程工作目录为基准,极易导致文件读取失败。
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
方法二:更新权限红线策略
在permissionRedlines节点下,删除已过期的delete-db-table条目,新增modify-k8s-deployment并设requireConfirm: true。注意:策略名必须与Qoder平台预定义的权限标识完全一致,大小写和连字符均不可错。
方法三:切换Connector绑定
找到connectors区块,将原github: gh_conn_v1改为github: gh_conn_v2,确保新Connector已在全局Connectors列表中启用且OAuth token未过期。若仅改名称而未提前配置对应实例,Waker会在首次调用时静默失败。
重载配置并验证变更
第一步:保存config.yaml文件,关闭所有编辑器窗口。
第二步:在终端中执行:qoderwake reload-waker --id wk_8a3f9b1c。该命令会强制终止当前Waker进程、重新加载YAML并重建内存上下文,【不会重启整个QoderWake服务】。
第三步:执行qoderwake logs --waker-id wk_8a3f9b1c --tail 20,检查输出中是否包含Config reloaded: contextRoot=/home/user/projects/api-gateway及Permission redline updated: modify-k8s-deployment等确认行。
第四步:向该Waker发起一次测试请求(如调用其暴露的/health端点),观察响应头中X-Context-Root是否已更新为新路径。

















