专家连接器嵌套于专家生命周期管理中,不可独立启停;每个专家默认绑定预定义连接器,初始化时自动加载且不支持热插拔;配置修改需编辑对应config.yaml并执行octop expert reload生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.24 中专家连接器(Expert Connectors)并非独立配置项,而是嵌套在「专家(Expert)」实体的生命周期管理中——也就是说,你不能单独启停或调试一个“连接器”,而是通过创建、编辑或启用某个专家来间接控制其绑定的连接器行为。
专家连接器的归属逻辑
每个专家默认绑定一组预定义的 Connector:比如「腾讯文档专家」自带 tencent-docs 连接器,「微博热点专家」自带 weibo-trend 连接器。这些连接器在专家初始化时自动加载,不支持运行时热插拔。v0.9.24 尚未开放 Connector 的全局注册表或独立管理界面。
- 连接器能力由专家 YAML 定义文件声明(位于 ~/.octop/experts/ 下对应专家目录)
- OAuth 类连接器(如飞书、企业微信)需在专家创建时完成首次授权,后续复用 token,不重复弹窗
- MCP 网关类连接器(如调用本地 Python 工具链)依赖 mcp-server-octop 子进程,该进程随 Octop 主服务启动而自动拉起
手动调整连接器配置的方法
若需修改某专家所用连接器的行为(例如更换 API Key、切换 OAuth 账户、禁用某项能力),需直接编辑其专家配置:
- 进入 ~/.octop/experts/{expert-id}/config.yaml,找到 connectors 字段
- 可修改 enabled: true/false 控制开关;对 OAuth 连接器,可清空 access_token 触发重新授权
- 修改后执行 octop expert reload {expert-id} 生效(无需重启整个服务)
验证连接器是否就绪
连接器状态不显示在 Web 控制台仪表盘,但可通过 CLI 快速确认:
- octop connector list —— 列出所有已加载连接器及其健康状态(仅显示已激活专家所用的)
- octop connector ping weibo-trend —— 对指定连接器发起探活请求(返回 HTTP 200 或具体错误)
- Web 控制台中与某专家对话时,若提示「无法访问微博接口」或「文档权限不足」,通常意味着对应连接器未授权或失效











