连接器 | Open Design Docs

「连接器」用于把 Open Design 和外部账号、业务系统或工具服务连接起来。当前设置页通过 Composio 管理连接器：先保存 Composio API 密钥，再从目录中搜索、连接或断开具体服务。

连接器可以理解为「让 Open Design 使用外部服务的一层授权」。例如连接 GitHub、Slack、日历、CRM、表格或其他业务工具后，Open Design 在相关任务中就可以调用这些服务提供的工具能力。

当你希望生成任务读取外部资料、查询业务系统、使用协作工具或调用第三方平台能力时，就会用到连接器。连接器通常需要外部平台确认授权，授权完成后才会显示为已连接。

使用前，请准备 Composio API 密钥，并确认你有权把对应外部账号连接到当前 Open Design 环境。涉及业务数据时，应按团队的数据和账号使用规范选择要连接的服务。

Composio API 密钥

连接器目录需要先配置 Composio API 密钥。设置页顶部会显示「Composio API 密钥」输入框，以及「获取 API 密钥」「保存密钥」「清除」等操作。

状态	页面表现	说明
未配置	下方目录被遮罩，并提示添加 Composio API 密钥	粘贴密钥后点击「保存密钥」
正在读取	输入框显示正在从本地 daemon 检查已保存密钥	等待读取完成后再保存或清除
已保存	标记为「已保存」或显示密钥末 4 位	密钥已保存在本地 daemon 中
已保存且正在替换	已保存标记保留，输入框中有新密钥草稿	点击「保存密钥」后才会替换

密钥不会随设置页的普通自动保存一起发送。只有点击「保存密钥」或在密钥输入框中按 Enter 时，才会把完整密钥交给本地 daemon 保存。页面重新打开时只会读取「是否已配置」和密钥末 4 位，不会回显完整密钥。

Composio API 密钥是 Open Design 访问 Composio 连接器平台的凭证。Open Design 通过它加载可用连接器目录、创建授权配置，并为具体外部服务发起登录或 OAuth 授权流程。

只有需要使用连接器时才需要配置它。没有密钥时，连接器列表会保持锁定；保存密钥后，目录、搜索、服务详情和连接按钮才会可用。

使用前，请在 Composio 控制台获取 API 密钥，并确认这个密钥属于你希望使用的团队或账号。更换密钥会重置旧密钥对应的连接器授权。

连接过程中如果页面显示「等待授权中」，请在已打开的浏览器窗口中完成授权。误点或不想继续时，可以点击「取消」取消本次授权。

服务详情抽屉会显示「简介」「详情」和「工具」。工具数量可能先显示概要，打开详情后再加载更多工具。

点击「清除」会进入两步确认。确认后，本地 daemon 会删除已保存的 Composio API 密钥，并移除依赖该密钥的 Composio 连接器授权。之后需要重新粘贴新密钥，并重新连接每个服务。

如果只是换新密钥，直接在输入框粘贴新密钥并点击「保存密钥」即可。保存新密钥后，旧密钥下的 Composio 授权也会被重置。

问题	处理方式
下方连接器目录不能点击	先保存 Composio API 密钥，等目录解锁后再操作
看不到完整的已保存密钥	这是正常行为。页面只显示是否已保存和末 4 位，完整密钥保存在本地 daemon
保存密钥失败	确认 Open Design 的本地 daemon 正在运行，然后重新打开设置页再试
授权页面没有打开	检查浏览器是否拦截弹窗；也可以重新点击「连接」
连接后任务没有使用它	在任务描述中明确说明要使用哪个连接器，或在支持的输入入口中选择对应连接器
连接器和 MCP 有什么区别	连接器偏向连接外部账号；MCP 偏向把工具服务器接入编码智能体或把 Open Design 暴露给外部工具