LobsterAI（网易有道）

# LobsterAI（有道龙虾）用户手册

## 一、产品介绍

### 1.1 概述

LobsterAI（中文名"有道龙虾"）是网易有道推出的 **7×24 小时全场景个人助理 Agent**。支持本地部署安全运行，基于 openclaw 框架生态，兼容全球主流 AI 模型，内置丰富 Skills 技能系统，可通过远程操控直接对话，具备双层记忆持续成长能力。

无论是编写代码、处理文档、数据分析、设计原型、搜索信息，还是创建游戏，LobsterAI 都能胜任。通过内置的**技能系统**，就像一个掌握多项专业技能的全能助手，随时待命为你服务。

### 1.2 核心优势

| 优势               | 说明                                              |
| ------------------ | ------------------------------------------------- |
| **多模型自由切换** | 支持 10+ 主流 AI 模型，按需选择最合适的助手       |
| **丰富的技能库**   | 内置 12+ 专业技能，覆盖开发、设计、办公等场景     |
| **任务历史管理**   | 自动保存所有对话记录，随时回顾和继续之前的工作    |
| **本地化部署**     | 支持 Ollama 等本地模型，保护数据隐私              |
| **开放扩展**       | 可自行创建技能，让 LobsterAI 学会任何你需要的能力 |

### 1.3 快捷键

| 快捷键             | 功能         |
| ------------------ | ------------ |
| `Cmd/Ctrl + N`     | 新建任务     |
| `Cmd/Ctrl + K`     | 聚焦搜索框   |
| `Cmd/Ctrl + ,`     | 打开设置     |
| `Cmd/Ctrl + Enter` | 发送消息     |
| `Esc`              | 取消当前输入 |

---

## 二、安装部署

### 2.1 安装包下载

> 最新版本：**2026.7.17**

