连接器

连接器用于管理安装环境中已经配置的外部集成。先查看当前列表和集成说明,再处理对应的启用或认证问题。

本页内容

查看已配置连接器

进入设置 > 连接器查看名称、描述和启用状态;TUI 使用 /connectors。列表来自主配置中的 connectors 定义,具体项目取决于当前安装和配置。

显示“暂无已配置连接器”时,表示本地没有相应定义。当前页面提供已配置项的刷新和启停,不提供一个通用的连接器商店,也不会仅凭名称自动安装外部服务。

连接器列表中的名称、用途、已关闭状态、开关和刷新入口
已配置连接器显示名称、用途、开关和刷新入口。截图中的两个连接器处于关闭状态。Windows 实际界面 · 点击图片查看原图

启用与认证的关系

连接器可由安装配置提供首次启动认证命令。当前自动流程只在该数据目录的首次 daemon 启动阶段,对符合条件的启用项执行一次。修改开关、重复启动后台或收到 401 错误,不会自动反复拉起认证助手。

需要重新认证时,按对应集成提供的说明重新完成授权,并确认外部进程或服务已经恢复。旧配置中的 on_enable、on_auth_error 字段仅保留兼容读取,不代表切换开关或报错时会再次执行这些命令。

确定应当配置哪种扩展

目标对应功能
调用远端工具或本地工具服务MCP 服务器
安装可复用的任务流程技能
在生命周期事件中运行命令Hooks
通过消息平台收发任务消息消息渠道与远程控制
管理安装环境提供的外部集成当前连接器列表及该集成的配置说明。

排错时记录连接器名称、触发动作和错误信息,再检查它依赖的程序或服务。启用状态只能说明本地配置允许使用,不能代替对外部服务连通性和认证的确认。

搜索全部帮助文档