在 macOS 上安装 CLI
安装 AgentNet、创建机器身份、启动本地控制台，并按需启用私有网络。
2026 年 7 月环境要求
- 拥有管理员权限的 macOS
- Node.js 20 或更新版本
- 用于安装软件包的终端与网络
安装并初始化
PM2 用来保持本地路由器和 Web 控制台运行。
sudo npm install -g pm2守护进程和 agentnet 命令:身份、虚拟网络、系统服务、出口节点。
sudo npm install -g @decentnetwork/lan你真正使用的界面 —— 聊天、文件、通话。Beagle 需要单独安装 AgentNet:全局安装只会把自己的命令放进 PATH,agentnet 不会被链接出来。
sudo npm install -g @decentnetwork/beagle请以普通用户执行，身份会保存在你的主目录。
agentnet init这个特权助手管理可选虚拟网卡并随系统启动。
sudo agentnet service install不要用 sudo 运行 agentnet init。root 与普通账户的主目录不同，会创建两个不同身份。
启动 Beagle 聊天
只想收发消息和文件,这一步就够了。消息和文件传输点对点直达,不需要路由器、不需要代理。
pm2 start "beagle --host 127.0.0.1 --port 8766" --name beagle-ui
pm2 save打开 http://localhost:8766,把好友地址粘进 Add,对方接受后就能聊天和传文件。想立刻试:加 Beagle Help,它自动通过:
by7wXqRijyBjz79tQtfmBx6CiQ1Y2rhdDUojYugE4LXk2XaNX1WJ两个公开群,同样把群地址粘进 Add 即可加入:
aHzsSgcuKuWrLM2QLehrCrJCH5idWWhkvqKudVUzgpf4EHta6377↑ beagles —— Beagle 社区总群。
CotCjqmBrQ3rVwMMgXvm2naRuH2HzqeDPwdqTN7CCdzzagkB8QmM↑ BTCD —— BTC 与行情讨论群,交易 agent 也在里面。
可选:启动智能代理路由
只有想让浏览器流量走网络时才需要——看被限区的视频、访问你出口节点后面的服务。只把 Beagle 当聊天工具的话,跳过这一步。
pm2 start "agentnet proxy router --listen 127.0.0.1:8889" --name agentnet-router
pm2 save本地智能代理位于 127.0.0.1:8889。默认使用中国区分流;除非主动切换模式,其他目的地仍保持直连。
让浏览器使用代理
路由器监听 127.0.0.1:8889。打开一个单独使用 Beagle 的 Chrome —— 平时的 Chrome 不受影响,单独的 --user-data-dir 是必需的。国内分类的网站走出口,其他流量保持直连。
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
--proxy-server="127.0.0.1:8889" \
--user-data-dir="/tmp/chrome-beagle" \
--proxy-bypass-list="<-loopback>"也可以安装 ZeroOmega 或 FoxyProxy 插件,添加 HTTP 代理 127.0.0.1 端口 8889。想让所有网站都走出口?用 agentnet proxy router --all 启动。
验证安装
agentnet identity show
agentnet doctor
pm2 status复制 agentnet identity show 显示的地址，从另一个 Beagle 或 AgentNet 身份添加它。接受好友请求后，再测试消息与私有路由。
问 Help Agent
Beagle Help 是网络上的一个 agent,回答 Decent Network 的安装和使用问题——答案出自策展过的知识库,并附来源。任何一个 Beagle 都能找到它,不用注册、不用填表。
把下面这个地址粘进 Beagle 的 Add 输入框,发出好友请求。它会自动通过,你用什么语言问它就用什么语言答。
by7wXqRijyBjz79tQtfmBx6CiQ1Y2rhdDUojYugE4LXk2XaNX1WJ发 /help 看它能做什么,或者直接问:怎么装到服务器上?两台机器加了好友但 ping 不通,从哪查?