接入 nanobot

nanobot 是轻量级、易部署的AI智能体框架，核心优势是体积小、资源占用低、支持接入微信、钉钉、飞书、Discord等常用聊天工具，不需要复杂的配置即可快速搭建属于自己的聊天机器人，既适合个人用户打造专属AI助手，也适合小团队快速搭建内部服务机器人。

接入DeepSeek V4模型后，nanobot可以借助DeepSeek的强推理能力、高性价比优势，既能处理复杂的用户查询，又能控制使用成本，同时百万级上下文窗口也能支撑长对话、文档问答等场景，尤其适合AI爱好者、想要搭建聊天机器人的个人用户、需要内部智能助手的小团队使用。

通过本教程，你将掌握nanobot的安装、DeepSeek模型配置、服务启动的全流程操作，最终可以启动一个可接入常用聊天工具、由DeepSeek驱动的AI智能体。

1. 安装 nanobot

本步骤的核心目的是通过uv工具全局安装nanobot，uv会自动处理Python依赖与环境隔离，不会和系统的Python包产生冲突。

• 安装 uv。uv是Astral开发的高性能Python包管理器，比传统pip速度快数倍，是nanobot的推荐安装工具，你可以通过uv --version命令检查是否已安装uv，若未安装可参考uv官方文档快速安装。
• 执行下面的命令安装 nanobot:

uv tool install nanobot-ai

操作目的：通过uv的tool命令全局安装nanobot，uv会自动创建独立的虚拟环境，管理所有Python依赖，避免依赖冲突。

国内用户注意事项：若PyPI下载速度较慢，可以配置uv的国内镜像源，提升安装速度。

• 注意：在 Windows 操作系统下，请将用户根目录下的 .local/bin 目录添加到环境变量中：

$env:PATH = "$env:USERPROFILE\.local/bin;$env:PATH"

• 或者通过 uv 更新终端：

uv tool update-shell

操作目的：uv安装的工具默认存放在用户目录的.local/bin目录下，Windows系统默认不会将该目录添加到PATH环境变量中，需要手动配置，否则无法在终端中直接调用nanobot命令。uv tool update-shell命令会自动修改shell配置文件，添加对应的环境变量，无需手动编辑，更便捷。

• 完成安装后，执行下面的命令，如果显示版本号则安装成功:

nanobot --version

避坑提示：配置环境变量后需要重启终端，新的环境变量才会生效，若仍提示命令不存在，可手动检查.local/bin目录是否已正确添加到PATH中。

2. 配置 nanobot 的配置文件

本步骤的核心目的是生成nanobot的配置文件，配置DeepSeek模型提供商与API凭据，让nanobot可以正常调用DeepSeek的模型服务。

运行下面的命令初始化 nanobot 配置文件：

nanobot onboard

操作目的：nanobot onboard命令会生成默认的配置文件模板，包含所有必要的配置项，你只需要修改少量参数即可完成配置。

不同操作系统生成的配置文件路径如下：

• Windows: $env:USERPROFILE\.nanobot\config.json
• Linux / MacOS: ~/.nanobot/config.json

编辑配置文件 config.json，修改下面的配置项:

{
    "agents": {
        "defaults": {
            "model": "deepseek-v4-pro",
            "provider": "deepseek",
        }
    },
    "providers": {
        "deepseek": {
            "apiKey": "<你的 DeepSeek API Key>",
            "apiBase": "https://api.deepseek.com/v1",
        },
    },
}

参数说明：

• agents.defaults.model：默认使用的AI模型，填写deepseek-v4-pro可以获得最强的推理能力，若更看重成本与响应速度，可替换为deepseek-v4-flash。
• agents.defaults.provider：默认的模型提供商，填写deepseek告诉nanobot调用DeepSeek的API服务。
• providers.deepseek.apiKey：DeepSeek开放平台的API Key，替换为你自己的Key，注意保留双引号。
• providers.deepseek.apiBase：DeepSeek API的服务端点，必须填写为https://api.deepseek.com/v1，不要修改，除非你使用自定义代理服务。

安全提示：配置文件包含你的API Key，请妥善保管，不要提交到公共代码仓库，避免泄露。编辑时注意JSON语法正确，所有字符串用双引号，最后一个配置项后面不要加逗号，否则会导致配置解析失败。

操作验证：保存配置文件后，无语法错误即为配置完成。

3. 开始使用

本步骤的核心目的是启动nanobot的Agent服务，等待用户交互。

在终端中运行：

nanobot agent

操作目的：启动nanobot的Agent服务，默认会开启终端交互模式，你可以直接在终端中与Agent对话，也可以配置聊天工具接入，让用户通过微信、Discord等工具发送请求。

操作验证：终端输出nanobot启动成功的提示，显示服务监听的端口与接入方式，发送测试消息能正常收到回复即为启动成功。

最佳实践

1. 新手配置建议：首次使用建议使用默认配置启动，待熟悉功能后再逐步添加聊天工具接入、自定义技能等配置。
2. 场景化调整：日常简单查询场景可以将默认模型改为deepseek-v4-flash，降低使用成本，提升响应速度；处理复杂任务时再切换回deepseek-v4-pro。
3. 聊天工具接入：你可以在配置文件中添加对应聊天工具的webhook配置，实现微信、钉钉、飞书、Discord等平台的接入，让用户通过常用工具直接访问nanobot。
4. 记忆配置：你可以修改配置文件中的记忆存储参数，选择将对话记忆存储在本地文件或数据库中，实现跨会话的记忆保留。

常见问题

1. 执行nanobot提示命令不存在：检查是否重启了终端，Windows用户确认.local/bin目录已添加到PATH环境变量中，或重新执行uv tool update-shell命令。
2. 启动后提示配置文件解析错误：检查config.json的语法是否正确，有没有遗漏的逗号、引号，配置项名称是否与模板一致，可使用JSON校验工具检查语法。
3. 调用Agent提示API错误：检查API Key是否正确，apiBase是否填写为https://api.deepseek.com/v1（必须带/v1后缀），确认DeepSeek开放平台账户余额充足。
4. 聊天工具接入失败：检查对应平台的webhook配置是否正确，网络是否能正常接收平台的回调请求，端口是否已开放。

后续建议

配置完成后，你可以根据需求配置聊天工具接入、自定义技能、多Agent协作等功能，打造符合自身需求的专属AI智能体。更多进阶玩法可以参考nanobot官方文档，或查看资源库获取更多相关教程。

参考资料

• awesome-deepseek-agent