安装 Agim

三种安装方式自选：交互式脚本最适合干净机器，npm 全局适合熟悉运维的用户，源码构建适合贡献者。

1 1 · 交互式安装（推荐）

一个只问三个问题的 bash 脚本——界面语言、ACP 端口和 Web 端口。它会从 npm 装好 `agim-cli`（命令是 `agim`），写入最小的 `~/.agim/config.json`（升级用户继续用 `~/.im-hub/`），root 身份运行时还会自动生成 systemd 单元，最后把你交给 `agim config` 去选 IM 渠道、agent、SMTP、百度地图 AK 等。可重复跑，任何提问处都能 Ctrl-C 中止。

以 root 运行时会自动写一个 systemd 单元；否则用 `agim start` 前台跑。

同一份脚本——`uname -s` 自动识别 Darwin。没装 Node.js 的话先 `brew install node`（Node 22+）。

不支持原生 Windows，请走 WSL2 + Ubuntu。第一行装 WSL（只跑一次，可能要重启）；第二行在 Ubuntu 里跑安装器。

需要 curl、bash、npm 和 Node.js ≥ 22。用最终拥有 ~/.agim 的用户执行（如果机器上已经有 0.x 装的 ~/.im-hub，会自动沿用）。

2 2 · npm 全局安装

直接全局安装 agim，配置自带。schema 见 README。

3 3 · 源码构建

clone → 装依赖 → build → 跑。想魔改 agent 层或新增 messenger 的人走这条。

下一步

装完后在 IM 里发 /help 确认 bot 在线。/agents 列出已注册 agent，/status 看连接状态。完整命令参考见 README。

卸载

停掉并删除 systemd 服务、卸载全局 CLI，并清空 `~/.agim`。也会清理 pre-v1.0 残留的 `~/.im-hub` / `im-hub.service`。如果 CLI 是系统全局安装（不是走 nvm），`npm uninstall` 前请加 `sudo`。`systemctl` 那几行在 macOS / WSL1 上会静默无效。