NanoBot 安装部署完全指南：从零开始配置你的 AI 助手

本博客全部操作流程均由DeepSeek V4全程辅助完成对话链接https://chat.deepseek.com/share/qhmrckf3owsl8zako5https://chat.deepseek.com/share/1xpi1lj19omi88np1l NanoBot 安装部署完全指南从零开始配置你的 AI 助手NanoBot 是一个轻量级、可扩展的 AI 代理框架支持多种大模型如 DeepSeek、OpenAI 等。本文将手把手带你完成 NanoBot 的安装、初始化以及配置 DeepSeek API 的全过程让你快速拥有一个终端交互式 AI 助手。 一、使用uv安装 NanoBot推荐使用 Python 包管理工具uv进行安装命令如下uv toolinstallnanobot-ai如果你还没有uv可以先通过pip install uv安装。安装成功后终端会显示类似下图的信息️ 二、初始化 NanoBot安装完成后执行初始化命令nanobot onboard该命令会创建必要的配置文件和目录。默认的配置路径为/Users/yourname/.nanobot/config.json注意.nanobot文件夹是隐藏的在 macOS 下需要显示隐藏文件才能看到。Mac 显示隐藏文件小技巧在 Finder 中按下Command Shift .即CMDShift句点即可切换隐藏文件的可见性。按下快捷键后你就能在用户目录下看到.nanobot文件夹了 三、配置 DeepSeek API Key如果你打算使用DeepSeek V4模型或其他 DeepSeek 模型需要先获取 API Key。访问 DeepSeek 控制台https://platform.deepseek.com/usage登录后创建或复制你的 API Key格式类似sk-xxx。然后编辑 NanoBot 的配置文件~/.nanobot/config.json在agents.defaults部分设置模型为 DeepSeek并在openai字段中填入 API 信息。完整配置示例仅展示关键部分{agents:{defaults:{workspace:~/.nanobot/workspace,model:deepseek-v4-pro,provider:openai,maxTokens:8192,contextWindowTokens:65536,contextBlockLimit:null,temperature:0.1,maxToolIterations:200,maxToolResultChars:16000,providerRetryMode:standard,reasoningEffort:null,timezone:UTC,unifiedSession:false,disabledSkills:[],idleCompactAfterMinutes:0,dream:{intervalH:2,modelOverride:null,maxBatchSize:20,maxIterations:15,annotateLineAges:true}}},openai:{apiKey:sk-你的DeepSeek API密钥,apiBase:https://api.deepseek.com/v1,extraHeaders:null}}注意apiBase必须指向 DeepSeek 的 OpenAI 兼容接口地址。model名称请根据 DeepSeek 官方提供的模型名填写如deepseek-chat或deepseek-v4-pro。配置文件的截图示意 四、启动 NanoBot 交互式代理一切就绪后在终端输入nanobot agent首次运行时可能会出现如下警告不影响使用WARNING | nanobot.utils.gitstore:init:68 - Workspace /Users/yangfan/.nanobot/workspace is already inside a git repo; skipping nested repo initialization然后你会进入交互模式显示当前使用的模型如deepseek-v4-pro Interactive mode (deepseek-v4-pro) — type exit or CtrlC to quit You: hi nanobot Hey there! How can I help you today? You:成功现在你可以像与 ChatGPT 对话一样在终端中与 NanoBot 聊天了。 五、常见问题与提示问题解决方案找不到nanobot命令确保uv安装的二进制路径已加入PATH或重新打开终端API Key 无效检查config.json中的apiKey是否正确以及apiBase是否指向 DeepSeek模型名称错误登录 DeepSeek 平台查看可用的模型 ID并修改model字段工作区 git 警告正常现象NanoBot 会在工作区自动初始化 git 仓库用于记忆管理 参考链接NanoBot GitHub 仓库DeepSeek 平台用量控制台Mac 显示隐藏文件方法✅ 结语通过以上步骤你已经成功部署并运行了 NanoBot并接入了 DeepSeek 模型。现在就去终端里和你的 AI 助手愉快地交流吧如果遇到任何问题欢迎查阅 GitHub 仓库的 Issues 或本文评论区讨论。本文内容基于个人实践记录欢迎分享和转载请注明出处。