| 平台                    | 下载链接                                                     |
| ----------------------- | ------------------------------------------------------------ |
| **macOS（Apple 芯片）** | [下载 .dmg](https://ydschool-video.nosdn.127.net/1784287813084LobsterAI-darwin-arm64-2026.7.17-official.dmg) |
| **macOS（Intel 芯片）** | [下载 .dmg](https://ydschool-video.nosdn.127.net/1784287798642LobsterAI-darwin-x64-2026.7.17-official.dmg) |
| **Windows**             | [下载 .exe](https://ydschool-video.nosdn.127.net/1784289299077LobsterAI-Setup-x64-2026.7.17-official.exe) |

### 2.2 安装步骤

1. 根据你的操作系统和芯片类型，选择对应的安装包下载
2. **macOS 用户**：双击 `.dmg` 文件，将 LobsterAI 拖入"应用程序"文件夹
3. **Windows 用户**：双击 `.exe` 安装程序，按提示完成安装
4. 启动应用后即可进入首次配置

### 2.3 首次启动配置

1. 点击左下角 **「设置」** 图标
2. 进入 **「模型」** 选项卡
3. 选择一个模型提供商（如 Anthropic、OpenAI、DeepSeek 等）
4. 填写对应的 **API Key**（需先在服务商官网注册账号获取）
5. 点击 **「测试连接」** 确认配置正确
6. 保存设置，开始使用

---

## 三、自定义 API 配置

### 3.1 什么是 API Key？

- **AI 模型** 是运行在服务商云端服务器上的智能助手
- **API Key** 是服务商给你的专属访问密钥
- **LobsterAI** 是帮你连接和使用这些 AI 模型的工具
- **LobsterAI 本身免费**，AI 模型费用直接支付给服务商

### 3.2 支持的模型提供商

| 提供商                   | 代表模型                         | 说明                     |
| ------------------------ | -------------------------------- | ------------------------ |
| **OpenAI**               | GPT-4o, GPT-4o-mini              | 国际主流模型             |
| **Anthropic**            | Claude Sonnet 4.5, Claude Opus 4 | 国际主流模型             |
| **Google**               | Gemini Pro, Gemini Flash         | 国际主流模型             |
| **DeepSeek**             | DeepSeek Reasoner, DeepSeek Chat | 高性价比国产模型         |
| **Moonshot（月之暗面）** | Kimi                             | 支持超长上下文           |
| **Zhipu（智谱）**        | GLM 系列                         | 清华大学技术背景         |
| **Qwen（通义千问）**     | Qwen 系列                        | 阿里云 AI 模型服务       |
| **MiniMax**              | 多模态模型                       | 提供多模态 AI 能力       |
| **Doubao（豆包）**       | 豆包系列                         | 字节跳动 AI 模型         |
| **OpenRouter**           | 聚合多种模型                     | 可访问多种模型的聚合服务 |
| **Ollama**               | Llama, Mistral 等开源模型        | 本地部署，无需 API Key   |

### 3.3 自定义模型配置

无论使用哪家服务商，在 LobsterAI 中的配置操作都是相同的：

#### 第 1 步：打开模型设置

启动 LobsterAI → 点击右上角「设置」图标（齿轮⚙️）→ 点击左侧「模型」选项

![LobsterAI设置入口](https://ydschool-video.nosdn.127.net/1770879579687a15f40d097b070a4caabf960c895d1df.png)

![LobsterAI模型设置](https://ydschool-video.nosdn.127.net/17708796336658e0fc4fde0442e658aeaad3a0840f6f4.png)

#### 第 2 步：选择模型提供商

在模型列表中找到目标服务商（如 DeepSeek、Zhipu GLM、Qwen、Moonshot、MiniMax 等）

![模型列表](https://ydschool-video.nosdn.127.net/17708891382800a925652c28e377af2b2744943fdfcc9.png)

#### 第 3 步：填写配置信息

| 配置项           | 填写说明                                           |
| ---------------- | -------------------------------------------------- |
| **启用开关**     | 点击开关按钮启用该服务商                           |
| **API Key**      | 粘贴从服务商处复制的密钥                           |
| **API Base URL** | 一般使用默认 URL 即可；自建/代理服务可填自定义地址 |
| **模型选择**     | 根据需要选择可用模型                               |
| **Group ID**     | 仅 MiniMax 需要，必填                              |

![填写配置](https://ydschool-video.nosdn.127.net/17708801766500e255c22fc44bee8a4d55b5e5c1ce4cd.png)

#### 第 4 步：测试连接

点击「测试连接」按钮，检查连接状态。

![测试连接](https://ydschool-video.nosdn.127.net/177088026526102d8d0be0d72919301354a468a6a21a8.png)

> ⚠️ 如连接失败，请依次检查：
>
> - API Key 是否完整（无多余空格）
> - Base URL 是否正确（无多余空格或斜杠）
> - 账户余额是否充足
> - 网络连接是否正常

#### 第 5 步：保存并使用

测试成功后点击「保存」→ 回到聊天界面 → 在模型选择器中选择已配置的模型 → 开始对话

![选择模型](https://ydschool-video.nosdn.127.net/1770880940228c4d41cc171fff11e4fbe6814db9acc8c.png)

---

![填写通义千问配置](https://ydschool-video.nosdn.127.net/1770891490144a5080754e0a99bc51a7796290f694463.png)

4. **测试连接**：点击「测试连接」，如失败请检查 API Key 完整性、Base URL、余额/免费额度、网络连接

![测试连接](https://ydschool-video.nosdn.127.net/1770891559725049d2904de533755bf9c67c325f79c8b.png)

5. **保存配置**：测试成功后点击「保存」

#### 开始使用

回到聊天界面 → 在模型选择器中选择「通义千问」或「Qwen」→ 即可开始对话

![选择通义千问模型](https://ydschool-video.nosdn.127.net/1770891657073c05b86c59f408fbb1d603a0141123218.png)

### 3.4 常见问题

#### 1. API Key 提示无效怎么办？

**检查步骤**：检查复制时是否包含多余空格、确认 API Key 是否完整、确认账户余额是否充足、检查 API Base URL 是否正确

**解决方法**：重新复制粘贴 API Key；检查账户余额；确认 Base URL 格式正确（无多余空格或斜杠）

#### 2. 测试连接失败怎么办？

| 错误提示      | 可能原因         | 处理方法               |
| ------------- | ---------------- | ---------------------- |
| "API Key无效" | 密钥错误或不完整 | 重新复制完整密钥       |
| "余额不足"    | 账户余额不足     | 充值账户               |
| "网络错误"    | 网络连接问题     | 检查网络连接           |
| "服务不可用"  | 服务商维护       | 访问服务商官网查看状态 |

#### 3. 如何查看消费记录？

- **DeepSeek**：登录后台 → 左侧菜单「消费明细」
- **智谱AI**：控制台 → 「账户余额」→「消费记录」
- **通义千问**：阿里云控制台 → 「费用」→「消费明细」
- **Moonshot**：费用中心 → 「消费记录」

#### 4. 多个模型可以同时配置吗？

可以。LobsterAI 支持同时配置多个模型服务商，可以在对话中切换不同模型、同时使用多个服务商的服务、根据需要选择使用的模型。

---

## 五、推荐配置

### 5.1 模型推荐

| 使用场景                | 推荐模型                   | 理由                   |
| ----------------------- | -------------------------- | ---------------------- |
| **日常办公 / 通用**     | DeepSeek Chat              | 高性价比，中文能力强   |
| **代码开发**            | Claude Sonnet 4.5 / GPT-4o | 代码生成质量高         |
| **长文档处理**          | Moonshot（Kimi）           | 支持超长上下文         |
| **完全离线 / 隐私敏感** | Ollama + Llama             | 数据不出本地           |
| **国内综合首选**        | DeepSeek / 通义千问        | 性价比高、国内访问稳定 |

### 5.2 IM 机器人集成

LobsterAI 支持接入多种 IM 平台，实现远程对话操控：

| 平台         | 模式                     | 说明                                   |
| ------------ | ------------------------ | -------------------------------------- |
| **微信**     | IM 机器人                | 扫码连接即可使用                       |
| **钉钉**     | IM 机器人（Stream 模式） | 需创建企业内部应用、配置权限、发布版本 |
| **飞书**     | IM 机器人                | 创建企业自建应用、配置权限与事件回调   |
| **钉钉**     | Webhook 机器人           | 单向推送通知，适合定时推送、报警场景   |
| **飞书**     | Webhook 机器人           | 单向推送通知                           |
| **企业微信** | 智能机器人（API 模式）   | 企业级应用                             |
| **QQ**       | QQ-BOT                   | QQ 机器人接入                          |

> **两种配置类型说明：**
>
> - **IM 机器人**（Stream 模式）：双向对话，可问答交互
> - **Webhook 机器人**：单向推送通知，适合定时推送、报警等场景

### 5.3 多 Agent 配置

多 Agent 功能允许创建多个独立的 AI 助手，每个 Agent 拥有独立的身份人设、专属技能组合、独立对话历史及 IM 平台绑定。

**预设 Agent 列表：**

| Agent        | 说明                                   |
| ------------ | -------------------------------------- |
| 股票助手     | A 股公告追踪、个股深度分析、交易复盘   |
| 内容创作     | 一站式内容创作：选题、撰写、排版、润色 |
| 备课出卷专家 | 生成教案、试卷、答案解析               |
| 内容总结助手 | 音视频、链接、文档摘要                 |
| 医疗健康解读 | 体检报告、化验单通俗解读               |
| 萌宠管家     | 猫狗饲养、异常行为分析                 |

**自定义 Agent 可配置项：** 图标、名称、描述、系统提示词、身份（IDENTITY.md）、默认模型、技能、IM 渠道。

### 5.4 邮箱配置

支持配置邮箱实现邮件收发功能（以 163 邮箱为例）：

1. 登录 [mail.163.com](https://mail.163.com)
2. 进入 **"设置" >> "POP3/SMTP/IMAP"**
3. **开启** IMAP/SMTP 服务
4. 验证后获取客户端授权密码
5. 在 LobsterAI 中填写邮箱地址和授权码