【Hermes：多平台接入】19、钉钉/飞书/企业微信：国内办公场景接入指南 —— 将 Honcho 智能体部署到你的工作聊天软件

无心水2026-05-02 8:36

钉钉/飞书/企业微信：国内办公场景接入指南 ------ 将 Honcho 智能体部署到你的工作聊天软件

在国内企业办公环境中，钉钉、飞书、企业微信是三大主流协作平台。本文将完整讲解如何将 Honcho 智能体接入这三个平台，涵盖应用创建、权限配置、内网部署和功能限制，助你打造企业级 AI 助手。

前言：为什么需要接入国内办公平台？

在《第 17 篇》中，我们详细介绍了 Slack 接入方案。但对于大多数国内企业来说，真正的办公"主战场"是钉钉、飞书和企业微信。它们各有特色：

  • 钉钉：阿里巴巴出品，拥有庞大的中小企业用户群，深度整合了审批、考勤、财务等企业流程功能。
  • 飞书：字节跳动出品，以"文档+会议+日历"的高效协作著称，深受互联网和知识型企业青睐。
  • 企业微信：腾讯出品，核心优势在于连接微信生态，是企业触达客户的最短路径。

将 Honcho 智能体接入这些平台，意味着 AI 能力可以直接嵌入到员工每天使用的聊天工具中------无需跳转新页面，无需学习新操作，在熟悉的界面里就能召唤 AI 助手完成工作。

本文将从官方支持与社区扩展的区别讲起，分别给出三个平台的接入步骤，并重点讲解内网部署与安全注意事项。全文包含 5 张 mermaid 流程图，帮助你直观理解接入全貌。

1. 官方支持与社区扩展区别

在开始具体操作之前，有必要先厘清一个概念：Honcho 对于国内三大平台的支持，主要依赖社区插件和扩展，而非原生内置。

1.1 官方 vs 社区

维度 官方原生支持（如 Telegram/Slack） 社区扩展支持（钉钉/飞书/企微）
维护主体 Honcho 核心开发团队 社区开发者 / 第三方
功能完整性 完整，与核心版本同步 可能滞后，功能可能存在缺失
文档完备度 官方文档详尽 依赖社区文档，质量参差不齐
技术支持 官方渠道 依赖社区论坛、Issue
更新频率 随主版本同步更新 依赖贡献者维护，更新不稳定
部署复杂度 原生集成，开箱即用 需要手动安装插件或配置

1.2 接入思路对比

这三个平台的接入，本质上都是通过它们的"机器人"或"应用"能力，将 Honcho 的消息处理能力对接进去。
Honcho 生态
三方平台
钉钉机器人
飞书机器人
企业微信机器人
社区插件层
Honcho Gateway
Honcho Agent

重要提示：本文基于 2026 年公开的社区文档和实践经验编写，具体接入步骤可能因平台 API 版本更新而变化。建议在实际操作前查阅各平台官方最新文档。

2. 钉钉接入步骤

钉钉是国内部署最广的企业协作平台之一，其机器人能力成熟，支持内网部署。

2.1 前置准备

  • 拥有钉钉企业账号，并具备管理员或开发者权限[reference:0]
  • 已部署 Honcho 服务（建议 Docker 部署，参考第 11 篇）
  • 准备机器人图标素材：JPG/PNG 格式，240×240px 以上，1:1 比例，2MB 以内[reference:1]

2.2 创建企业内部应用

  1. 登录钉钉开发者后台：https://open-dev.dingtalk.com[reference:2]
  2. 进入「应用开发」→「企业内部开发」→ 点击「创建应用」[reference:3]
  3. 填写应用名称、应用描述，上传应用图标，点击「确定创建」

2.3 添加机器人能力

  1. 进入刚创建的应用，在「应用能力」区域找到「机器人」
  2. 点击「+ 添加」，为应用开通机器人能力[reference:4]

2.4 配置机器人信息

  1. 进入机器人配置页面，填写机器人名称、简介、描述
  2. 上传机器人图标和消息预览图
  3. 消息接收模式选择「Stream 模式」 ------ 这是钉钉特有的内网友好模式，无需公网域名即可接收消息[reference:5][reference:6]

