尧图网页设计 
awesome-deepseek-agent 指南将 DeepSeek 接入轻量级 AI Agent nanobot【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agentnanobot 是一个开源轻量级 AI Agent支持接入常用聊天工具并内置记忆与 MCP 等扩展能力。本文以本仓库中的 docs/nanobot.md 指南为骨架完整演示如何在本地安装 nanobot、初始化配置文件、将 DeepSeek-V4-Pro 配置为默认模型与提供商并完成首次运行。读完本文你将掌握uv tool install nanobot-ai、nanobot onboard、nanobot agent三条核心命令的完整用法以及跨平台配置文件路径与关键配置字段的准确含义。nanobot 是什么根据仓库 README.md 工具表中的定位nanobot 是开源轻量级 AI Agent支持接入聊天工具、记忆、MCP 等能力原文Open-source lightweight AI agent with chat platform integration, memory, MCP, and more。这意味着它既能作为独立的命令行 Agent 使用也可以接入你常用的聊天平台把 DeepSeek 的对话与工具调用能力带到日常通讯场景中。本文档只聚焦最核心的一环把 DeepSeek 接入 nanobot 的完整流程即安装 → 配置 → 首次运行三步。第一步安装 nanobot1.1 前置条件安装 uvnanobot 通过 uv 分发与安装。uv 是一个 Python 包与工具管理器其uv tool子命令专门用于管理命令行工具的安装。请先完成 uv 的安装再执行后续步骤。1.2 使用 uv 安装 nanobot执行以下命令uv tool install nanobot-ai从指南中 Windows 提示将用户主目录下的.local/bin加入 PATH可以推断uv tool install默认把工具的可执行文件安装到用户主目录下的.local/bin目录而不是系统级目录因此普通用户无需管理员权限即可完成安装。1.3 Windows 用户的 PATH 配置在 Windows 上安装完成后.local/bin可能不在 PATH 中导致终端无法直接找到nanobot命令。有两种处理方式方式一在 PowerShell 中将用户主目录下的.local/bin临时加入当前会话的 PATH$env:PATH $env:USERPROFILE\.local\bin;$env:PATH方式二通过 uv 自动更新终端配置将工具目录注册到 shell 的启动文件中uv tool update-shell注意方式一只对当前终端会话生效新开的终端仍需重新设置方式二会写入 shell 配置文件之后新开终端也能直接使用nanobot命令。1.4 验证安装安装完成后执行版本检查命令。如果终端输出版本号说明安装成功nanobot --version第二步初始化 nanobot 配置2.1 运行 onboard 命令执行以下命令初始化 nanobot 的配置文件nanobot onboard从指南流程可以推断onboard会在用户目录下生成一份默认的 nanobot 配置文件模板后续所有提供商与模型的设置都在该文件中完成。2.2 配置文件路径nanobot 的配置文件路径因操作系统而异Windows$env:USERPROFILE\.nanobot\config.jsonLinux / macOS~/.nanobot/config.json也就是说配置文件统一存放在用户主目录下的.nanobot隐藏目录中。第三步配置 DeepSeek 提供商与默认模型3.1 完整配置示例用编辑器打开上面的config.json参照下面的结构进行修改将你的 DeepSeek API Key替换为从 DeepSeek 开放平台获取的真实密钥{ agents: { defaults: { model: deepseek-v4-pro, provider: deepseek } }, providers: { deepseek: { apiKey: 你的 DeepSeek API Key, apiBase: https://api.deepseek.com/v1 } } }3.2 配置字段逐项解析配置文件顶层包含两个对象agents与providers。agents.defaults定义所有 Agent 的默认行为。当某个 Agent 没有单独指定模型或提供商时将采用这里的默认值。model默认模型名文档中使用deepseek-v4-pro。provider默认使用的提供商名称文档中为deepseek对应下方providers对象中定义的键名。providers.deepseek定义名为deepseek的模型提供商其中包含两个字段apiKeyDeepSeek 的 API 密钥用于请求鉴权。apiBaseDeepSeek API 的服务地址文档中为https://api.deepseek.com/v1nanobot 会向该地址发送模型请求。3.3 关于模型命名的说明根据仓库 CONTRIBUTING.md 中模型命名一节的规范DeepSeek 已弃用 V3 时代的旧名称如deepseek-chat、deepseek-reasoner、deepseek-coder当前应统一使用deepseek-v4-pro/deepseek-v4-flash这类新名称。指南中使用的deepseek-v4-pro符合这一规范。如果你在别处看到旧模型名请务必更新为当前名称否则请求可能失败或行为不符合预期。3.4 1M 上下文与推理强度的可选配置同仓库的 CONTRIBUTING.md 还指出DeepSeek V4 模型支持最高 1,000,000 token1M的上下文窗口DeepSeek V4 Pro 支持max、high等多种推理强度reasoning effort级别。是否能在 nanobot 中启用这些能力取决于工具本身是否暴露对应配置字段——仓库指南未提供 nanobot 侧的具体字段如需启用可结合 DeepSeek 官方 API 文档确认对应参数后再在config.json中尝试。第四步首次运行 nanobot配置保存后在终端中运行nanobot agentnanobot 将按配置文件中的设置以deepseek提供商、deepseek-v4-pro模型启动 Agent。此后即可开始与 Agent 交互如需进一步接入常用聊天工具或启用记忆、MCP 等扩展能力可继续查阅 nanobot 官方文档。常见问题排查找不到 nanobot 命令Windows检查.local/bin是否已加入 PATH或执行uv tool update-shell后重启终端。Linux / macOS确认~/.local/bin是否在 PATH 中。nanobot --version 无输出或报错确认安装命令执行成功且无网络错误可重新执行uv tool install nanobot-ai修复安装。配置未生效确认修改的是正确平台对应的配置文件路径修改配置后需要重新启动nanobot agent检查 JSON 语法是否合法。注意原文档示例中键值对末尾保留了尾逗号trailing comma若解析器采用严格 JSON 规范请移除最后一个键值对后的逗号否则配置文件可能无法被解析。API 请求失败检查apiKey是否正确填写确认apiBase与 DeepSeek 当前 API 地址一致确认模型名使用当前命名deepseek-v4-pro/deepseek-v4-flash而非 V3 旧名称。安全提示不要把包含真实 API Key 的config.json提交到版本库或分享给他人建议为密钥设置独立访问权限必要时在 DeepSeek 开放平台轮换密钥。总结本文完整复现了仓库指南 docs/nanobot.md 的全部操作步骤并补充了配置字段解析、模型命名规范与常见问题排查建议。核心操作只有三步uv tool install nanobot-ai完成安装nanobot onboard初始化配置文件nanobot agent启动运行。本指南同时提供简体中文版本。如需继续将 DeepSeek 接入更多工具可浏览仓库 README.md 中的完整工具列表例如 Cherry Studio、Claude Code、Cline 等。【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 awesome-deepseek-agent 指南：将 DeepSeek 接入轻量级 AI Agent nanobot
awesome-deepseek-agent 指南将 DeepSeek 接入轻量级 AI Agent nanobot【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agentnanobot 是一个开源轻量级 AI Agent支持接入常用聊天工具并内置记忆与 MCP 等扩展能力。本文以本仓库中的 docs/nanobot.md 指南为骨架完整演示如何在本地安装 nanobot、初始化配置文件、将 DeepSeek-V4-Pro 配置为默认模型与提供商并完成首次运行。读完本文你将掌握uv tool install nanobot-ai、nanobot onboard、nanobot agent三条核心命令的完整用法以及跨平台配置文件路径与关键配置字段的准确含义。nanobot 是什么根据仓库 README.md 工具表中的定位nanobot 是开源轻量级 AI Agent支持接入聊天工具、记忆、MCP 等能力原文Open-source lightweight AI agent with chat platform integration, memory, MCP, and more。这意味着它既能作为独立的命令行 Agent 使用也可以接入你常用的聊天平台把 DeepSeek 的对话与工具调用能力带到日常通讯场景中。本文档只聚焦最核心的一环把 DeepSeek 接入 nanobot 的完整流程即安装 → 配置 → 首次运行三步。第一步安装 nanobot1.1 前置条件安装 uvnanobot 通过 uv 分发与安装。uv 是一个 Python 包与工具管理器其uv tool子命令专门用于管理命令行工具的安装。请先完成 uv 的安装再执行后续步骤。1.2 使用 uv 安装 nanobot执行以下命令uv tool install nanobot-ai从指南中 Windows 提示将用户主目录下的.local/bin加入 PATH可以推断uv tool install默认把工具的可执行文件安装到用户主目录下的.local/bin目录而不是系统级目录因此普通用户无需管理员权限即可完成安装。1.3 Windows 用户的 PATH 配置在 Windows 上安装完成后.local/bin可能不在 PATH 中导致终端无法直接找到nanobot命令。有两种处理方式方式一在 PowerShell 中将用户主目录下的.local/bin临时加入当前会话的 PATH$env:PATH $env:USERPROFILE\.local\bin;$env:PATH方式二通过 uv 自动更新终端配置将工具目录注册到 shell 的启动文件中uv tool update-shell注意方式一只对当前终端会话生效新开的终端仍需重新设置方式二会写入 shell 配置文件之后新开终端也能直接使用nanobot命令。1.4 验证安装安装完成后执行版本检查命令。如果终端输出版本号说明安装成功nanobot --version第二步初始化 nanobot 配置2.1 运行 onboard 命令执行以下命令初始化 nanobot 的配置文件nanobot onboard从指南流程可以推断onboard会在用户目录下生成一份默认的 nanobot 配置文件模板后续所有提供商与模型的设置都在该文件中完成。2.2 配置文件路径nanobot 的配置文件路径因操作系统而异Windows$env:USERPROFILE\.nanobot\config.jsonLinux / macOS~/.nanobot/config.json也就是说配置文件统一存放在用户主目录下的.nanobot隐藏目录中。第三步配置 DeepSeek 提供商与默认模型3.1 完整配置示例用编辑器打开上面的config.json参照下面的结构进行修改将你的 DeepSeek API Key替换为从 DeepSeek 开放平台获取的真实密钥{ agents: { defaults: { model: deepseek-v4-pro, provider: deepseek } }, providers: { deepseek: { apiKey: 你的 DeepSeek API Key, apiBase: https://api.deepseek.com/v1 } } }3.2 配置字段逐项解析配置文件顶层包含两个对象agents与providers。agents.defaults定义所有 Agent 的默认行为。当某个 Agent 没有单独指定模型或提供商时将采用这里的默认值。model默认模型名文档中使用deepseek-v4-pro。provider默认使用的提供商名称文档中为deepseek对应下方providers对象中定义的键名。providers.deepseek定义名为deepseek的模型提供商其中包含两个字段apiKeyDeepSeek 的 API 密钥用于请求鉴权。apiBaseDeepSeek API 的服务地址文档中为https://api.deepseek.com/v1nanobot 会向该地址发送模型请求。3.3 关于模型命名的说明根据仓库 CONTRIBUTING.md 中模型命名一节的规范DeepSeek 已弃用 V3 时代的旧名称如deepseek-chat、deepseek-reasoner、deepseek-coder当前应统一使用deepseek-v4-pro/deepseek-v4-flash这类新名称。指南中使用的deepseek-v4-pro符合这一规范。如果你在别处看到旧模型名请务必更新为当前名称否则请求可能失败或行为不符合预期。3.4 1M 上下文与推理强度的可选配置同仓库的 CONTRIBUTING.md 还指出DeepSeek V4 模型支持最高 1,000,000 token1M的上下文窗口DeepSeek V4 Pro 支持max、high等多种推理强度reasoning effort级别。是否能在 nanobot 中启用这些能力取决于工具本身是否暴露对应配置字段——仓库指南未提供 nanobot 侧的具体字段如需启用可结合 DeepSeek 官方 API 文档确认对应参数后再在config.json中尝试。第四步首次运行 nanobot配置保存后在终端中运行nanobot agentnanobot 将按配置文件中的设置以deepseek提供商、deepseek-v4-pro模型启动 Agent。此后即可开始与 Agent 交互如需进一步接入常用聊天工具或启用记忆、MCP 等扩展能力可继续查阅 nanobot 官方文档。常见问题排查找不到 nanobot 命令Windows检查.local/bin是否已加入 PATH或执行uv tool update-shell后重启终端。Linux / macOS确认~/.local/bin是否在 PATH 中。nanobot --version 无输出或报错确认安装命令执行成功且无网络错误可重新执行uv tool install nanobot-ai修复安装。配置未生效确认修改的是正确平台对应的配置文件路径修改配置后需要重新启动nanobot agent检查 JSON 语法是否合法。注意原文档示例中键值对末尾保留了尾逗号trailing comma若解析器采用严格 JSON 规范请移除最后一个键值对后的逗号否则配置文件可能无法被解析。API 请求失败检查apiKey是否正确填写确认apiBase与 DeepSeek 当前 API 地址一致确认模型名使用当前命名deepseek-v4-pro/deepseek-v4-flash而非 V3 旧名称。安全提示不要把包含真实 API Key 的config.json提交到版本库或分享给他人建议为密钥设置独立访问权限必要时在 DeepSeek 开放平台轮换密钥。总结本文完整复现了仓库指南 docs/nanobot.md 的全部操作步骤并补充了配置字段解析、模型命名规范与常见问题排查建议。核心操作只有三步uv tool install nanobot-ai完成安装nanobot onboard初始化配置文件nanobot agent启动运行。本指南同时提供简体中文版本。如需继续将 DeepSeek 接入更多工具可浏览仓库 README.md 中的完整工具列表例如 Cherry Studio、Claude Code、Cline 等。【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考