跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

AI Agent 接入飞书:cc-connect 零基础配置指南

介绍如何使用 cc-connect 将本地 AI Agent 接入飞书。首先需安装 Node.js,通过 npm 全局安装 cc-connect Beta 版。接着在飞书开放平台创建应用并获取 App ID 和 Secret,配置机器人权限及长连接事件订阅。运行 cc-connect 命令建立连接,并通过 /bind setup 指令开启附件回传功能,实现本地 Agent 向飞书发送文本、图片及文件的能力。

草莓泡芙发布于 2026/4/5更新于 2026/5/2267 浏览

引言:什么是 cc-connect?

cc-connect 是一个开源的、轻量级的 AI Agent 连接器(Connector)。

简单来说,它的核心作用就是充当一座**'桥梁'**,把你本地运行的强大 AI Agent(比如 Claude Code 等)与你日常使用的通讯软件(如飞书、钉钉、微信个人号、Telegram 等)无缝打通。

  • 没有它时: 你的本地 Agent 只能被困在电脑的命令行终端(Terminal)里,你必须坐在电脑前敲击键盘才能和它交互。
  • 有了它后(核心价值): 你相当于给本地的 AI Agent 开通了一个'线上客服窗口'。你可以随时随地在手机飞书上给 Agent 下达指令;Agent 在你电脑本地完成任务(比如分析本地文件、写代码、甚至操作网页截图)后,cc-connect 会负责把执行结果(不仅是文字,还包括真正的图片和附件)直接推送到你的飞书聊天框里。

这就是为什么我们需要配置 cc-connect:为了让强大的本地 AI 能力,变成你触手可及的跨平台全能助手!

前提条件 (Prerequisites)

在开始之前,请确保你的 Windows 电脑满足:

  1. 已安装 Node.js(推荐 LTS 版本,自带 npm)。
  2. 拥有飞书账号(个人或企业均可,用于创建机器人)。
  3. 已安装 AI Agent 环境(如 Claude Code 等)。

极简安装 (推荐最新 Beta 版)

在 Windows 下,最省心的方式就是直接用 npm 全局安装。为了支持最新的图片/文件回传能力,请务必安装 Beta 版。

请以管理员身份运行 PowerShell 或 CMD,执行:

npm install -g cc-connect@beta

获取飞书凭证 (准备工作)

我们需要先去飞书后台建个机器人,拿到'钥匙'。

  1. 登录 飞书开放平台。
  2. 点击「创建企业自建应用」(个人也可创建),起名如 cc-connect。
  3. 在左侧导航栏点击「凭据与基础信息」,复制你的 App ID (cli_xxx...) 和 App Secret。
  4. 左侧导航栏点击「应用能力」 -> 「机器人」,点击「启用机器人」。

一键配置与飞书授权 (核心步骤)

无需手动去一层层建文件夹写配置,cc-connect 提供了极简的命令帮你一键搞定。

1. 自动写入配置

在你的 PowerShell 中执行以下命令(将其中的 cli_xxx 和 sec_xxx 替换为你刚才复制的凭证):

cc-connect feishu setup --project my-project --app cli_xxx:sec_xxx

(这个命令会自动在 C:\Users\<你的用户名>\.cc-connect\config.toml 中生成专为飞书定制的配置,并且默认开启了 attachment_send = "on" 附件回传功能。)

2. 配置飞书权限 (非常重要)