2.5 发布应用版本

钉钉的一个关键注意事项：所有配置修改，必须发布新版本后才能生效[reference:7][reference:8]。

  1. 进入「版本管理与发布」
  2. 填写版本号和版本描述
  3. 设置应用可用范围（测试阶段建议设为「仅我可见」）
  4. 点击「保存并发布」

2.6 获取核心凭证

应用发布后，进入「凭证与基础信息」页面，复制以下两个核心参数[reference:9]：

  • Client ID（原 AppKey）
  • Client Secret（原 AppSecret）

⚠️ 这两个凭证是应用的核心密钥，请妥善保管，不要提交到公开代码仓库。

2.7 配置 Honcho / 网关

将获取到的 Client ID 和 Client Secret 配置到你的 Honcho 网关中（具体配置方式取决于你所用的社区插件）。

2.8 钉钉接入流程图

登录钉钉开发者后台
创建企业内部应用
添加机器人能力
配置机器人信息

选择Stream模式
发布应用版本
获取Client ID/Secret
配置到Honcho网关
测试消息交互

2.9 内网网络放通要求

如果 Honcho 部署在内网环境，需要确保能够访问钉钉长连接相关的域名和地址[reference:10]：

  • wss://wss-open-connection-union.dingtalk.com（长连接 WebSocket）
  • https://api.dingtalk.com
  • https://oapi.dingtalk.com

3. 飞书接入步骤

飞书以文档协作和流畅体验见长，是许多互联网企业的首选。

3.1 前置准备

  • 拥有飞书账号，可登录飞书开放平台
  • 已部署 Honcho 服务

3.2 创建飞书应用

  1. 访问飞书开放平台：https://open.feishu.cn/app，使用飞书账号登录[reference:11]
  2. 点击「创建企业自建应用」
  3. 填写应用名称和描述，上传应用图标，点击「创建」[reference:12]

3.3 添加机器人能力

  1. 进入「添加应用能力」→「机器人」
  2. 开启机器人能力，填写"如何开始使用"信息[reference:13]

3.4 配置权限

飞书需要预先配置机器人所需的 API 权限。在「权限管理」页面，点击「批量导入」，粘贴以下 JSON 配置一键导入[reference:14]：

json 复制代码 
{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_msg",
      "im:message:send_as_bot"
    ],
    "user": ["im:chat.access_event.bot_p2p_chat:read"]
  }
}

导入后点击「下一步」，确认并申请开通权限。

3.5 配置事件订阅

  1. 进入「事件与回调」页面
  2. 选择「使用长连接接收事件」 ------ 这是飞书的内网友好模式[reference:15]
  3. 点击「添加事件」，搜索 im.message.receive_v1（接收消息事件），勾选后添加

3.6 获取应用凭证

在「凭证与基础信息」页面，复制[reference:16]：

  • App ID
  • App Secret

3.7 发布应用

进入「版本管理与发布」，打开之前创建的版本，点击「确认发布」。企业自建应用通常自动通过审批[reference:17]。

3.8 配对授权

在飞书中向机器人发送任意消息，机器人会回复一个配对码。在网关配置中输入配对码完成授权绑定[reference:18]。

3.9 飞书接入流程图

登录飞书开放平台
创建企业自建应用
添加机器人能力
批量导入权限
配置事件订阅

使用长连接接收事件
获取App ID/Secret
发布应用
配对授权
测试消息交互

3.10 两种接收模式对比

模式 是否需要公网域名 适用场景
长连接（推荐） 不需要 内网部署、本地开发环境
回调 URL（Webhook） 需要 云服务器部署、需要 HTTPS

4. 企业微信接入步骤

企业微信的核心优势在于连接微信生态，适合有客户沟通需求的企业。

4.1 两种接入模式

企业微信的机器人接入有两种模式，根据需求选择[reference:19]：

模式 类型 特点
Bot 模式 智能机器人 API 模式 JSON 回调，支持流式消息，推荐用于 Honcho 对接
Agent 模式 自建应用 XML 回调，功能更全面，支持主动发送消息

