连接器

通过用户级连接器授权外部账号，让 Agent 在会话中安全使用钉钉、飞书等 CLI 能力

连接器

连接器用于把个人外部账号授权给 Knodo Agent。当前支持钉钉 DWS CLI 和飞书 CLI，可在能力中心连接、重新授权或断开。

进入连接器

从左侧导航进入“能力中心”，切换到“连接器”Tab，即可查看当前可用连接器和账号连接状态。

连接器入口

连接与管理

连接器管理

未连接时，选择钉钉 DWS CLI 或飞书 CLI，并按页面提示完成授权。

授权钉钉 DWS CLI

钉钉采用单阶段授权。点击“打开钉钉授权页面”，在钉钉页面确认账号权限后返回 Knodo，系统会自动刷新状态并完成连接。也可以点击“刷新授权状态”立即检查结果。

钉钉 DWS CLI 授权

跳转到钉钉后，点击“登录钉钉账号”，使用需要连接的账号完成登录和授权。

钉钉设备授权页面

授权飞书 CLI

飞书采用两阶段授权，需要按顺序完成以下操作：

  1. 创建或选择 CLI 应用：点击“打开飞书应用创建页面”，在飞书页面选择头像和应用名称后创建应用，也可以选择符合要求的已有应用。完成后返回 Knodo，系统确认成功后会自动进入下一阶段。

    飞书 CLI 创建应用

    飞书 CLI 应用创建页面

  2. 授权账号权限：点击“打开飞书授权页面”，在飞书页面核对授权账号和权限范围，然后点击“授权”。完成后返回 Knodo，等待系统完成连接。

    飞书 CLI 授权账号

    飞书 CLI 账号授权页面

授权窗口会显示授权码剩余有效期并自动刷新状态。授权码过期后，请关闭窗口并重新发起连接。

管理连接

  • 已连接时，列表会显示当前账号、关联 Plugin 和凭证有效期。

  • 打开连接器详情后，可以刷新授权、重新授权或断开连接。刷新失败不会影响其他 Agent 能力；授权已经失效时需要重新授权。

同一用户对同一连接器只保留一个当前连接。重新连接会替换原账号的授权；断开后，新会话不再注入对应能力。

在 Agent 中使用

连接成功后，新启动的 Claude Code 或 Codex 会话会自动获得关联 Plugin 和能力提示。Agent 使用 dws 或 lark-cli 时不需要用户在对话中粘贴 token。

会话启动时，Knodo 会尽力刷新即将过期的短期凭证。刷新失败不会阻止会话启动；系统会在仍有效时继续使用原凭证，并在连接器页面展示有效期，便于用户主动刷新或重新授权。

凭证在会话启动时注入，已经运行的长会话不会动态替换凭证。如果凭证在会话中途过期，请刷新或重新授权后新建会话。

Sandbox 与 Local Agent

  • DWS 和飞书都通过 Knodo 的设备授权流程连接，长期凭证由后端加密保存，不读取或复用执行机器上的 CLI 登录态。

  • Sandbox 和 Local Agent 会话都使用当前 Knodo 用户已连接的账号，并只接收本次会话需要的短期运行时变量。

  • CLI 工具本身可以按 Skill 指引安装到当前用户目录；安装文件可以持久化，但连接器凭证不会写入这些目录。

安全边界

  • 持久 token、refresh token、auth bundle 和 keychain 文件不会写入 workspace、/app/home、/home/knodo 或共享 CLI 配置目录。

  • Agent 运行时只注入当前发起用户连接所需的短期值。

  • 连接器密钥不会出现在目录 API、Agent 提示词或普通日志中。