解决需要高效管理个人笔记和知识库的问题，支持对腾讯IMA笔记、知识库的读取、写入、检索等操作。适用于需要随时记录灵感、整理知识库、上传文档资料、建立个人知识体系的场景。接入了OpenClaw生态，8万次下载，腾讯ima官方出品，企业认证安全可靠。

【适用场景】

1. 个人知识管理：需要整理和分类个人笔记，建立知识体系； 2. 文档资料管理：上传PDF、Word等文件到知识库，统一管理； 3. 内容创作素材收集：把网页链接、文档等资料存入知识库便于后续调用； 4. 团队知识共享：通过知识库管理团队共享资料和文档。

【操作步骤】

第一步：配置凭证 使用ima-skills前需要配置Client ID和API Key： 1. 打开 https://ima.qq.com/agent-interface 获取Client ID和API Key 2. 创建配置文件： mkdir -p ~/.config/ima echo "your_client_id" > ~/.config/ima/client_id echo "your_api_key" > ~/.config/ima/api_key 或设置环境变量： export IMA_OPENAPI_CLIENTID="your_client_id" export IMA_OPENAPI_APIKEY="your_api_key"

第二步：理解模块决策 ima-skills有两个主要模块，根据用户意图选择对应模块：

笔记模块（notes）： - 搜索笔记、浏览笔记本 - 获取笔记内容 - 创建笔记、追加内容

知识库模块（knowledge-base）： - 上传文件、添加网页链接 - 搜索知识库、浏览知识库内容 - 获取知识库信息

第三步：常用操作 列出笔记本： 调用 notes/list_docs 获取笔记本列表

创建新笔记： 调用 notes/import_doc，传入标题和正文内容

追加内容到已有笔记： 先搜索笔记获取note_id，再用 notes/append_doc 追加内容

上传文件到知识库： 调用 knowledge-base/create_media 上传文件

添加网页链接到知识库： 调用 knowledge-base/add_knowledge 添加链接

【代码模板】

凭证检查

Agent运行命令检查凭证是否配置： test -f ~/.config/ima/client_id && test -f ~/.config/ima/api_key && echo "凭证已配置" || echo "需要配置凭证"

凭证配置（首次使用）

mkdir -p ~/.config/ima echo "your_client_id" > ~/.config/ima/client_id echo "your_api_key" > ~/.config/ima/api_key

凭证通过环境变量（临时）

export IMA_OPENAPI_CLIENTID="your_client_id" export IMA_OPENAPI_APIKEY="your_api_key"

列出笔记本

node ima_api.cjs openapi/list_docs '{"limit":10}'

创建笔记

node ima_api.cjs openapi/import_doc '{"title":"标题","content":"正文"}'

追加内容到笔记

node ima_api.cjs openapi/append_doc '{"note_id":"xxx","content":"追加内容"}'

【复盘要点】

1. 凭证必须配置：使用前需要在ima.qq.com/agent-interface获取Client ID和API Key，缺少凭证会导致API调用失败； 2. 笔记vs知识库要分清：操作目标是笔记内容（读、写、追加）用笔记模块；操作目标是知识库条目（上传文件、添加链接）用知识库模块； 3. UTF-8编码强制要求：调用笔记写入API前，所有字符串字段（content、title）必须验证为合法UTF-8，非法编码会导致乱码且无法修复； 4. 跨模块任务要读两个模块：如果任务同时涉及笔记和知识库，必须先读取两个子模块的说明再操作； 5. PowerShell环境特殊处理：PowerShell 5.1下会将请求Body从UTF-8转为GBK，必须使用UTF-8字节数组模式发送请求。

来源：SkillHub https://skillhub.cn/skills/ima-skills