OpenClaw 进阶指南：ima-skills 来了，让 AI 帮你管笔记只需一句话

发表于 更新于 分类于 阅读次数： 本文字数： 4.8k 阅读时长 ≈ 4 分钟

cover

你每天产生多少条笔记？

会议纪要、灵感碎片、待办事项、读书摘录……这些东西散落在各个 App 里，找起来要命。你明明记了一条重要笔记，但就是不记得存在哪个笔记本里了。

现在，你可以对你的 OpenClaw 说一句：**”帮我找一下上周关于项目排期的笔记”**。

几秒钟后，它把笔记标题、摘要、修改时间整理好了，问你要不要看正文。

这就是 ima-skills——一个把 IMA 笔记和 OpenClaw 打通的 Skill。今天这篇文章，教你怎么安装、配置，以及怎么玩出花来。

先搞清楚：OpenClaw 的 Skills 是什么？

如果你刚接触 OpenClaw，可能对 Skills 这个概念还不太熟。

Skills 是 OpenClaw 的”技能插件”。 每个 Skill 就是一个 Markdown 文件（SKILL.md），里面写了 AI 应该怎么执行某类任务——调用什么 API、传什么参数、返回什么结果。

打个比方：OpenClaw 本身就像一个聪明但什么都不会的新员工。Skills 就是你给它的”操作手册”——装了 Gmail Skill，它就会处理邮件；装了 Obsidian Skill，它就会管理你的知识库；装了 ima-skills，它就会操作你的 IMA 笔记。

截至 2026 年 3 月，ClawHub（OpenClaw 的技能市场）上已经有超过 13,000 个 社区构建的 Skills。从控制 Spotify 播放到管理杂货清单，从搜索网页到自动化工作流——几乎你能想到的事情，都有人做了对应的 Skill。

ima-skills 是什么？

ima-skills 是由开发者 iampennyli 发布的一个 OpenClaw Skill，专门用来通过 IMA OpenAPI 管理你的个人笔记。

仓库地址：https://clawhub.ai/iampennyli/ima-skills

它支持的功能包括：

功能 说明
搜索笔记 按标题或正文内容搜索
浏览笔记本 列出所有笔记本和里面的笔记
读取笔记 获取笔记的完整正文
新建笔记 创建一篇新笔记，可以指定笔记本
追加内容 往已有笔记里追加新内容

简单说：你的 IMA 笔记，现在可以用自然语言来管理了。

手把手安装配置

第一步：安装 Skill

在你的 OpenClaw 里安装 ima-skills：

1
claw install iampennyli/ima-skills

第二步：获取 API 凭证

打开 https://ima.qq.com/agent-interface，登录后获取你的 Client ID 和 API Key。

第三步：配置环境变量

把凭证写到你的 Shell 配置文件里：

1
2
3
4
5
6
# 添加到 ~/.zshrc 或 ~/.bashrc
export IMA_OPENAPI_CLIENTID="your_client_id"
export IMA_OPENAPI_APIKEY="your_api_key"

# 生效
source ~/.zshrc

第四步：验证

重启 OpenClaw 会话（新装的 Skill 需要重启才会生效），然后试试：

1
"帮我列出所有笔记本"

如果能看到你的笔记本列表，就说明配置成功了。

5 个实用场景

装好了 ima-skills，怎么用才能发挥最大价值？给你 5 个实战场景。

场景一：快速查找笔记

你记得上周写了一条关于”项目排期”的笔记，但不记得放在哪个笔记本里。

直接对 OpenClaw 说：

1
"帮我搜索标题包含'项目排期'的笔记"

OpenClaw 会调用 search_note_book 接口，按标题搜索，返回匹配的笔记列表（标题、摘要、修改时间）。找到之后再说：

1
"帮我看一下这篇笔记的正文"

两句话，搞定。以前你要打开 App、翻笔记本、搜索、点开——至少四五步操作。

场景二：会议纪要秒存

开完会，你对 OpenClaw 说：

1
2
3
4
"新建一篇笔记，标题是'3月18日产品周会'，内容是：
1. 本周完成了用户中心改版
2. 下周重点：支付流程优化
3. 待确认：第三方登录接口方案"

OpenClaw 调用 import_doc 接口，用 Markdown 格式写入。你还可以指定存到哪个笔记本：

1
"存到'工作笔记'笔记本里"

场景三：渐进式记录

有些笔记不是一次写完的——比如读书笔记、学习日志。你可以随时追加内容：

1
2
3
"帮我在'Go 语言学习笔记'里追加一段：
## goroutine 调度模型
Go 使用 GMP 模型进行协程调度..."

OpenClaw 调用 append_doc 接口，自动追加到笔记末尾。你不需要打开 App、找到笔记、滚到底部、开始编辑——一句话搞定。

场景四：笔记整理

你的笔记本越来越多，想看看每个笔记本里有什么：

1
"列出所有笔记本，以及每个笔记本里有多少篇笔记"

OpenClaw 会调用 list_note_folder_by_cursor 接口，把笔记本名称和笔记数量列出来。你可以快速了解自己的笔记分布情况，决定要不要做整理。

场景五：跨平台信息归档

