连接器
连接器用于管理安装环境中已经配置的外部集成。先查看当前列表和集成说明,再处理对应的启用或认证问题。
查看已配置连接器
进入设置 > 连接器查看名称、描述和启用状态;TUI 使用 /connectors。列表来自主配置中的 connectors 定义,具体项目取决于当前安装和配置。
显示“暂无已配置连接器”时,表示本地没有相应定义。当前页面提供已配置项的刷新和启停,不提供一个通用的连接器商店,也不会仅凭名称自动安装外部服务。

启用与认证的关系
连接器可由安装配置提供首次启动认证命令。当前自动流程只在该数据目录的首次 daemon 启动阶段,对符合条件的启用项执行一次。修改开关、重复启动后台或收到 401 错误,不会自动反复拉起认证助手。
需要重新认证时,按对应集成提供的说明重新完成授权,并确认外部进程或服务已经恢复。旧配置中的 on_enable、on_auth_error 字段仅保留兼容读取,不代表切换开关或报错时会再次执行这些命令。
确定应当配置哪种扩展
| 目标 | 对应功能 |
|---|---|
| 调用远端工具或本地工具服务 | MCP 服务器 |
| 安装可复用的任务流程 | 技能 |
| 在生命周期事件中运行命令 | Hooks |
| 通过消息平台收发任务消息 | 消息渠道与远程控制 |
| 管理安装环境提供的外部集成 | 当前连接器列表及该集成的配置说明。 |
排错时记录连接器名称、触发动作和错误信息,再检查它依赖的程序或服务。启用状态只能说明本地配置允许使用,不能代替对外部服务连通性和认证的确认。