通过 Composio 为 Hermes Agent 和 OpenClaw 接入 NotebookLM

Read in English

先确认您使用的是哪个版本的 NotebookLM

Composio 的 notebook_lm 工具包连接的是 NotebookLM Enterprise，Google 现称其为 Gemini Notebook Enterprise。它访问 Google Cloud 项目中的笔记本。只有个人版 NotebookLM 账号或 Google AI 订阅还不够，个人版笔记本也不会自动出现在这个连接中。

Google：Gemini Notebook Enterprise 产品说明

连接前需要准备什么

• 已启用结算和 Discovery Engine API 的 Google Cloud 项目。
• 管理员已配置项目的身份提供方，为您的账号授予 Cloud NotebookLM User 角色，并分配对应区域的企业版许可证。
• 对该项目和笔记本有访问权限的 Google 账号。请记下 Google Cloud 中的数字项目编号；笔记本 API 的资源路径使用这个编号。
• 与连接器 global 位置兼容的部署。Composio 目前将此工具包描述为仅用于 global 位置；Google 提供 US/EU 选项，并不代表此连接器也支持这些选项。

Google Cloud 配置说明 · 企业版许可证说明

在 Composio 中授权 NotebookLM

1. 打开您自己的 Composio 项目，选择 NotebookLM 工具包，标识为 notebook_lm。默认选择 Composio 托管 OAuth；如果组织要求使用自己的 OAuth 应用，则按管理员的要求配置。
2. 通过该工具包专用的连接流程填写 Google Cloud Project ID or Number。请填写要访问的企业版项目编号。这个项目字段与 Composio API key 是两回事。
3. 打开生成的 Connect Link，使用已获得许可证的 Google 账号登录，并检查授权范围。托管 OAuth 默认提供 OAuth 应用，无需自行注册客户端。
4. 确认连接账号的状态为 ACTIVE。MCP 配置与连接账号必须属于同一个 Composio 项目，并使用相同的用户 ID。其他身份下创建的连接不会自动提供给当前机器人。

2026 年 10 月 3 日检查的工具包元数据要求提供名为 prefix.one 的连接字段，显示名称为 Google Cloud Project ID or Number。如果连接页面没有这个字段，请使用 Composio 的工具包专用流程，或询问 Composio 支持团队如何填写。反复进行 Google 授权不会补上缺失的项目信息。

NotebookLM 工具包与当前工具列表 · Composio 托管 OAuth 说明 · 连接账号配置说明

在 OpenClaw Launch 上使用

Hermes Agent 和 OpenClaw 共用 OpenClaw Launch 的应用集成目录。可以在其中搜索 NotebookLM。目前通用的托管 OAuth 流程没有收集必需的 Google Cloud 项目字段，因此看到目录条目并不代表企业版连接已能一键完成。

查看应用集成

通过 MCP 连接自行部署的机器人

在同一个 Composio 项目中，为 notebook_lm 创建单工具包 MCP 配置，并选用对应的授权配置。生成 MCP URL 时，使用拥有 ACTIVE 连接账号的同一个用户 ID。复制生成的完整 URL，并将自己项目的 API key 用作 x-api-key。请妥善保管这两项信息。

Composio 单工具包 MCP 配置说明

Hermes Agent

把自己的 key 存入 ~/.hermes/.env 中的 COMPOSIO_API_KEY。将下方配置合并到 ~/.hermes/config.yaml 的 mcp_servers 下，保留已有服务器。把 URL 占位符换成 Composio 生成的 MCP URL；Hermes 会在连接时读取请求头中的环境变量。

mcp_servers:
  composio:
    url: "YOUR_GENERATED_COMPOSIO_MCP_URL"
    headers:
      x-api-key: "${COMPOSIO_API_KEY}"
    connect_timeout: 60
    timeout: 180

运行下方命令开始新会话，或在已有会话中输入 /reload-mcp。这个步骤加载 MCP 工具，不会替代前面完成的 Google 账号授权。

hermes chat

Hermes MCP 配置文档

OpenClaw

请使用包含 mcp CLI 的新版 OpenClaw。将 URL 和 key 占位符替换为自己的值，并避免把 key 留在共享的命令历史中。probe 检查 MCP 工具发现是否正常；检查成功并不代表 Google 账号已有项目访问权限。

openclaw mcp add composio \
  --url "YOUR_GENERATED_COMPOSIO_MCP_URL" \
  --transport streamable-http \
  --header x-api-key=YOUR_COMPOSIO_PROJECT_API_KEY
openclaw mcp probe composio

OpenClaw MCP 注册命令文档

先用只读请求验证连接

让机器人使用空输入对象调用 NOTEBOOK_LM_LIST_RECENT_NOTEBOOKS。它最多返回 500 个最近查看的笔记本，并非组织全部笔记本的清单。如果没有最近查看的笔记本，成功返回空列表也可能是正常结果。

使用 Composio 的 notebook_lm 工具包列出我最近查看的企业版笔记本，只返回标题和笔记本 ID。不要创建、修改、共享或删除任何内容。如果缺少授权或项目上下文，请显示完整错误和需要完成的连接步骤。

连接器目前能做什么

• 创建、读取、共享和删除笔记本，以及列出最近查看的笔记本。
• 添加原始文本来源、上传纯文本文件、检查来源处理状态，以及读取或删除来源。
• 创建或删除音频概览。生成过程是异步的：任务已开始，不代表音频已生成并可下载。

目前目录列出 11 个工具，没有笔记本问答或聊天操作。文件上传工具接受 text/plain，不能因为 NotebookLM 网页支持 PDF 或 Google Drive，就认为此工具也支持。执行写入、共享或删除操作前，请确认笔记本和来源 ID。

常见连接问题

常见问题

继续阅读

• Hermes Agent + Composio 配置（英文）
• OpenClaw + Composio 配置（英文）
• Google Docs 接入指南（英文）
• Hermes 托管服务（英文）