国内应用接入
腾讯 ima Skill 接入：搜索知识库并管理笔记
OpenClaw Launch 会把腾讯官方 ima Skill 的审核固定版本装进您选择的 OpenClaw 或 Hermes 机器人；配置自己的 Client ID 与 API Key 后，即可搜索笔记和知识库，并在确认后执行写入。
ima 接入为什么使用官方 Skill？
腾讯发布的是面向 Agent 的官方 ima Skill 包，而不是由 OpenClaw Launch 代理的通用 MCP 服务。安装器会选择当前机器人对应的持久化 Skill 目录，并把上游包适配到 OpenClaw 或 Hermes 的路径。
当前安装固定在审核过的 1.1.8 版本，只允许访问 ima.qq.com 下已审核的笔记与知识库接口，并禁用包内远程自动更新指令。后续官方版本需要重新审核后才会进入安装流程。
接入后可以做什么？
- 搜索与读取笔记：按关键词查找 ima 内容，并读取匹配笔记，适合研究回顾和问答。
- 创建与追加笔记：在确认目标和正文后新建笔记，或向已有笔记追加内容。
- 查询知识库：读取您有权限访问的知识库信息，并基于其中内容检索资料。
- 导入知识库：在明确确认来源与目标后，把支持的内容导入指定知识库。
ima Client ID 与 API Key 怎么配置？
请在腾讯官方 Agent 接口页面生成自己的 Client ID 与 API Key，再通过 OpenClaw Launch 的 ima 连接窗口提交。平台会在本次请求中处理凭证，并直接写入目标机器人的持久化 credentials/ima 目录，但不会把原始凭证保存到平台数据库。
- 选择目标机器人 — 先在 OpenClaw Launch 中部署或打开要使用的 OpenClaw 或 Hermes 实例。
- 安装审核固定版本 — 在国内应用列表选择 ima，执行固定安装命令；安装器会校验官方 1.1.8 包的 SHA-256 后再事务替换。
- 生成自己的接口凭证 — 访问 ima.qq.com/agent-interface，在腾讯官方页面生成 Client ID 与 API Key。
- 通过连接窗口安全写入 — 在 ima 连接窗口选择目标机器人并填写凭证。平台会校验后写入机器人的持久化目录；不要把 API Key 发到机器人聊天或群聊里。
- 从只读搜索开始 — 先搜索一条熟悉的笔记或知识库内容，确认权限边界和结果正确，再尝试创建、追加或导入。
连接后可以直接这样问
- “搜索 ima 里关于本季度产品规划的笔记，只列标题和摘要”
- “读取刚才找到的那篇笔记并整理出行动项”
- “先展示准备追加的内容和目标笔记，等我确认后再写入”
使用前必须知道的限制
可见内容取决于您的 ima 账号、知识库成员权限和腾讯接口当前规则。当前安全固定版本为 1.1.8，不会自动升级；官方包更新后需重新审核。Skill 能力以已审核的笔记与知识库接口为限，不代表 ima 客户端的全部功能。
知识库可能包含内部资料，给机器人授权前应检查成员范围。创建、追加笔记或导入知识库前，先让机器人展示目标与内容并明确确认；API Key 只填写在 ima 连接窗口，不要发进机器人聊天、工单或群聊。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接腾讯 ima的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行下载并审计腾讯官方 Skill，适配 OpenClaw/Hermes 路径，校验包哈希，限制域名和接口，维护持久化凭证目录与版本升级审查。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。
腾讯 ima接入常见问题
ima 接入是 MCP 还是 Skill？
腾讯当前提供的是官方 Agent Skill 包。页面保留常用的 “ima MCP” 搜索叫法，但实际安装的是审核固定版官方 Skill。
OpenClaw 和 Hermes 都支持吗？
支持。安装器会识别当前机器人类型，并选择对应的持久化 Skill 与凭证目录。
OpenClaw Launch 会保存我的 API Key 吗？
平台会在连接请求期间短暂处理凭证，并把它写入所选机器人的持久化目录；平台数据库不会保存原始 Client ID 或 API Key 副本。
Skill 会自动更新吗？
不会。当前安装固定在已审核的 1.1.8，远程自动更新指令已禁用，新版本需重新审核。