# LobsterAI + 通义千问(Qwen) + 飞书 完整配置指南

## 前言

LobsterAI（有道龙虾）是网易有道推出的桌面级 AI Agent，定位为"7×24 小时帮你干活的全场景个人助理"。它支持通过自然语言指令自动执行复杂任务，包括数据分析、PPT 制作、视频生成、文档撰写、邮件收发等。

本文将详细介绍如何配置 **通义千问（Qwen）** 作为 LLM 后端，以及如何配置 **飞书** 实现移动端远程操控。

---

## 一、环境准备

### 1.1 系统要求

- **操作系统**：macOS（Intel/Apple Silicon）、Windows、Linux

- **Node.js**：>= 24 < 25

- **npm**

### 1.2 安装 LobsterAI

**方式一：下载安装包**

前往 [LobsterAI 官网](https://lobsterai.youdao.com/) 或 [GitHub Releases](https://github.com/netease-youdao/LobsterAI/releases) 下载对应平台的安装包。

**方式二：从源码构建**

```bash

# 克隆仓库

git clone https://github.com/netease-youdao/LobsterAI.git

cd lobsterai

# 安装依赖

npm install

# 启动开发环境

npm run electron:dev

# 或构建生产版本

npm run build

npm run dist:mac  # macOS

npm run dist:win  # Windows

npm run dist:linux  # Linux

```

---

## 二、配置通义千问（Qwen）API

### 2.1 获取阿里云 API Key

1. 登录 [阿里云控制台](https://dashscope.console.aliyun.com/)

2. 开通 **灵积模型服务（DashScope）**

3. 在 API-KEY 管理页面创建新的 API Key


### 2.2 LobsterAI 中配置 Qwen

打开 LobsterAI，进入 **设置 → 模型配置**：

#### 配置参数

| 参数 | 值 |

|------|-----|

| **提供商** | Qwen（通义千问） |

| **API Key** | 从阿里云获取的 API Key |

| **Base URL** | 根据选择的 API 格式填写 |

| **API 格式** | Anthropic 或 OpenAI 兼容 |

#### Base URL 配置

**方式一：Anthropic 格式（推荐）**

```

https://dashscope.aliyuncs.com/apps/anthropic

```

**方式二：OpenAI 兼容格式**

```

https://dashscope.aliyuncs.com/compatible-mode/v1

```

### 2.3 模型列表配置

LobsterAI 支持自定义模型列表，推荐配置以下 Qwen 模型：

| 模型 ID | 说明 | 支持图片 |

|---------|------|---------|

| `qwen-turbo-latest` | 通义千问 Turbo 最新版 | ❌ |

| `qwen-plus-latest` | 通义千问 Plus 最新版 | ❌ |

| `qwen-max-latest` | 通义千问 Max 最新版 | ❌ |

| `qwen-vl-max-latest` | 通义千问 VL 多模态 | ✅ |

| `qwen-coder-plus-latest` | Qwen Coder 代码模型 | ❌ |

### 2.4 连通性测试

配置完成后，点击 **测试连接** 按钮验证配置是否正确。

---

## 三、配置飞书远程触发

### 3.1 创建飞书企业自建应用

1. 登录 [飞书开放平台](https://open.feishu.cn/)

2. 进入 **开发者后台 → 创建企业自建应用**

3. 记录以下信息：

   - **App ID**

   - **App Secret**

### 3.2 配置应用权限

在应用管理页面，配置以下权限：

**必要权限：**

- `im:message` - 获取与发送消息

- `im:message:send_as_bot` - 以应用身份发消息

- `im:chat` - 获取群组信息

- `im:chat:read` - 读取群消息

### 3.3 配置事件订阅

1. 在 **事件订阅** 页面启用消息接收

2. 添加以下事件：

   - `im.message.receive_v1` - 接收消息

### 3.4 LobsterAI 中配置飞书

打开 LobsterAI，进入 **设置 → IM 集成 → 飞书**：

| 参数 | 值 |

|------|-----|

| **App ID** | 飞书应用的 App ID |

| **App Secret** | 飞书应用的 App Secret |

| **启用状态** | 开启 |

### 3.5 验证飞书集成

配置完成后：

1. 在飞书中找到你的机器人

2. 发送测试消息，如 "你好"

3. LobsterAI 桌面端会自动响应并处理

---

## 四、完整配置流程图

```

┌─────────────────────────────────────────────────────────────┐

│                    LobsterAI 配置流程                        │

├─────────────────────────────────────────────────────────────┤

│                                                             │

│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐     │

│  │ 安装应用     │───▶│ 配置模型     │───▶│ 配置飞书     │     │

│  └─────────────┘    └─────────────┘    └─────────────┘     │

│         │                  │                  │             │

│         ▼                  ▼                  ▼             │

│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐     │

│  │ 下载安装包   │    │ 获取API Key  │    │ 创建飞书应用  │     │

│  │ 或源码构建   │    │ 填写Base URL │    │ 配置权限事件  │     │

│  └─────────────┘    └─────────────┘    └─────────────┘     │

│                                                             │

│  ┌─────────────────────────────────────────────────────┐   │

│  │                   测试验证                           │   │

│  │  • 模型连接测试                                      │   │

│  │  • 飞书消息收发测试                                  │   │

│  │  • Cowork 任务执行测试                               │   │

│  └─────────────────────────────────────────────────────┘   │

│                                                             │

└─────────────────────────────────────────────────────────────┘

```

---

## 五、使用示例

### 5.1 桌面端使用

配置完成后，直接在 LobsterAI 桌面端输入指令：

```

帮我分析这份销售数据，生成一份 PPT 汇报

```

```

每天早上 9 点帮我收集科技新闻并发送到飞书

```

### 5.2 飞书远程操控

在手机飞书中发送消息给机器人：

```

帮我整理今天的邮件

```

```

生成一份本周工作总结

```

LobsterAI 会自动在桌面端执行任务，并将结果返回到飞书。

---

## 六、常见问题

### Q1: Qwen API 连接失败？

**检查项：**

1. API Key 是否正确

2. Base URL 是否填写正确

3. 阿里云账户余额是否充足

4. 网络是否可访问 `dashscope.aliyuncs.com`

### Q2: 飞书消息无响应？

**检查项：**

1. App ID 和 App Secret 是否正确

2. 应用是否发布到企业

3. 事件订阅是否配置正确

4. LobsterAI 是否正在运行

### Q3: 如何切换模型？

在 LobsterAI 设置中，可以在不同提供商和模型之间切换。Qwen 支持多种模型，根据任务选择合适的模型：

- 日常对话：`qwen-turbo-latest`

- 复杂任务：`qwen-max-latest`

- 代码生成：`qwen-coder-plus-latest`

- 图片理解：`qwen-vl-max-latest`

---

## 七、安全建议

1. **API Key 保护**：不要将 API Key 提交到代码仓库或公开分享

2. **权限最小化**：飞书应用只申请必要权限

3. **沙箱模式**：处理敏感任务时使用沙箱执行模式

4. **工作目录限制**：设置合理的工作目录边界

---

## 八、参考资料

- [LobsterAI 官网](https://lobsterai.youdao.com/)

- [LobsterAI GitHub](https://github.com/netease-youdao/LobsterAI)

- [阿里云灵积模型服务](https://dashscope.console.aliyun.com/)

- [飞书开放平台](https://open.feishu.cn/)

---

**作者**：LobsterAI 用户社区

**更新时间**：2026年2月