用 nanobot 把 AI 养成常驻「数字同事」：港大开源本地 Agent 运行时

nanobot 支持 20+ 模型提供商（OpenRouter、Anthropic、智谱、DeepSeek、火山引擎……），也支持本地 vLLM。新手推荐用有免费额度或便宜的云端模型：

准备项：
· Python 3.10+（Windows / macOS / Linux 都行）
· 一个大模型 API Key（任选其一）：
  - DeepSeek    → deepseek.com 注册，充值几元即可
  - 智谱 GLM     → open.bigmodel.cn，有免费额度
  - OpenRouter  → 一个 Key 能切几十家模型

拿到的 Key 形如 sk-xxxx，复制保存好，别泄露。

三种装法任选，个人用户推荐 PyPI 稳定版：

# 方式 1（推荐，稳定版）
pip install nanobot-ai

# 方式 2（uv，快且干净）
uv tool install nanobot-ai

# 方式 3（源码，含最新功能）
git clone https://github.com/HKUDS/nanobot.git
cd nanobot && pip install -e .

# 验证
nanobot --version

运行 onboard 会自动在 ~/.nanobot 生成配置文件和工作区，然后编辑它填入 Key：

# 1) 初始化（生成 ~/.nanobot/config.json）
nanobot onboard

# 2) 编辑配置文件，填入 Key 与默认模型
{
  "providers": {
    "deepseek": { "apiKey": "sk-你的DeepSeekKey" }
  },
  "agents": {
    "defaults": { "model": "deepseek/deepseek-chat", "provider": "deepseek" }
  }
}

不接任何聊天软件也能用，先在终端里验证它活了：

# 交互式聊天
nanobot agent

# 或单次问答
nanobot agent -m "用三句话介绍你自己，并列出你能帮我省掉哪些重复活"

以 Telegram 为例（3 步，无需公网 IP）：在 config.json 的 channels 里加上 token 和允许的用户，再启动网关。

# config.json 追加
"channels": {
  "telegram": {
    "enabled": true,
    "token": "你的BotFather机器人Token",
    "allowFrom": ["你的Telegram用户ID"]
  }
}

# 启动网关（监听消息并自动回复）
nanobot gateway

nanobot 的「越用越懂你」来自两层记忆（Dream 整理）和定时任务（Heartbeat）。配置好后，它会自动把重要事实写进 MEMORY.md 并在后台常驻：

# 1) 用 systemd 让它在服务器上 7x24 运行（Linux）
# ~/.config/systemd/user/nanobot-gateway.service 写入启动命令后：
systemctl --user enable --now nanobot-gateway
loginctl enable-linger $USER      # 退出登录也继续跑

# 2) 设定时任务：编辑 workspace/HEARTBEAT.md
#    网关每 30 分钟执行一次，把结果推到最近活跃的聊天渠道
#    例：每天早上 9 点总结我的 GitHub 通知 + 待办