接入 LobeHub

LobeHub 是业界领先的AI Agent管理平台，定位为你的首席Agent运营官。它的核心优势是能够将不同能力的Agent组织成7×24小时运作的AI团队，支持自动招聘（配置不同能力的Agent）、智能排班（根据任务类型分配合适的Agent）、自动生成工作报表，你只需要下达业务目标，即可由AI团队自动完成复杂工作流，全程掌控进度，无需一直在线，是个人提升效率、企业搭建AI工作流的极佳选择。

接入DeepSeek V4模型后，LobeHub可以借助DeepSeek的强推理能力、百万级上下文窗口、高性价比优势，大幅提升Agent团队的任务执行准确率、长文档处理能力、多步骤规划能力，同时降低大规模使用的成本，尤其适合个人效率工具爱好者、中小企业运营者、AI Agent开发者、需要处理多任务自动化的职场人使用。

通过本教程，你将掌握LobeHub的DeepSeek服务配置、模型选择、推理参数调整的全流程操作，自托管用户还能完成全局服务配置，最终搭建起由DeepSeek驱动的AI Agent管理平台。

• GitHub： https://github.com/lobehub/lobehub
• 官网： https://lobehub.com
• 网页端： https://app.lobehub.com
• 桌面端： https://lobehub.com/downloads/mac

1. 准备 LobeHub 与 DeepSeek API Key

本步骤的核心目的是准备好LobeHub的使用环境与DeepSeek的API凭据，为后续配置做好准备。

你可以使用 LobeHub 网页端、桌面端或自托管实例：

• 网页端：打开 app.lobehub.com。无需安装，直接通过浏览器访问即可使用，适合所有用户快速体验，所有配置会同步到你的LobeHub账号中。
• 桌面端：从 LobeHub 下载页 获取 macOS 应用。支持系统级集成、通知推送、离线缓存，响应速度更快，适合高频使用用户。
• 自托管：请确认实例已升级到包含 DeepSeek V4 模型的较新版本。适合有定制需求、数据安全要求高的用户，需要自行部署与维护服务。

然后前往 DeepSeek 开放平台 创建 API Key。首次使用需要完成实名认证，平台会为新用户提供一定额度的免费体验金，可用于测试模型能力。请妥善保管你的API Key，不要泄露给他人，避免产生不必要的费用损失。

操作验证：打开LobeHub后能正常进入首页，DeepSeek API Key创建完成并完整复制，即为准备完成。

2. 配置 DeepSeek 模型服务

本步骤的核心目的是在LobeHub中配置DeepSeek模型服务，添加API凭据，让LobeHub可以正常调用DeepSeek的模型服务。

打开 LobeHub，进入 设置 → 服务模型。也可以直接打开 DeepSeek Provider 页面：

https://app.lobehub.com/settings/provider/deepseek

1. 在模型服务商列表中选择 DeepSeek。进入DeepSeek专属配置页面，所有配置仅对DeepSeek服务商生效。
2. 确认右上角的 Provider 开关已开启。开关开启后，DeepSeek模型才会显示在模型选择器中，关闭状态下会隐藏所有DeepSeek模型。
3. 将 DeepSeek API Key 粘贴到 API Key 输入框。该Key是LobeHub调用DeepSeek API的身份凭据，仅会加密存储在你的本地环境或自托管服务中，不会上传到LobeHub官方服务器。
4. 除非你使用自定义代理，API 代理地址 可以保持为空；默认端点是 https://api.deepseek.com。如果你需要通过代理访问DeepSeek服务（如内网部署、网络加速），可以在此处填写你的代理地址，必须包含http://或https://前缀。
5. 可选：点击 连通性检查 中的 检查。LobeHub 默认使用 deepseek-v4-flash 作为检查模型，该模型响应速度快、成本低，适合快速验证配置是否有效。
6. 在 模型列表 中确认 DeepSeek V4 Pro 与 DeepSeek V4 Flash 已启用。如需刷新模型列表，点击 获取模型列表，系统会自动从DeepSeek官方API拉取当前可用的所有模型。

操作验证：连通性检查提示“成功”，模型列表中DeepSeek V4 Pro与Flash显示为已启用状态，即为配置成功。

_{在 Chrome 中打开 LobeHub 网页端的 DeepSeek 模型服务配置页。}

3. 选择 DeepSeek V4 模型

本步骤的核心目的是在对话中选择DeepSeek V4系列模型，体验DeepSeek的强大能力。

回到 首页 或打开任意 Agent 对话。

1. 点击输入框工具栏中的当前模型标签。模型标签会显示当前会话使用的模型名称，点击后会打开模型选择器。
2. 搜索 DeepSeek V4。可以快速过滤出DeepSeek V4系列模型，避免在大量模型中查找。
3. 编码、长程规划和 Agent 工作流建议选择 DeepSeek V4 Pro；日常对话和低延迟场景可以选择 DeepSeek V4 Flash。两个模型的核心差异为：
   • DeepSeek V4 Pro：推理能力更强，支持100万token上下文窗口，适合复杂编码、多步骤任务规划、长文档分析、Agent工作流等对准确率要求高的场景。
   • DeepSeek V4 Flash：响应速度更快，使用成本更低，适合日常对话、简单查询、快速代码补全等对延迟要求高的场景。
