通过 Composio 连接应用
WenwoBot 通过 Composio 连接 Gmail、Slack、GitHub、Notion、Linear 等数百个应用。只需授权一次,你的机器人就能把它们当作工具使用。WenwoBot 使用一个 Composio 项目 API 密钥和一个可复用的会话,并开启多账户模式:同一个 WenwoBot 可以同时连接多个 Slack、Gmail、日历等账户,而不会悄悄替换掉第一个。
桌面应用中的设置
- 在 Composio 控制台打开你项目的 API Keys 页面(如有提示,先登录或创建项目)。
- 如果项目还没有密钥就新建一个,然后复制它(以
ak_开头)。个人「Sessions & API Key」页面上以ck_开头的是另一种密钥,不能用。 - 在 WenwoBot 中打开 设置 → API 密钥,把它保存到 自建已连接应用服务 → Composio 项目密钥。
- 打开 已连接应用,选择 Gmail、GitHub、Slack 或其他服务。输入一个不重复的标签,例如
工作或个人,然后在你平常用的浏览器里完成授权。 - 要为同一个应用再连接一个账户,选择 添加账户,给它一个不重复的标签,再完成第二次授权。
「已连接」标签页会分别列出每个账户。断开连接 只会撤销该行对应的账户。当有多个账户可以执行同一个工具时,WenwoBot 要求明确选择账户;新的授权永远不会悄悄变成已有连接的默认账户。
桌面应用会在保存前验证密钥。密钥使用操作系统提供的安全存储加密;本地配置文件只保存非机密的 Composio 用户和会话标识。
WenwoBot Cloud
WenwoBot Cloud 套餐已包含已连接应用,无需添加密钥。Cloud 每次启动时会确认自己在 WenwoBot 托管连接服务上有独立的安装记录;服务暂时不可用时,Cloud 仍会正常启动,已连接应用 会提示服务暂不可用,并在稍后自动重试。如果你在 自建已连接应用服务 中保存了自己的 Composio 项目密钥,则以你的密钥为准,不再与托管服务通信;清除密钥后约一分钟内回到托管服务。
应用事件
「应用事件」类自动化会在已连接应用里发生某件事时运行机器人,例如收到新的 Gmail 邮件、Slack 频道里有新消息、HubSpot 的交易阶段变化。
- 在编辑器中保存自动化后,会在托管服务上创建对应的触发器。Gmail 的过滤条件(发件人、主题、标签、关键词)会转换为 Gmail 自己的搜索,其他邮件根本不会传过来。
- 每个事件会在服务上排队保存最多 7 天。
- 只要有开启的自动化,WenwoBot 就会持续获取事件,每个事件变成一次例行任务运行,事件内容会被标记为不可信数据。突发的大量事件会合并处理,每个事件只会运行一次。
- WenwoBot 会定期与服务核对自动化,自动修复差异。连接过期时会显示 需要你处理 和 重新连接。
| 桌面版 | 付费 Cloud | |
|---|---|---|
| 每天(UTC)保留的事件数 | 500 | 2000 |
超出上限的事件不会运行,自动化会显示今天跳过了多少以及原因。Gmail 等轮询类应用每 15 分钟检查一次。使用自己的 Composio 项目密钥时暂不支持监听应用事件,可改用定时检查或 Webhook。