这份专属的 Nanobot 运维指南已经为你整理好了。你可以直接将以下内容复制并保存为 指南.md，方便以后随时查阅。
🤖 Nanobot (树莓派 3B) 运维与使用指南
本指南汇集了在树莓派上维护和调试 Nanobot（配合飞书长连接与火山方舟 Coding Plan）的高频命令与核心操作。
一、 后台服务管理 (Systemd)
Nanobot 已经配置为 Systemd 后台服务，系统重启会自动拉起。.service 后缀在输入命令时可以省略。
- 重启服务 (修改了
config.json或更新代码后，必须执行此命令生效)1
sudo systemctl restart nanobot - 查看运行状态 (检查服务是否正常运行，显示绿色
active (running)即为正常)1
sudo systemctl status nanobot - 停止服务 (需要彻底关闭机器人时使用)
1
sudo systemctl stop nanobot - 启动服务 (停止后重新开启时使用)
1
sudo systemctl start nanobot
二、 实时日志与排错排查
当飞书里发消息机器人没反应，或者需要排查文件解析问题时，查看后台日志是最快的方法。
- 滚动查看实时日志 (按
Ctrl + C退出，不影响程序运行)1
journalctl -u nanobot -f
- 查看最近 100 行日志
1
journalctl -u nanobot -n 100 --no-pager
三、 配置管理与修改
所有核心凭证（API Key、飞书 App ID、模型路由等）都保存在这个独立于源码的系统级配置文件中。
- 编辑配置文件
1
nano ~/.nanobot/config.json
(提示：编辑完成后，依次按
Ctrl + O保存 ->Enter确认文件名 ->Ctrl + X退出，最后记得执行sudo systemctl restart nanobot重启服务生效)
四、 本地命令行调试 (CLI)
有时候需要脱离飞书，直接在树莓派终端里测试大模型连通性或工具调用能力。
(前提：已经配置了全局 alias，或者处于 /home/pi/nanobot 目录下直接调用 ~/.venv/bin/nanobot)
- 查看环境配置概览 (快速检查 API 和默认模型配置状态)
1
nanobot status
- 发起单次对话测试
1
nanobot agent -m "测试一下当前连通性"
- 进入沉浸式连续对话模式
1
nanobot agent
五、 源码更新与环境维护
由于我们使用的是源码可编辑模式（-e）安装，更新框架非常方便，且不会覆盖你的 config.json。
- 进入源码目录
1
cd ~/nanobot - 拉取最新官方代码
1
git pull
- 重启服务让新代码生效
1
sudo systemctl restart nanobot
💡 快捷命令设置 (Alias)
为了避免每次都要输入又长又臭的虚拟环境路径，请确保你的 ~/.bashrc 文件末尾包含以下别名配置：
1
2
# 快速调用虚拟环境中的 nanobot
alias nanobot='/home/pi/nanobot/.venv/bin/nanobot'
如果还没有添加，可以使用 nano ~/.bashrc 添加到底部，然后执行 source ~/.bashrc 使其立即生效。
*** 如果你在搭建公司知识管理系统的过程中需要增加特定的文档解析插件，或者遇到复杂的飞书权限配置问题，可以随时拿出这份指南调出日志，我们继续见招拆招！
