OpenClaw安装教程：nanobot镜像内核服务（gateway）启动与端口映射说明

带你玩遍北海道

136人浏览 · 2026-03-07 00:47:25

带你玩遍北海道 · 2026-03-07 00:47:25 发布

OpenClaw安装教程：nanobot镜像内核服务（gateway）启动与端口映射说明

1. 引言：认识超轻量级的个人AI助手

你是否想过拥有一个属于自己的AI助手，它不仅能理解你的指令，还能帮你执行任务、查询信息，甚至集成到QQ里成为你的专属聊天机器人？今天要介绍的 nanobot，就是这样一个神奇的工具。

nanobot是一款受OpenClaw启发的超轻量级个人人工智能助手。它的核心魅力在于“轻”——整个项目仅需约4000行代码就能提供核心的代理功能。相比之下，一些同类项目（如Clawdbot）的代码量可能高达43万行。这意味着nanobot的体积小了99%，部署更快，资源占用更少，但功能却依然强大。

这个镜像已经内置了使用vLLM部署的Qwen3-4B-Instruct-2507模型，并集成了chainlit作为交互界面。你可以直接用它进行对话和推理，也可以按照教程，轻松配置成QQ聊天机器人。无论你是AI爱好者、开发者，还是只是想体验一下私有化AI助手的魅力，这篇教程都将手把手带你完成部署。

2. 环境准备与镜像启动

在开始之前，你需要确保已经获取并启动了nanobot镜像。这个过程通常很简单，就像启动一个普通的容器一样。启动后，系统会自动进行一些初始化设置，包括加载预置的Qwen3-4B模型。

为了确认一切就绪，我们首先需要检查核心的模型服务是否成功部署。

2.1 验证模型服务状态

模型服务是nanobot的大脑。我们可以通过一个简单的命令来查看它的启动日志。

打开你的终端或WebShell，输入以下命令：

cat /root/workspace/llm.log

这个命令会显示模型服务的启动日志。如果部署成功，你应该能看到类似下图的输出，其中包含模型加载完成、服务启动成功的提示信息。

模型服务部署成功日志

看到“服务启动成功”或“模型加载完毕”之类的关键信息，就说明AI大脑已经准备就绪，可以开始交互了。

3. 快速上手：使用Chainlit与nanobot对话

模型服务在后台运行起来后，我们怎么和它对话呢？nanobot镜像贴心地集成了Chainlit，这是一个非常友好的Web交互界面，让你像使用ChatGPT网页版一样与AI交流。

3.1 访问Chainlit界面

通常，Chainlit服务会在容器启动后自动运行。你需要找到它对外暴露的访问地址和端口。这个信息一般在镜像的启动说明或容器管理页面可以找到。在浏览器中打开对应的地址（例如 http://你的服务器IP:端口），你就能看到Chainlit的聊天界面了。

Chainlit交互界面

界面非常简洁，中间是对话区域，下方是输入框。现在，你可以开始向你的AI助手提问了。

3.2 进行第一次提问

让我们问一个实用的问题，测试一下它的“行动力”。在输入框中键入：

使用nvidia-smi看一下显卡配置

然后按下回车。nanobot会理解你的指令，并尝试在后台执行这个命令，然后将结果返回给你。这个过程可能会花费几秒钟时间。

提问并获取系统信息回复

如上图所示，nanobot成功地执行了nvidia-smi命令，并将显卡的详细信息清晰地展示了出来。这说明它不仅仅是一个聊天模型，更是一个可以执行指令、与你环境交互的智能代理。

4. 功能进阶：将nanobot接入QQ机器人

让AI助手待在网页里固然方便，但如果它能进驻我们最常用的QQ，随时响应，岂不是更酷？nanobot支持通过gateway（网关）服务接入QQ开放平台，变身成为你的专属QQ机器人。

4.1 准备工作：创建QQ机器人应用

首先，你需要有一个QQ机器人。别担心，个人也可以申请。

访问平台：打开QQ开放平台官网（https://q.qq.com/#/apps），使用你的QQ号登录。
创建机器人：在控制台找到“创建应用”或类似的按钮，选择创建“机器人”类型应用。
完善信息：按照指引填写应用名称、描述等基本信息。

在QQ开放平台创建机器人应用

创建成功后，进入应用的管理页面，找到最关键的凭证信息。

4.2 获取关键凭证：AppID与AppSecret

要让nanobot和QQ平台通信，需要两个“钥匙”：AppID和AppSecret。

在机器人应用的“开发管理”或“基础信息”页面。
找到“AppID”和“AppSecret”（或“AppKey”）。AppSecret通常需要点击“查看”或“重置”才能获取，请妥善保管。

获取AppID和AppSecret

记下这两串字符，我们马上就需要用到它们。

4.3 配置nanobot连接QQ

现在，回到你的nanobot镜像环境中，我们需要修改配置文件，告诉nanobot如何连接你刚创建的QQ机器人。

使用文本编辑器打开nanobot的配置文件：
```
vim /root/.nanobot/config.json
```
（如果你不熟悉vim，也可以使用nano或其他你喜欢的编辑器。）
在配置文件中，找到或添加 channels 配置部分。你需要将其修改为如下结构，并填入你自己的AppID和AppSecret：
```
{
  "channels": {
    "qq": {
      "enabled": true,
      "appId": "YOUR_APP_ID_HERE",
      "secret": "YOUR_APP_SECRET_HERE",
      "allowFrom": []
    }
  }
}
```
- enabled: true：启用QQ通道。
- appId：替换成你从QQ开放平台复制的AppID。
- secret：替换成你从QQ开放平台复制的AppSecret。
- allowFrom：这是一个数组，可以指定允许接收消息的QQ号或群号。如果为空数组 []，则接收所有消息（测试阶段可以这样设置）。
保存并退出编辑器。

4.4 启动核心网关（Gateway）服务

配置完成后，nanobot需要一个“网关”来接收和转发QQ平台的消息。这个服务就是 gateway。

在终端中执行以下命令启动网关服务：

nanobot gateway

如果一切配置正确，你会看到服务启动成功的提示，通常包括监听的端口号（例如3000）和“服务已启动”等信息。

nanobot gateway服务启动成功

重要提示：这个nanobot gateway命令会启动一个服务进程。如果你关闭了当前终端窗口，这个服务可能会停止。在生产环境中，你可能需要使用nohup、systemd或screen等工具让它保持在后台运行。

4.5 配置端口映射与网络访问

上一步启动的gateway服务默认只在容器内部监听（如127.0.0.1:3000）。要让QQ开放平台的回调消息能发送到这个服务，你必须将容器的端口映射到宿主机，并确保宿主机防火墙允许该端口的访问，且具备公网IP或能被QQ服务器访问到的网络环境。

关键步骤：

停止当前容器（如果正在运行）。
重新启动容器，并添加端口映射参数。例如，使用Docker命令时：
```
docker run -p 3000:3000 ...(其他参数) your-nanobot-image
```
这会将容器内的3000端口映射到宿主机的3000端口。
在QQ开放平台配置：进入你的机器人应用管理后台，在“消息推送”或“Webhook”设置中，将URL填写为 http://你的公网IP或域名:3000/qq/callback。QQ服务器会将消息推送到这个地址。