回到飞书开放平台网页端,完成机器人权限和长连接设置:

  • 申请权限:点击左侧「权限管理」,搜索并勾选以下 6 个权限:
  • 获取与更新用户基本信息
  • 接收群聊消息、接收单聊消息
  • 读取群消息、读取单聊消息
  • 以应用身份发送群消息
  • 开启长连接(免公网 IP 的核心):
    • 点击左侧「事件订阅」。
    • 订阅方式选择 '使用长连接接收事件' 并启用。
    • 在下方事件配置中添加:接收消息 (im.message.receive_v1),保存。
  • 发布应用:点击左侧「版本管理与发布」 -> 「创建版本」,保存并发布(每次修改必须发布)。

  • 运行与高级预热 (Run & Test)

    配置完成后,在 PowerShell 中直接运行:

    cc-connect
    

    当你看到控制台打印出类似 [Info] connected to wss://msg-frontier.feishu.cn/ws/v2?... 的日志时,说明长连接已打通!

    解决图片只发路径不发图的关键一步(高级能力预热):

    现在去飞书里搜索你创建的机器人,打开对话框。如果你希望 Agent 在本地生成图表、截图或 PDF 后能真正发回飞书,请在首次聊天时,先向机器人发送这条指令:

    /bind setup (或者 /cron setup)

    这会将最新的附件回传指令写入项目的记忆文件中。Agent 学习后,下次再生成截图,就会调用正确的命令将真正的图片传回飞书,而不再是干巴巴地回复你一条本地文件路径了。


    后续升级

    未来如果有新版本修复 bug 或增加功能,只需在 PowerShell 再次执行:

    npm install -g cc-connect@beta
    

    参考资料与官方文档

    如果在配置过程中遇到其他个性化需求,或者想要了解如何接入钉钉、Telegram、微信个人号等其他平台,请参考以下官方资源:

    • cc-connect GitHub 官方主页:https://github.com/chenhg5/cc-connect
    • 官方完整使用指南 (包含所有命令说明):使用指南 usage.zh-CN.md
    • cc-connect 飞书接入官方文档:飞书接入指南 feishu.md
    • 默认配置文件模板:config.example.toml
    • 飞书开发者后台 (用于创建和管理应用):飞书开放平台

    效果演示 (Demo)

    我们以**'让 Agent 截取电脑桌面并发送到飞书'**为例:

    • ✅ 在完成了上述的 Beta 版安装与 /bind setup 指令预热后,再次对机器人说:'帮我截取当前桌面。' Agent 执行截图后,飞书聊天框内会直接弹出刚才截好的桌面原图!真正实现了跨平台、所见即所得的丝滑自动化体验。

    文章配图

    目录

    1. 引言:什么是 cc-connect?
    2. 前提条件 (Prerequisites)
    3. 极简安装 (推荐最新 Beta 版)
    4. 获取飞书凭证 (准备工作)
    5. 一键配置与飞书授权 (核心步骤)
    6. 1. 自动写入配置
    7. 2. 配置飞书权限 (非常重要)
    8. 运行与高级预热 (Run & Test)
    9. 解决图片只发路径不发图的关键一步(高级能力预热):
    10. 后续升级
    11. 参考资料与官方文档
    12. 效果演示 (Demo)
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

    微信扫一扫,关注极客日志

    微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • 绿联 NAS 配置 WebDAV 公网访问及 RaiDrive 挂载实战
    • AI 智能编码工具深度测评:GitHub Copilot 与国产方案对比
    • Vue 3 前端调试与开发指南
    • 无线联邦学习:保护隐私下的 AI 协同进化
    • Flutter Genkit 在鸿蒙端的适配:模型幻觉审计与端云协同 AI 方案
    • Milvus 安装指南:Docker、Docker Compose 与 Kubernetes 部署方式
    • LLaMA-Factory 微调多模态大模型 Qwen3-VL
    • AI Agent 新范式:FastGPT 集成 MCP 协议构建工具增强型智能体
    • 2026 年主流 AI Agent 框架横评:OpenClaw 系列对比与场景推荐
    • Raphael AI:基于 Flux 模型的免费 AI 图像生成工具
    • 双指针算法实战:移动零与复写零
    • Llama3.1 原模型与中文微调模型效果对比分析
    • GPEN 批量处理断点续传方案设计与实现
    • SSL VPN 安全防御:防范隧道内部攻击流量
    • OpenCode、OpenClaw 与 Ollama 安装配置指南
    • Spring Boot 定时任务与调度系统
    • Java 哈希数据结构与经典用法
    • Ubuntu 24.04.3 LTS 与 RTX 5090 显卡驱动安装指南
    • AI 大模型学习路线:从理论基础到工程实践指南
    • 绿联 NAS 配置 WebDAV 公网访问并使用 RaiDrive 挂载本地

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • 随机西班牙地址生成器

      随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

    • Keycode 信息

      查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

    • Escape 与 Native 编解码

      JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

    • JavaScript / HTML 格式化

      使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online