在 Windows 上通过 Dify 部署飞书机器人，推荐采用“Dify + 飞书适配层”的架构。Dify 作为大脑处理核心逻辑，而适配层（如 dify-on-lark）则负责与飞书平台对接，处理消息收发和卡片渲染。

以下是基于 Docker 在 Windows 上的完整部署流程。

---

📋 一、环境与前置准备

1. 推荐配置

• 系统: Windows 10/11 (64位, 已开启虚拟化)

• 内存: 至少 16GB，推荐 32GB

• 磁盘: 至少 20GB 可用空间

2. 安装 Docker Desktop

Dify 官方推荐使用 Docker Compose 部署。

1. 启用 WSL2: 以管理员身份打开 PowerShell，执行 wsl --install。

2. 安装 Docker: 下载并安装 Docker Desktop，安装时勾选“使用 WSL 2 而不是 Hyper-V”。

3. 验证: 启动 Docker Desktop，在 PowerShell 中执行 docker --version，看到版本号即表示成功。

3. 部署 Dify

1. 克隆代码: 在 PowerShell 中执行以下命令。

   powershell

   git clone https://github.com/langgenius/dify.git

   cd dify

2. 配置环境: 进入 dify\docker目录，复制并重命名环境文件。

   powershell

   copy .env.example .env

3. 修改端口 (可选): 编辑 .env文件，避免与本地其他服务冲突。

   ini

   示例：将对外映射端口改为 8080 和 8443

   EXPOSE_NGINX_PORT=8080

   EXPOSE_NGINX_SSL_PORT=8443

4. 启动服务: 在 dify\docker目录下执行。

   powershell

   docker compose up -d

   等待所有容器启动后，访问 http://localhost:8080完成初始化设置。

---

🤖 二、创建飞书机器人应用

1. 登录开发者后台: 访问 https://open.feishu.cn/app，进入“开发者后台”。

2. 创建应用: 点击“创建企业自建应用”，填写名称（如 Dify智能助手）和描述后创建。

3. 添加机器人能力: 在应用详情页，找到并添加“机器人”能力模块。

4. 记录凭证: 在“凭证与基础信息”页面，复制 App ID​ 和 App Secret，稍后配置适配器时需要用到。

5. 配置权限: 在“权限管理”页面，搜索并开通以下权限：

   • im:message(收发消息)

   • im:message.group_at_msg:readonly(接收群聊@消息)

   • im:message.p2p_msg:readonly(接收私聊消息)

   • im:message:send_as_bot(以机器人身份发送消息)

   • cardkit:card:read/ cardkit:card:write(卡片读写)

6. 配置事件订阅: 在“事件与回调”页面进行设置：

   • 订阅方式: 选择“长连接”。

   • 请求网址: 暂时留空，待适配器启动后获取。

   • 订阅事件: 添加 im.message.receive_v1(接收消息) 和 card.action.trigger(卡片交互)。

7. 发布应用: 在“版本管理与发布”页面创建新版本并提交审核。个人账号通常可自动发布，企业账号需等待管理员审批。

---

🔗 三、部署 dify-on-lark 适配器

dify-on-lark是一个轻量级中间件，用于将 Dify 应用与飞书机器人连接起来。

1. 启动适配器容器

在 PowerShell 中执行以下命令，将占位符替换为你的实际配置：

powershell

docker run -d --name dify-on-lark `

-e TZ=Asia/Shanghai `

-e PARAMS="--platform.lark.appId=你的AppID `

--platform.lark.appSecret=你的AppSecret `

--platform.lark.verificationToken=你的VerificationToken `

--platform.lark.encryptKey=你的EncryptKey `

--provider.dify.url=http://host.docker.internal:8080/v1`

--provider.dify.auth=你的DifyAPI密钥" `

-p 8088:8088 `

--restart=always `

duhongming/dify-on-lark:v1.0.0

参数说明:

• platform.lark.*: 在飞书应用“凭证与基础信息”及“事件与回调”页面获取。

• provider.dify.url: Dify 服务的内部访问地址。若在 Windows 宿主机上运行 Dify，使用 host.docker.internal:8080/v1；若在 Docker 网络中，使用 Dify 容器的服务名。

• provider.dify.auth: 在 Dify 后台“访问 API”页面创建的 API 密钥。

2. 获取并配置回调地址

1. 容器启动后，访问 http://localhost:8088，页面会显示适配器的配置信息。

2. 复制 请求网址 (Callback URL)。

3. 返回飞书开发者后台的“事件与回调”页面，将复制的 URL 粘贴到“请求网址”处并保存。

---

🎉 四、配置 Dify 应用并测试

1. 创建 Dify 应用: 在 Dify 控制台创建一个新的“聊天助手”或“工作流”应用，并配置好提示词、模型和知识库。

2. 测试对话: 在飞书中找到并打开你的机器人，发送消息进行测试。如果一切正常，机器人将通过卡片流式回复 Dify 生成的答案。

---

💡 备选方案：使用 LangBot

如果你需要更复杂的多平台管理或 Agent 编排能力，可以考虑使用 LangBot​ 作为中间层。它同样支持将 Dify 作为后端服务，并提供 Webhook 触发器与 Dify 工作流深度集成。