Waker无法调用知识库是因未绑定知识库空间或MCP连接器未完成空间绑定；需在QoderWake后台手动绑定钉钉知识库空间、验证MCP服务状态与凭证、配置知识检索策略并刷新缓存索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake创建Waker后无法调用知识库，说明Waker身份已注册但未获得知识源访问授权，或MCP连接器未完成空间绑定——此时Waker可响应语音指令、执行本地任务，却无法拉取钉钉文档中的制度文件、FAQ、SOP等结构化知识。
确认Waker是否已绑定知识库空间
Waker本身不自动继承企业知识库权限，必须手动在QoderWake管理后台完成空间级绑定。未绑定则所有知识检索请求返回空结果，且无明确报错提示。
登录QoderWake管理后台 → 进入「Waker管理」→ 找到目标Waker卡片 → 点击右上角「编辑」→ 展开「知识源配置」区域 → 检查「钉钉知识库空间」下拉框是否已选择具体空间（如“HR政策中心”或“研发Wiki”）。
若下拉框为空或显示“未配置”，说明尚未完成空间授权。此时需返回钉钉开放平台，确认该Waker所用的Client ID对应的应用，已在「权限管理」中开通「文档管理」并提交审核通过。
验证MCP连接器状态与凭证有效性
方法一：检查MCP Server运行日志
打开终端执行：qoderwake mcp-status → 观察输出中dingtalk-docs-mcp服务状态是否为✅ Running。
若显示❌ Failed或⚠️ Credential expired，说明环境变量注入失败或Client Secret已过期。需重新进入通义灵码IDE → 打开MCP服务配置 → 替换DINGTALK_Client_ID与DINGTALK_Client_Secret为最新值 → 保存后等待状态栏刷新。
【Client Secret泄露将导致企业全部钉钉文档被越权读取】
方法二：手动触发一次同步测试
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
在QoderWake控制台输入命令：/mcp-sync dingtalk-docs --space-id=space_abc123（space_id需替换为实际空间ID）→ 若返回Sync completed: 42 docs indexed，说明连接器工作正常；若报401 Unauthorized，则凭证错误；若报403 Forbidden，说明钉钉侧权限未生效或空间ID填写错误。
检查Waker的知识检索策略配置
第一步：进入Waker详情页 → 点击「策略配置」→ 找到「知识检索」模块
第二步：确认「启用知识库问答」开关已开启，并检查下方「默认知识源」是否选中「钉钉文档」而非「本地文件」或「Web搜索」
第三步：展开「高级过滤」→ 查看「生效空间白名单」字段。若此处填写了具体空间ID（如space_abc123,space_def456），但Waker当前绑定的是space_xyz789，则检索会被静默拦截——清空该字段或补全对应ID即可。
这一步操作起来很简单，直接把空格或逗号分隔的ID列表核对一遍就行。
强制刷新Waker的知识缓存索引
QoderWake为提升响应速度，默认缓存知识库元数据快照。当钉钉文档新增/修改后，缓存可能未及时更新，导致Waker“看不见”最新内容。
在Waker详情页 → 点击右上角「⋯」→ 选择「重建知识索引」→ 等待进度条走完（通常需30–90秒）→ 完成后页面提示「索引重建成功，共加载XX份文档」。
注意：此操作会中断当前所有知识检索请求，建议在低峰期执行。
