服务器与命令行
服务器、Mac mini 这类没有界面的机器，可以装命令行常驻程序 waper-node 接给 Agent。它和 桌面端 的执行方式、审批和访问范围都一样，只是没有界面。Agent 能做什么、怎么选电脑，见 让 Agent 用电脑。
支持 macOS 和 Linux，需要 Node.js 22.19 或更高版本。
安装
装好后就可以使用 waper-node 命令。waper-node --help 列出全部命令。
登录
终端会显示一个短码和一个 https://waper.ai/device 开头的网址。在任意一个已登录 waper 的浏览器里（手机也行）打开这个网址，核对短码后点「批准」。只批准你自己刚刚发起的短码。
登录时可以加上这些选项：
| 选项 | 作用 |
|---|---|
--name <名字> |
这台电脑在 waper 里显示的名字，默认是主机名。和 Agent 说「在 <名字> 上……」时用的就是它 |
--folders <a,b> |
只允许 Agent 使用这些文件夹，用逗号分隔，可以写 ~。不加就是整台电脑。之后在 设置 → 电脑 里改 |
例如：
无人值守的部署可以从标准输入传入一个会话令牌，跳过浏览器确认。令牌只从标准输入读，不会出现在命令行参数和 shell 历史里：
运行
在前台运行，终端里会逐条显示 Agent 正在做什么，按 Ctrl+C 停止：
装成后台服务，开机或登录后自动运行、出错自动重启：
-
macOS：装成 launchd 用户代理
ai.waper.node，日志写在~/.waper/logs/node.log。 -
Linux：装成 systemd 用户服务
waper-node.service，日志用journalctl --user -u waper-node查看。用户服务默认在你退出登录后停止，要让它一直运行，请执行一次：
查看或删除服务：
其他命令
| 命令 | 作用 |
|---|---|
waper-node status |
显示服务器地址、电脑名字、是否已登录，以及后台服务的状态 |
waper-node logout |
退出登录：服务端的会话失效，这台电脑上的令牌被删除 |
waper-node browser install |
让 Agent 可以用这台电脑上的 Chromium 系浏览器，见 用你的浏览器 |
这台电脑在 设置 → 电脑 里被断开，或者会话失效时，waper-node run 会提示重新登录并退出，再运行一次 waper-node login 即可。
数据放在哪
waper-node 把数据放在 ~/.waper，这个目录只有你自己的账户能读写。里面有设置、会话令牌、日志、暂存的结果，以及撤销用的旧版本和回收区。这些内容对 Agent 不开放。
想放到别的位置，给每个命令加 --state <目录>，或者设置环境变量 WAPER_STATE_DIR。service install 会把当时用的目录写进服务配置。
命令行的提示文字跟随系统语言（LANG），中文环境显示中文，其他显示英文。