本文重点介绍 Bot 模式（智能机器人 API 模式） ，因为它更简单，且原生支持长连接。

4.2 前置准备

  • 企业微信管理员账号
  • 企业微信客户端（电脑版）
  • 已部署 Honcho 服务

4.3 创建智能机器人

  1. 打开企业微信客户端，进入「工作台」→「智能机器人」[reference:20][reference:21]
  2. 点击「创建机器人」→ 选择「手动创建」
  3. 选择「API 模式」创建------这是支持自有系统接收与回复消息的模式[reference:22]
  4. 连接方式选择「使用长连接」------无需域名 / IP，即可接收消息[reference:23][reference:24]

4.4 获取凭证

配置完成后，系统自动生成并展示[reference:25]：

  • Bot ID
  • Secret

⚠️ 妥善保存，后续配置 Honcho 必需[reference:26]

4.5 配置可见范围

设置机器人的可见范围，按需选择可用成员或部门，其余参数保持默认即可[reference:27]。

4.6 配置 Honcho / 网关

将获取到的 Bot ID 和 Secret 配置到你的 Honcho 网关中，保存并重启服务[reference:28]。

4.7 企业微信接入流程图

打开企业微信工作台
进入智能机器人
创建机器人 手动创建
选择API模式
连接方式：使用长连接
获取Bot ID + Secret
配置可见范围
配置到Honcho网关
测试消息交互

4.8 消息回调说明

当用户与智能机器人交互时，企业微信会将消息推送到机器人配置中（长连接模式下通过 WebSocket 接收）。支持的消息类型包括[reference:29]：

  • 文本消息
  • 图文混排消息
  • 图片消息
  • 语音消息
  • 文件消息
  • 视频消息
  • 引用消息

开发者收到消息后，可以调用大模型/AIAgent 生成回复，支持流式消息输出[reference:30]。

4.9 长连接与回调 URL 模式对比

模式 是否需要公网域名 适用场景
长连接（推荐） 不需要 内网部署、本地开发环境
URL 回调模式 需要 云服务器部署、需要 HTTPS

5. 网关配置通用逻辑

无论接入哪个平台，Honcho 的网关配置都遵循一套通用逻辑。

5.1 通用配置结构

在 ~/.hermes/config/config.yaml 中（如果使用社区插件，配置路径可能略有不同）：

yaml 复制代码 
# 钉钉配置示例
dingtalk:
  enabled: true
  client_id: ${DINGTALK_CLIENT_ID}
  client_secret: ${DINGTALK_CLIENT_SECRET}
  stream_mode: true   # 使用 Stream 模式，无需公网域名

# 飞书配置示例
feishu:
  enabled: true
  app_id: ${FEISHU_APP_ID}
  app_secret: ${FEISHU_APP_SECRET}
  event_mode: websocket   # 长连接模式

# 企业微信配置示例
wecom:
  enabled: true
  bot_id: ${WECOM_BOT_ID}
  secret: ${WECOM_SECRET}
  mode: bot_long_connection   # Bot 模式长连接

5.2 环境变量管理

所有敏感凭证都应通过环境变量注入，而非硬编码在配置文件中：

bash 复制代码 
export DINGTALK_CLIENT_ID="dingxxx"
export DINGTALK_CLIENT_SECRET="xxx"
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"
export WECOM_BOT_ID="xxx"
export WECOM_SECRET="xxx"

5.3 消息处理流程

LLM Honcho Agent Honcho Gateway 办公平台(钉钉/飞书/企微) 用户 LLM Honcho Agent Honcho Gateway 办公平台(钉钉/飞书/企微) 用户 发送消息 @机器人 通过长连接/Webhook 推送 解析平台消息格式 转发标准化消息 调用 LLM 生成回复 回复内容 标准化回复 通过平台 API 发送 显示回复

6. 内网部署与安全注意

6.1 为什么内网部署很重要？

对于企业场景，数据安全是第一优先级。将 Honcho 部署在企业内网，可以实现：

  • 数据不出企业：所有对话数据、用户画像存储在本地服务器
  • 无需公网暴露：三大平台都支持长连接模式，不需要公网 IP 和域名
  • 合规性保障：满足数据本地化存储的监管要求

