网页端唤醒qoderwake失败需依次配置：一、安装启用chrome扩展；二、启用web bridge并配置端口与跨域；三、通过绑定码完成扩展与客户端身份配对；四、在允许域名下测试唤醒链路；五、解决https混合内容限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试通过网页端触发QoderWake客户端执行任务，但点击唤醒按钮后无响应或提示“未检测到本地服务”，则可能是由于浏览器插件与本地QoderWake服务之间的通信通道未正确建立。以下是实现网页端直接唤醒客户端的配置步骤：
一、安装并启用Qoder Chrome Browser Use Agent扩展
该扩展是QoderWake实现Browser Use能力的核心载体，负责在Chrome中建立与本地QoderWake服务的WebSocket长连接，并代理网页端发起的唤醒指令。未安装此扩展将导致所有网页唤醒请求被静默丢弃。
1、访问Chrome网上应用店，搜索“Qoder Chrome Browser Use Agent”。
2、点击“添加至Chrome”，确认权限声明后完成安装。
3、点击浏览器右上角拼图图标，找到该扩展图标，右键选择“管理扩展程序”。
4、确保“允许访问文件网址”和“在隐身模式下启用”两个选项均已开启。
二、配置本地QoderWake服务监听HTTP/WS端口
QoderWake默认不对外暴露Web接口，需手动启用内置Web Bridge模块，使其监听指定端口接收来自浏览器扩展的唤醒请求。该模块启动后将在本地回环地址提供/health、/wake等基础端点。
1、打开终端（Windows PowerShell / macOS Terminal / Linux Bash），执行qoderwake status确认服务已运行。
2、若服务未启动，先执行qoderwake start --enable-web-bridge --web-port=8081。
3、编辑QoderWake配置文件config.yaml，在server节点下添加如下字段：web_bridge: { enabled: true, port: 8081, allow_origin: ["http://localhost:3000", "https://qoder.com"] }。
4、保存后执行qoderwake restart强制重载配置，检查日志中是否出现“WebBridge started on :8081”。
三、绑定浏览器扩展与本地服务身份凭证
为防止未授权网页冒用唤醒能力，QoderWake要求浏览器扩展在首次通信时提交一次性绑定令牌（Binding Token），该令牌由客户端生成并仅在首次配对时有效，确保双向身份可信。
1、在QoderWake控制台输入命令：/bind-browser-agent，终端将输出6位数字绑定码（如：739215）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、点击浏览器地址栏右侧Qoder扩展图标，选择“Connect to Local Wake”。
3、在弹出面板中输入刚获取的6位绑定码，点击确认。
4、扩展图标右下角应显示绿色圆点，并提示“Connected · qoderwake://local”。
四、验证网页端唤醒链路完整性
完成上述配置后，需在真实网页环境中测试端到端唤醒流程。测试页面必须位于config.yaml中allow_origin所列域名内，否则CORS策略将拦截请求。
1、打开https://qoder.com/demo/wake-test.html（官方测试页）或您部署于localhost:3000的前端项目。
2、网页中点击带有data-qoder-wake属性的按钮（如）。
3、观察QoderWake控制台是否实时打印类似“[BrowserUse] Received wake event: debug → current-tab”的日志行。
4、检查Chrome开发者工具Network标签页，确认有向http://localhost:8081/wake发起的POST请求且返回状态码为200。
五、处理跨域与HTTPS混合内容限制
当网页使用HTTPS而本地服务为HTTP时，现代浏览器会阻止混合内容请求，导致唤醒失败。必须显式配置QoderWake启用自签名HTTPS服务或启用临时宽松策略以绕过限制。
1、在QoderWake安装目录下执行命令：qoderwake cert-gen --self-signed，生成本地证书对。
2、修改config.yaml中web_bridge配置段，添加ssl_key_path与ssl_cert_path字段，指向新生成的key.pem和cert.pem。
3、重启服务后，浏览器扩展连接地址需更新为https://localhost:8081，且需在Chrome中手动信任该证书（访问https://localhost:8081时点击“高级→继续前往”）。
4、若仅用于开发调试，可在Chrome快捷方式目标末尾追加参数：--unsafely-treat-insecure-origin-as-secure="http://localhost:8081" --user-data-dir=/tmp/qoder-chrome-profile。
