必须完成notion或金山文档的授权与技能配置才能实现ai自动操作，跳过任一环节会导致指令失败；notion需配置integration token和database id并重启qclaw，金山文档支持图形界面或命令行oauth授权，跨平台协同需双通道均激活且权限完整。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在QClaw V2中让AI自动创建、读取或更新Notion或金山文档里的内容，必须完成对应应用的授权与技能配置，跳过任一环节都会导致指令执行失败，比如“把日报存到Notion”后界面卡住无响应。
Notion直连配置（OpenClaw Skills方式）
这是延迟最低、权限最细的接入方式，适合需要双向同步、频繁调用数据库字段的用户。它不依赖外部中继服务，所有操作在本地Agent内闭环完成。
第一步：确认skills/notion/目录结构存在
进入QClaw安装根目录→打开skills→检查是否存在notion子文件夹，且其中包含notion_client.py与config.yml两个文件。若缺失，需手动从官方GitHub仓库下载对应版本的notion技能包并解压至此路径。
第二步：获取Notion Integration Token与Database ID
访问https://www.php.cn/link/3cdd5d87d8de847170314268ced43126→点击“New integration”→填写名称（如QClaw-V2），选择关联工作区→在Permissions中勾选pages:read、pages:write、databases:read、databases:write→保存后复制页面顶部显示的【Integration Token】；再打开目标Notion数据库→点击右上角⋯→选择“Copy database link”→粘贴到浏览器地址栏，从中截取xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx格式的ID部分（共32位含横线），这就是【Database ID】。
第三步：写入配置并重启
用文本编辑器打开skills/notion/config.yml→将token字段填入Integration Token值，database_id字段填入上一步获取的ID→保存文件→关闭QClaw主进程→重新启动客户端。这一步不可跳过，配置变更不会热加载。
第四步：验证连接有效性
在QClaw控制台输入命令：/notion list→等待3秒内返回三条类似[✓] Page: 6月12日复盘 | Status: Done的条目。若提示401 Unauthorized，说明token无效或未授权该数据库；若返回空数组但无报错，说明database_id指向的是一个空库或权限不足的私有库。
金山文档一键授权（V2智能连接器内置通道）
腾讯文档和金山文档在QClaw V2中被归为“国产云文档统一通道”，使用同一套OAuth2.0授权流程，配置一次即可同时启用两者，无需单独申请API密钥。
OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、PARA三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup o...
方法一：图形界面快捷授权
打开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秒之间，取决于网络波动。
