先说几个核心判断：要让AI在QClaw V2里自动操作Notion或金山文档，配置授权和技能这一步绝对不能省。跳过任何一步，指令都可能执行不了——比如你明明对着AI说了句“把今天的日报存到Notion”，结果界面卡在那里一动不动，那就尴尬了。
所以，咱们从头到尾把这套流程走一遍。
Notion直连配置（OpenClaw Skills方式）
这是延迟最低、权限也最精细的接入方式。如果你需要双向同步、频繁操作数据库字段，选它没错。这种方案不依赖任何外部中继服务，所有操作都在本地Agent内闭环完成，稳定性和响应速度都很有保障。
第一步：确认skills/notion/目录结构存在
进到QClaw安装根目录，打开skills文件夹，检查一下有没有notion这个子文件夹，里面必须包含notion_client.py和config.yml这两个文件。如果发现缺失，就得手动从GitHub仓库下载对应版本的notion技能包，解压到这儿。
第二步：获取Notion Integration Token与Database ID
访问Notion的Integration页面，点“New integration”创建一个新集成，名称填个QClaw-V2之类的，关联好工作区。权限这块，记得勾上pages:read、pages:write、databases:read、databases:write这四项。保存之后，页面最上面显示的那串字符就是Integration Token。接着打开目标Notion数据库，点右上角的⋯，选"Copy database link"。把这个链接粘贴到浏览器地址栏，从里面截取xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx格式的一段（共32位含横线），这就是Database ID。
第三步：写入配置并重启
用文本编辑器打开skills/notion/config.yml，把token字段填上刚才的Integration Token，database_id字段填上Database ID，保存文件。然后关闭QClaw主进程，重新启动客户端。这一步千万不能省略——配置变更不会热加载，不重启就白搭了。
第四步：验证连接有效性
在QClaw控制台输入命令：/notion list。等个3秒左右，如果能看到类似[✓] Page: 6月12日复盘 | Status: Done这样三条条目，说明连接成功。提示401 Unauthorized？那就是token无效，或者没授权这个数据库。返回空数组但没报错？说明database_id指向的是一个空库，或者权限不够。
金山文档一键授权（V2智能连接器内置通道）
在QClaw V2里，腾讯文档和金山文档被归到了“国产云文档统一通道”，用的是同一套OAuth2.0授权流程。配置一次就能同时启用两个平台，不用单独去申请什么API密钥，设计得很贴心。
方法一：图形界面快捷授权
打开QClaw主界面，点左下角的「设置」图标，选「应用连接」，在搜索框里输入“金山”。找到「金山文档」卡片，点「立即授权」，浏览器会跳出钱山办公的OAuth登录页。用个人账号登录，勾选上「读取文档列表」「创建与编辑文档」「管理共享权限」三项，点「允许」。回到QClaw界面，状态栏显示绿色对勾就算成功了。
方法二：命令行强制刷新令牌
如果图形授权失败或者令牌过期了，可以在控制台执行：/wps auth --force。终端会输出一个临时授权URL，用浏览器打开它，完成登录授权。页面跳转到success提示后，QClaw会自动提取新的access_token并写入本地凭证库。注意，这个命令会覆盖旧令牌，原来没保存的临时会话会失效。
这里有个小提醒：如果你以前用旧版QClaw配置过金山文档，必须先用/wps logout清除掉残留凭证，否则新授权会被旧的refresh_token拦截，界面一直卡在“正在验证”不动。
跨平台协同场景下的配置联动
想象这样一个场景：你希望QClaw在Notion中新建一个页面后，自动把链接同步到金山文档的某张表格里。要实现这个效果，必须确保两个通道都处于激活状态，而且各自的权限完整。任何一方断开，整条链路都会断掉。
检查方法很简单：
① 查Notion通道健康度：/notion status，看到返回connected, db=active才算就绪。
② 查金山文档通道健康度：/wps status，必须显示authed=true, scopes=full。如果scopes显示partial，说明OAuth授权时漏选了某项权限，得重新走一遍授权流程。
③ 最后做个端到端协同测试：在对话框里输入“小虾，新建Notion页面‘客户反馈汇总’，标题用蓝色加粗，然后把页面链接写进金山文档‘运营看板’第3行第5列”。QClaw会依次调用Notion API创建页面、提取URL、再调用WPS API写入指定单元格。整个过程大概8到12秒，具体看网络状况。
