当前位置：首页 > news >正文

配置nanobot的详细教程（已完善）（有错误请指出）谢谢

news 2026/6/8 0:50:39

声明：该项目是来自于GitHub 上的nanobot（主仓库：HKUDS/nanobot）是超轻量级个人 AI 助手 / 智能体框架，由香港大学数据科学实验室（HKUDS）开发。

该项目地址为：HKUDS/纳米机器人：“🐈纳米机器人：超轻量级OpenClaw”

配置步骤：首先先下载Git

下载安装后是个类似于Windows终端的窗口，然后在终端输入 git clone https://github.com/HKUDS/nanobot.git 把项目克隆下来

（温馨提示：如果你想把该项目拷到D盘或其他盘上,可以在终端输入D:就会自动进入D盘了，其他盘也是如此，如果你想进入到具体的文件夹先进入具体盘再使用cd命令进入相应的文件夹位置）

（如果以后项目更新你可以在终端进入你项目的文件夹位置，然后使用git pull来更新你的项目）

运行这个项目首先需要Python环境到达3.11及以上

我这里就介绍下载Python3.14版本
第一步：进入Pyhton官方网站：
https://www.python.org/downloads/release/python-3140/
往下拉找到：Windows Installer (64-bit)点它下载。
第二步：安装
安装包打开后
要勾选：Add python.exe to PATH（不勾这个，后面命令用不了！）
然后点：Install Now（默认安装）
第三步：验证是否安装成功
打开终端输入：python --version或py --version
如果显示Python 3.14.0就说明安装成功了

(这个条件一开始我没看清楚，导致踩了很多坑，这也告诉我要仔细看清楚文档)

cd D:\nanobot\nanobot-main #进入nanobot的项目文件夹，你可以找到自己的文件位置，复制地址，再使用cd命令

终端执行了pip install .
然后终端输入D:进入D盘目录
cd进入nanobot的目录，然后执行 pip install .(一定要加上点，点是表示当前目录下载，除非你使用绝对路径)
然后输入nanobot --help如果显示
“No such command 'nanobot'”
就可以尝试使用 pip show nanobot , 如果显示
WARNING: Package(s) not found: nanobot就是nanobot还没下载
执行pip install nanobot
再一次执行pip show nanobot可以看到 version 和 Location
保持源目录不变, 执行 nanobot --help
如果弹出
File "<frozen runpy>", line 198, in _run_module_as_main File "<frozen runpy>", line 88, in _run_code
这个问题就是版本冲突了
终端执行pip uninstall nanobot -y删除原版本冲突，
在项目根目录以开发模式安装源码（会自动处理依赖和入口）pip install -e .
安装完成后，直接使用命令nanobot --help就会弹出 nanobot - Persional AI Assistant

然后初始化环境终端运行nanobot onboard，然后输入y表示同意执行这一步会生成配置文件和工作目录，是后续操作的保障

然后找到 config.json 通常在 C:\Users\你的用户名\.nanobot 就能找到.json文件了

因为飞书太麻烦了，需要公网IP地址，然后还要企业认证，还需要订阅等其他东西，
了解到自己本身没有资源，而且自己的用途比较少，只有写代码，文档，整理笔记等所以最终我选择使用终端运行这个项目

打开文件夹输入C:\Users\你的用户名\.nanobot这个地址，就会看到一个config.json文件

我这里就给大家演示一下，我这自己的nanobot是使用Deepseek模型，其他模型你也可以使用

这个config.json文件可以使用vs code打开
打开后，修改自己的模型
如果你也是Deepseek可以先进入到Deepseek官网，然后点击API开放平台，进入后可以先充值1元进去当测试用的，开启那个API keys，开启API keys之后一定要复制，好好保存起来，如果丢失就要重新创建（！！！记住API keys不要随便给别人，丢失记得及时删除重新生成）。
如果想详细了解Token的收费，可以在https://platform.deepseek.com/api_keys左下角找到API文档，里面就有Token用量计算。

进入config.json文件

"agents": { "defaults": { "workspace": "~/.nanobot/workspace", "model": "deepseek-chat", // 这里Deepseek的模型接口，详细可以查看API文档 "provider": "deepseek", // 这里使用的提供平台是Deepseek "maxTokens": 8192, "temperature": 0.1, "maxToolIterations": 40, "memoryWindow": 100, "reasoningEffort": null } }, // 配置完这里后 // 往下滑动，找到deepseek的配置 "deepseek": { "apiKey": "这个是你自己创建的API keys", "apiBase": "https://api.deepseek.com", // 这个apiBase他的接口文档有的 "extraHeaders": null },

然后保存文件，重新进入终端输入命令nanobot agent 就可以直接运行该项目了
运行项目
- 运行终端 Win + R 输入 cmd
- 输入nanobot 会进入这个页面
- 再输入nanobot agent即可进入AI界面，出现You即可使用
  - 进入到这个界面说明nanobot安装成功了
  - 如果不可以使用，一般都是API密钥或账号输错、有可能是格式错误了。

查看全文

http://www.jsqmd.com/news/604116/