6.2 长连接模式详解

钉钉的 Stream 模式 、飞书的长连接接收事件 、企业微信的长连接方式，本质上都是基于 WebSocket 的长连接技术。
云端平台
企业内网
WebSocket 长连接
WebSocket 长连接
WebSocket 长连接
Honcho 服务器
钉钉
飞书
企业微信

优势：

  • 无需公网 IP 和域名[reference:31]
  • 防火墙配置简单（只需放行 WebSocket 出站）
  • 消息实时性高，延迟低

注意事项：

  • 需要确保内网可以访问各平台的长连接域名：
    • 钉钉：wss://wss-open-connection-union.dingtalk.com 等[reference:32]
    • 飞书：wss://*-open.feishu.cn 等
    • 企业微信：wss://qyapi.weixin.qq.com 等
  • 长连接需要保持活跃，避免网络断开

6.3 安全配置清单

配置项 推荐做法
凭证存储 使用环境变量或密钥管理服务，禁止明文存储在配置文件
应用可用范围 测试阶段设为「仅我可见」，生产环境按需开放[reference:33]
消息内容审计 开启 Honcho 审计日志，记录所有对话
敏感信息过滤 配置内容安全策略，自动脱敏 API 密钥、密码等
网络隔离 将 Honcho 服务部署在独立的内网网段，限制不必要的访问
定期更新 关注社区插件更新，及时修复安全漏洞

6.4 内网部署架构图

公网
企业内网
用户区域
应用区域
DMZ 区域
WebSocket 长连接
WebSocket 长连接
WebSocket 长连接
只允许特定端口和域名
内部访问
聊天消息
聊天消息
聊天消息
防火墙
Honcho 服务
数据存储

画像/记忆
员工电脑
钉钉云端
飞书云端
企业微信云端

7. 功能限制与替代方案

7.1 各平台功能对比

功能 钉钉 飞书 企业微信
机器人消息接收 ✅ Stream 模式 ✅ 长连接模式 ✅ 长连接模式
被动回复（3 秒内） ✅ ✅ ✅
主动推送消息 ✅ ✅ ✅（部分限制）
流式消息回复 ⚠️ 有限 ⚠️ 有限 ✅ 原生支持[reference:34]
语音消息 ✅ ✅ ✅ 支持接收
图片/文件消息 ✅ ✅ ✅ 支持接收
富文本/卡片消息 ✅ 支持 ✅ 支持 ✅ 支持模板卡片
交互式按钮 ✅ ✅ ✅ 有限支持
长连接无需公网域名 ✅ 是 ✅ 是 ✅ 是

7.2 常见限制

消息大小限制：各平台对单条消息有长度限制，建议 Honcho 将长回复分段发送。

主动推送限制：企业微信对机器人主动推送消息有一定配额限制，需要关注[reference:35]。

文件类型限制：企业微信自建应用（Agent 模式）不支持通用文件（File）类型的回调[reference:36]。推荐使用 Bot 模式（智能机器人）获得更好的文件支持。

调用频率限制：各平台都有 API 调用频率限制，高并发场景需要做消息队列缓冲。

7.3 替代方案

如果社区插件无法满足需求，可以考虑以下替代方案：

  1. Webhook + 内网穿透：使用 ngrok、frp 等工具将内网服务暴露到公网，采用回调 URL 模式[reference:37]。适用于云服务器部署场景。
  2. 自建消息网关：在云服务器上部署一个轻量级网关，负责接收平台消息并转发到内网的 Honcho 服务。
  3. 使用企业级 AI 中台：对于大型企业，可以考虑自建统一的 AI 消息网关，统一接入多个办公平台。

8. 总结：国内办公场景适配

8.1 三大平台选型建议

场景 推荐平台 理由
中小企业、制造/零售业 钉钉 用户基数大，审批/考勤等功能完善
互联网、科技公司、知识型团队 飞书 文档协作体验好，信息流转效率高
有客户沟通需求、连接微信生态 企业微信 与微信互通，是客户触达的最佳路径
混合场景（多平台同时使用） 全部 Honcho 社区插件支持多平台并存