4. 发送消息即可开始对话。所有LobeHub的原生功能（如工具调用、知识库、多Agent协作）都可以与DeepSeek模型完美适配。

操作验证：模型标签显示为选择的DeepSeek模型，发送测试消息能正常收到回复，即为配置成功。

_{LobeHub 桌面端模型选择器中的 DeepSeek V4 模型。}

DeepSeek V4 模型在 LobeHub 中会显示 100 万 token 上下文窗口。内置模型卡片已经包含正确的上下文元数据，无需额外配置上下文长度，不用担心长文本被截断的问题。

4. 调整推理强度

推理强度是DeepSeek V4模型的专属参数，用于控制模型的推理计算量，你可以根据不同场景的需求灵活调整，平衡响应速度与推理质量。

LobeHub 会在 DeepSeek V4 的模型参数控制（在对话页面的右上角打开）中提供思考模式配置。日常使用保持默认 high 推理强度即可；复杂编码、规划、多步骤 Agent 任务建议将 推理强度 调整为 max。

LobeHub 中 DeepSeek V4 可用的推理强度：

• none：完全关闭推理，响应速度最快，适合不需要逻辑思考的简单问答、信息查询场景。
• high：默认平衡模式，兼顾推理质量与响应速度，适合90%以上的日常使用场景。
• max：开启全量推理，思考更充分，准确率更高，适合复杂编码、架构设计、多步骤Agent任务、数学推理等场景，但响应时间更长，使用成本更高。

操作验证：调整推理强度后发送消息，模型会按照设定的强度返回结果，max模式下会获得更详实、逻辑更严谨的回答。

5. 可选：自托管环境变量

如果你自托管 LobeHub，并希望在服务端全局提供 DeepSeek 凭据，可以添加以下环境变量并重启服务，所有用户不需要单独配置API Key即可使用DeepSeek模型，适合团队内部使用场景。

DEEPSEEK_API_KEY=sk-xxxxxx
DEEPSEEK_PROXY_URL=https://api.deepseek.com

参数说明：

• DEEPSEEK_API_KEY：服务端全局配置的DeepSeek API Key，所有用户共享该凭据调用DeepSeek服务。
• DEEPSEEK_PROXY_URL：服务端调用DeepSeek API的代理地址，内网部署或需要加速的场景可以配置，普通场景保持默认即可。

如果只想显示 DeepSeek V4 模型，可以继续添加：

DEEPSEEK_MODEL_LIST=-all,+deepseek-v4-pro,+deepseek-v4-flash

参数说明：-all表示隐藏所有默认的DeepSeek模型，+deepseek-v4-pro和+deepseek-v4-flash表示仅显示这两个V4模型，适合想要简化模型列表、避免用户选择旧版本模型的场景。

对于大多数网页端和桌面端用户，在 设置 → 服务模型 → DeepSeek 中完成 UI 配置即可，无需配置环境变量。

常见问题

• 401 或鉴权失败： 根本原因：DeepSeek API无法验证用户身份。 排查方案：检查API Key是否是从DeepSeek开放平台获取的，有没有多余的空格、换行符，是否填写到了API Key输入框而非API 代理地址输入框；确认API Key未过期，DeepSeek账户有足够的余额，未配置IP白名单或当前IP在白名单范围内。
• 找不到模型： 根本原因：模型列表没有正确拉取或启用。 排查方案：点击「获取模型列表」刷新模型列表；检查模型列表中deepseek-v4-pro和deepseek-v4-flash的开关是否已启用；自托管用户确认实例已升级到支持DeepSeek V4的最新版本，环境变量DEEPSEEK_MODEL_LIST没有屏蔽这两个模型。
• 使用代理时连通性检查失败： 根本原因：代理地址配置错误或代理服务不可用。 排查方案：检查代理地址是否包含http://或https://前缀，不能仅填写域名或IP；确认代理服务能正常转发请求到DeepSeek的API端点；若代理需要身份验证，需将身份信息添加到代理地址中。
• 看不到推理强度控制： 根本原因：当前选择的模型不是DeepSeek V4系列模型。 排查方案：确认当前选择的是DeepSeek V4 Pro或DeepSeek V4 Flash，而非其他服务商的转发模型、旧版本DeepSeek模型；确认LobeHub版本支持DeepSeek推理强度配置，自托管用户升级到最新版本即可。
• 调用模型提示上下文过长： 根本原因：输入内容超过了模型的100万token上下文窗口限制。 排查方案：精简输入内容，拆分长任务为多个子任务分多次处理，或者开启知识库功能将长文档上传到知识库中调用。
• 响应速度慢： 根本原因：模型选择或推理强度配置不符合场景需求，或DeepSeek平台当前访问量较高。 排查方案：检查是否选择了max推理强度，简单场景切换为high或none；对响应速度要求高的场景切换为DeepSeek V4 Flash模型。

后续建议

配置完成后，你可以开始创建专属Agent、配置自动化工作流、上传知识库，体验7×24小时的AI Agent团队服务。更多进阶玩法如Agent排班、自定义技能、团队协作可以查看LobeHub官方文档，也可以参考资源库获取更多相关教程。

参考资料

• awesome-deepseek-agent