别再复制粘贴了：让 WorkBuddy 直接读写你的 IMA 知识库
原文作者：Mocha · 原文来源：今日头条
本文为作者本人文章的站内同步版本。
写东西的时候，你大概经历过这种场景——
跟 AI 聊到一半，想引用知识库里某篇文档的内容，于是切到 IMA，翻半天找到文件，复制，切回来，粘贴。聊着聊着又看到一篇好文章想存起来，再切到 IMA，点上传，选知识库，等它转圈……
来回切了三四次，思路全断了。
其实这事可以简单很多。通过 IMA Skill，WorkBuddy 能直接读写你的知识库——搜资料、存网页、传文件、建笔记，在对话里一句话就办了。
配置全程不到 10 分钟，往下看。
接通之后，能干嘛？
先说结论。配好之后，你跟 WorkBuddy 说话的方式不变，但它背后多了一双能翻知识库的手：
-
搜资料 — "知识库里有没有讲 RAG 的内容？" → AI 直接检索，返回带高亮的摘要
-
存网页 — "把这篇 https://xxx 存到 AIGC 知识库" → 自动抓取、入库
-
传文件 — "把这个 PDF 传到技术文档库" → 自动完成类型检查和上传
-
建笔记 — "建一篇笔记记录今天的会议要点" → 直接在 IMA 里生成
-
翻目录 — "架构师知识库里都有些啥" → 列出文件夹和文件清单
全程不用打开 IMA 客户端。
动手之前，先准备两样东西
1. WorkBuddy 本体
没装的话先去官网下载。
装好打开，能正常对话就行。
2. IMA 的两把钥匙
IMA 开放接口需要两个凭证：Client ID（应用标识）和 API Key（接口密钥）。
去这里拿：https://ima.qq.com/agent-interface，也可以点击ima左上角头像，选择“Claw配置”，ima会直接帮你打开。
按页面提示走完，你会拿到两串字符。
⚠️ API Key 等同于你知识库的钥匙，别截图发群、别提交到 Git。万一泄露了，回上面的页面重新生成一个就行，旧的会自动失效。
两个值都记好，马上要用。
第一步：装 IMA Skill
IMA Skill 本质是个"技能包"——它教会 WorkBuddy 怎么调用 IMA 的接口。
下载
官方下载地址：
https://app-dl.ima.qq.com/skills/ima-skills-1.1.7.zip最省事的做法：直接把刚刚在安装指引里复制的链接甩给 WorkBuddy，跟它说——
"帮我安装 ima 技能，下载地址是 https://app-dl.ima.qq.com/skills/ima-skills-1.1.7.zip"
剩下的它自己处理。
安全审计（自动跑，不用管）
WorkBuddy 装第三方技能之前会先做一轮安全体检，你等着就行。检查项包括有没有恶意代码、数据会不会外泄、凭证传输安不安全、有没有调用危险函数、网络请求是不是只发往可信域名。
IMA Skill 的体检报告长这样：
检查项
结果
恶意代码
✅ 无
数据外泄
✅ 无
凭证安全
✅ 仅发往 ima.qq.com
危险函数
✅ 无 eval / exec
第三方依赖
✅ 零依赖，纯 Node.js 内置模块
网络端点
✅ 仅 ima.qq.com 和腾讯云 COS
评级 P2（安全），放心装。
装好了
审计过了就自动装上，所有项目通用。
第二步：填入 API Key
技能装好了，但它还不认识你。得把刚才拿到的凭证喂给它。
推荐用配置文件的方式——比环境变量稳，重启不丢。
操作很简单：把 Client ID 和 API Key 直接发给 WorkBuddy，比如——
"API Key: 你的APIKey Client ID: 你的ClientID"
它会自动帮你写到这两个文件里：
~/.config/ima/client_id ← Client ID~/.config/ima/api_key ← API Key
如果你更习惯环境变量，设这两个也行：
IMA_OPENAPI_CLIENTID = 你的ClientIDIMA_OPENAPI_APIKEY = 你的APIKey两种方式选一个就好，配置文件优先级更高。
第三步：验一下，通没通
配完建议跑个测试。跟 WorkBuddy 说：
"帮我看看我有哪些知识库"
通了的话，它会返回你的知识库清单，大概长这样：
你的知识库列表：1. langchain.js — 共享知识库（30 篇）2. Mocha的知识库 — 个人知识库（1 篇）3. 架构师 — 共享知识库（1 篇）4. AIGC — 共享知识库（5 篇）...
看到列表就成了。
要是报错，大概率是这几个原因：
-
Client ID 或 API Key 没复制全（看看首尾有没有多空格）
-
API Key 里有特殊字符，粘贴时被截断了
-
网络访问不了 ima.qq.com
配好了，来玩：5 个真实场景
场景一：搜知识库
"搜一下知识库里有没有关于 RAG 的内容"
AI 会跨知识库检索，返回带高亮摘要的结果：
搜索「RAG」的结果：1. RAG架构实践笔记.pdf（文件夹：技术文档/） > ...基于 RAG 的检索增强生成方案...2. LangChain入门指南.md（文件夹：学习笔记/） > ...使用 RAG 链实现知识库问答...
场景二：往知识库存网页
刷到一篇好文，想攒下来？把链接丢给它：
"把这篇网页添加到 架构师 知识库：https://juejin.cn/post/7065112165220352007?searchId=2026072010455615E1B49A4E8382867143"
它自动抓内容、存进去。
场景三：上传文件
"把这个文件上传到 架构师 知识库，系统架构设计师重难点默写本（2024年最新）10.10改.pdf"
类型检查、重名检查、上传、入库，一条龙自动跑完。
场景四：建笔记
"帮我新建一篇笔记，标题叫'本周工作总结'，内容是……"
直接在 IMA 里生成笔记，还能顺手归档进知识库。
场景五：翻目录
"看看langchain.js知识库里都有哪些文件"
文件夹、文件一览无余：
一些你可能会问的
**API Key 泄露了怎么办？**回 https://ima.qq.com/agent-interface 重新生成，旧 Key 自动作废，然后在 WorkBuddy 里重配一遍。
支持哪些文件格式？
类型
格式
大小上限
文档
PDF、Word、PPT
200 MB
表格
Excel、CSV
10 MB
文本
Markdown、TXT
10 MB
图片
PNG、JPEG、WebP
30 MB
思维导图
Xmind
10 MB
音频
MP3、M4A、WAV、AAC
200 MB（≤2 小时）
**视频能传吗？**B 站、YouTube 这类视频暂不支持通过 Skill 添加，得用 IMA 桌面客户端。
**重启电脑后要重配吗？**不用。配置文件方式是持久的，重启依然在。
**多个项目都能用吗？**能。技能装在用户级目录，所有项目共享。
最后说两句
配完这套东西之后，你会发现一个变化——
你的 AI 助手不再只是个"聊天框"，它开始能碰到你的知识库了。想查什么，问它；想存什么，丢给它。省下来的那些切换、复制、等待的时间，才是这套配置真正值钱的地方。
配置过程中卡住了也别急，把报错原样发给 WorkBuddy，它自己会排查。
去试试吧。