8.2 接入检查清单

  • 确认企业账号有开发者/管理员权限
  • 在对应开放平台创建应用并添加机器人能力
  • 配置消息接收模式为长连接/Stream 模式（无需公网域名）
  • 获取应用凭证（Client ID/Secret 或 App ID/Secret 或 Bot ID/Secret）
  • 配置应用可用范围，测试阶段设为「仅我可见」
  • 发布应用版本（钉钉必须，飞书/企微可选）
  • 在 Honcho 网关中配置凭证
  • 测试发送消息，验证机器人响应
  • 开启审计日志，配置敏感信息过滤
  • （可选）配置定时备份数据目录

8.3 最佳实践总结

  1. 优先使用长连接模式：钉钉 Stream 模式、飞书长连接、企业微信长连接，都无需公网域名，适合内网部署，是安全与便捷的最佳平衡。
  2. 凭证安全管理：所有密钥使用环境变量注入，禁止硬编码。
  3. 分阶段部署：先以「仅我可见」范围测试，验证通过后再逐步开放给团队。
  4. 审计与监控：开启 Honcho 审计日志，记录所有对话和异常。
  5. 关注社区更新：国内平台 API 更新频繁，定期关注社区插件更新。

8.4 最终架构图

用户
办公平台
企业内网
长连接
长连接
长连接
消息
消息
消息
Honcho 智能体
Hermes 画像引擎
数据存储
钉钉
飞书
企业微信
钉钉用户
飞书用户
企微用户

8.5 一句话总结

将 Honcho 智能体接入钉钉、飞书或企业微信，等于为整个团队配备了不依赖公网、数据不出企业、随时可用的 AI 同事------这是国内企业办公场景下安全与便捷的最佳平衡方案。

下一步：完成接入后，可以开始配置具体的自动化场景------让 Honcho 自动汇总日报、回答常见问题、触发审批流程。你还可以根据团队需求，开发自定义的技能（Skills），将公司内部的业务 API 接入，实现"一句话完成报销"、"自动生成周报"等高级功能。

附录：参考资源

版权声明：本文为原创技术博客，采用 CC BY-NC-SA 4.0 许可。欢迎转载，请保留出处。如有接入问题，欢迎评论区交流。

相关推荐
AI科技星8 小时前
从180°旋转定值π、e论证时空宿命与未来可预测性—全域数学视角
人工智能·算法·机器学习·数学建模·数据挖掘
SmartBrain8 小时前
《梁山政治》与企业管理智慧的融合：头部企业对比分析
人工智能·华为
qcx238 小时前
Warp源码深度解析（七）：Token预算策略——双轨计费、上下文溢出与摘要压缩
人工智能·设计模式·rust·wrap
新知图书8 小时前
《LangGraph智能体设计模式与多智能体开发》1~6章试读
人工智能·langgraph·智能体设计模式·多智能体开发
财经资讯数据_灵砚智能8 小时前
基于全球经济类多源新闻的NLP情感分析与数据可视化（夜间-次晨）2026年4月30日
人工智能·信息可视化·自然语言处理
Bruce_Liuxiaowei8 小时前
2026年4月第5周网络安全形势周报
人工智能·安全·web安全·网络安全·大模型
七夜zippoe8 小时前
OpenClaw 安全配置与权限管理
安全·配置·管理·权限·openclaw
X54先生（人文科技）8 小时前
泉州单元组协同铁律
人工智能·语言模型·开源协议
TickDB8 小时前
MCP、WebSocket 与 Agentic Wallet：AI 自主交易的三把钥匙，同时转动了
人工智能·python·websocket
热门推荐
01要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法02GitHub 镜像站点03裂开！ChatGPT 居然开始要手机号验证，附详细解决方法04【AI】2026 年具身智能模型和世界模型总结05Codex 接入 DeepSeek API 完整配置文档062026年4月AI大事件深度解读：大模型竞争进入“深水区“07实测可用｜小米 MiMo 百万亿 Token 免费领，开发者速冲082026年AI前瞻：量子AI、具身智能与科学发现的新纪元09零基础教你claude code 接入 deepseek V410在Windows 11上安装Docker的踩坑记录