首次启动QClaw需完成五步初始化：一、微信扫码授权绑定；二、关联或部署OpenClaw；三、手动填入API密钥（可选但推荐）；四、启用微信远程操控弹窗权限；五、启用预置技能包。
如果您首次启动qclaw应用，界面将自动触发初始化流程，但可能因环境缺失或权限限制导致配置中断。以下是完成qclaw新手初始化所必需的关键配置项及对应操作路径：
一、微信扫码绑定授权
微信直连是QClaw的核心通信通道，首次启动后必须完成绑定，否则无法接收指令或执行远程操控。该步骤建立本地QClaw服务与个人微信账号之间的可信信道，所有后续指令均通过此链路下发。
1、启动QClaw应用，等待主界面完全加载；
2、在弹出的初始配置窗口中，定位二维码区域；
3、使用手机微信“扫一扫”功能，对准屏幕上的动态二维码；
4、在微信端确认“授权登录QClaw”，并勾选“允许消息通知”选项；
5、返回电脑端，确认状态栏显示微信已连接 · 在线字样。
二、本地OpenClaw关联或全新部署
QClaw需依托OpenClaw运行时环境执行任务，首次启动会自动检测系统中是否已存在OpenClaw实例。若检测到旧版本，可选择关联复用；若未检测到，则必须触发全新部署流程以生成可执行体。
1、观察初始化界面底部提示：“检测到本地OpenClaw v0.8.3，是否一键关联？”；
2、如需复用原有配置与技能包，点击“关联现有龙虾”按钮；
3、如为全新安装或旧版不兼容，点击“部署新龙虾”按钮；
4、等待进度条走完（通常3–5分钟），界面弹出“龙虾已就位，可随时指挥”提示。
三、模型API密钥手动填入（可选但推荐）
QClaw默认使用内置轻量模型响应基础指令，但若需调用Kimi、DeepSeek、GLM等高性能模型，必须手动填入对应平台的API Key。该配置直接影响复杂任务（如代码生成、长文档摘要）的执行质量与稳定性。
1、点击主界面左上角齿轮图标，进入设置面板；
2、切换至“AI模型”标签页；
3、在目标模型名称右侧点击“配置”按钮；
4、粘贴从https://dash.kimi.moonshot.cn/或https://platform.deepseek.com/获取的有效API Key；
5、点击“测试连接”，确认返回“验证成功，模型可用”提示。
四、微信远程操控弹窗确认
完成微信绑定后，QClaw会在系统托盘区弹出独立配置弹窗，用于开启微信消息监听与指令解析权限。该步骤不可跳过，否则微信内发送的指令将无法被识别和路由至本地执行引擎。
1、留意右下角任务栏区域，查找QClaw托盘图标（卡通小龙虾）；
2、右键点击图标，在菜单中选择“启用微信远程控制”；
3、弹窗中勾选“允许接收来自微信的文本指令”与“允许执行文件系统操作”两项；
4、点击“确定”，界面立即显示“微信遥控器已激活”浮动提示。
五、技能包启用确认（含AI热点查询与办公辅助）
QClaw预置官方技能包，首次启动后需手动启用，否则“查热点”“写周报”“整理Excel”等功能将处于禁用状态。启用操作仅需一次，后续自动加载。
1、在主界面点击“技能中心”按钮；
2、列表中找到“AI热点查询（腾讯新闻源）”与“办公辅助增强包”；
3、分别点击右侧开关，切换为开启状态；
4、每项启用后，对应图标旁出现绿色对勾标记，并显示“已就绪”。