这是 OpenClaw 最强大的玩法之一：把不同来源的信息自动归档到笔记里。

比如你同时装了 Web Search Skill 和 ima-skills。你可以说：

1
2
"搜索一下最近关于 Rust 异步运行时的技术文章，
把结果摘要整理成一篇笔记，存到'技术收藏'笔记本里"

OpenClaw 先调用搜索工具，找到文章，提取摘要，然后自动调用 ima-skills 的 import_doc 接口存入笔记。

这就是 Skills 组合的威力——一个 Agent，多个技能，完成跨工具的工作流。

技术细节：API 设计一览

如果你是开发者，想了解 ima-skills 的底层实现，这里是核心 API 的快速参考。

所有请求统一为 HTTP POST + JSON Body，Base URL 为 https://ima.qq.com/openapi/note/v1：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 辅助函数
ima_api() {
  local endpoint="$1" body="$2"
  curl -s -X POST "https://ima.qq.com/openapi/note/v1/$endpoint" \
    -H "ima-openapi-clientid: $IMA_OPENAPI_CLIENTID" \
    -H "ima-openapi-apikey: $IMA_OPENAPI_APIKEY" \
    -H "Content-Type: application/json" \
    -d "$body"
}

# 搜索笔记
ima_api "search_note_book" \
  '{"search_type": 0, "query_info": {"title": "会议纪要"}, "start": 0, "end": 20}'

# 读取正文
ima_api "get_doc_content" \
  '{"doc_id": "目标docid", "target_content_format": 0}'

# 新建笔记
ima_api "import_doc" \
  '{"content_format": 1, "content": "# 标题\n\n正文内容"}'

# 追加内容
ima_api "append_doc" \
  '{"doc_id": "笔记ID", "content_format": 1, "content": "\n## 补充\n\n追加文本"}'

几个注意事项：

  • 写入只支持 Markdown 格式（content_format: 1），读取推荐纯文本格式（target_content_format: 0）
  • 分页机制：笔记本列表首页 cursor: "0"，笔记列表首页 cursor: ""
  • 隐私规则：群聊场景中只展示标题和摘要，不展示笔记正文
  • 大小限制：超限会返回错误码 100009，可以拆分为多次 append_doc
  • UTF-8 编码：所有写入内容必须是 UTF-8 编码，外部来源内容写入前需要转码

OpenClaw Skills 安装的安全提醒

在兴冲冲地装各种 Skill 之前，有一件事必须说：安全。

2026 年初的安全审计显示，ClawHub 上大约 13.4% 的 Skills 存在安全问题——恶意代码、提示注入、暴露 API Key 等。虽然 ClawHub 在 2026 年 2 月集成了 VirusTotal 自动扫描，但这不代表你可以闭着眼睛装。

安装任何 Skill 前，建议你：

  1. 查看作者和维护情况：看看这个 Skill 的作者是谁、有没有持续更新、有没有 Issue 被修复
  2. 看 ClawHub 的 VirusTotal 报告：每个 Skill 页面上都有安全扫描结果
  3. 阅读 SKILL.md：了解它会调用什么 API、需要什么权限、会访问你的什么数据
  4. 不要给不必要的权限：OpenClaw 的 tools.allow 配置可以限制 Skill 能调用哪些工具

尤其注意那些需要你提供 API Key 或者访问敏感数据的 Skills。 ima-skills 需要你的 IMA 凭证，这意味着装了它之后，OpenClaw 就有权读写你的所有笔记。确保你信任这个 Skill 的来源。

ClawHub 上还有什么好用的 Skills？

既然在聊进阶用法，顺便推荐几个跟 ima-skills 搭配使用效果很好的 Skills：

Skill 功能 下载量
GOG（Google Workspace） Gmail、日历、Drive、文档一站式管理 14,000+
Capability Evolver AI 自动优化自身能力 35,000+
Web Search 网页搜索，让 Agent 获取实时信息 高
Obsidian 管理 Obsidian 知识库 中
Apple Notes 管理 Apple 备忘录（仅 Mac） 中

推荐组合：Web Search + ima-skills = 搜索信息 → 自动存入笔记。这个工作流在信息收集场景下非常实用。

写在最后

OpenClaw 的 Skills 生态是它最大的竞争优势之一。13,000 多个 Skills，覆盖了从消息通讯到智能家居的几乎所有场景。

ima-skills 填补了一个重要的缺口——笔记管理。 对于那些用 IMA 做日常记录的用户来说，能用自然语言搜索、创建、追加笔记，效率提升是肉眼可见的。

更重要的是，当你把 ima-skills 和其他 Skills 组合起来使用，OpenClaw 就不只是一个笔记工具了——它变成了你的个人信息中枢。搜索到的文章自动存笔记，会议纪要一句话归档，学习心得随时追加。

这就是 AI Agent 的真正价值：不是替你做一件事，而是帮你把多件事串起来。

装好 ima-skills，从一句”帮我搜索上周的笔记”开始。你会发现，以前觉得麻烦的事情，现在一句话就搞定了。

你在用 OpenClaw 的时候，装了哪些 Skills？有没有发现什么宝藏 Skill？或者你自己开发了 Skill？欢迎评论区分享你的 OpenClaw 技能栈。