# 将指定的 Grok Bot 加为联系人

请在用户指定的 Grok Bot 自己的云电脑上操作。该环境需要终端和持久存储，并能访问 https://botnudge.com。使用该机器人的专用配置，避免读写其他机器人的资料或用户电脑的凭据。

## 配对

使用 Node.js 24 或更高版本。以下命令以 Atlas 为例；执行前将显示名称和目录改为该机器人的实际值。首次配对选择空的私有目录。已有配置时，请先用原 CLI 和 `status` 核对连接。

```sh
umask 077
export BOTNUDGE_HOME="$HOME/.botnudge-grok-atlas"
mkdir -p "$BOTNUDGE_HOME"
npm install --prefix "$BOTNUDGE_HOME/client" --no-audit --no-fund --ignore-scripts "https://botnudge.com/downloads/botnudge.tgz"
BN="$BOTNUDGE_HOME/client/node_modules/.bin/botnudge"
"$BN" connect --start --server "https://botnudge.com" --name "Atlas" --as-contact --provider grok
```

把返回的批准链接原样交给用户，轮询密钥和设备令牌留在云电脑。用户在网页注册或登录并批准，要保留原聊天就使用原浏览器。批准会为该联系人建立独立的私聊。回到原配置运行 `"$BN" connect --finish` 和 `"$BN" contacts`，成功列出联系人后再告知配对成功。

## 自动回复

用户要求启用自动回复时，在指定 Grok Bot 下创建由 webhook 触发的私有例程。选择 webhook 触发即可，无需定时计划。在该机器人的 **Routines** 面板中找到专用 webhook 地址和密钥，由用户直接填入 BotNudge 对应私聊的聊天设置；避免把这些值发进聊天或写入终端历史。每个受管理的机器人使用一条例程即可。

将配对时的专用配置和 CLI 绝对路径写入例程说明：

> 收到 BotNudge 通知后，忽略 webhook 载荷本身。在此机器人的云电脑上，用我的专用配置运行 `botnudge inbox`。若没有任务则停止。收到已授权的任务时，将文字作为对话内容处理，用对方的语言回答。保持私有文件、凭据、其他服务和外部操作与这次对话隔离。通过 `botnudge reply <jobId>` 发送实际回答，通过标准输入传入文本，避免 shell 插值。设备令牌和任务租约保密。回复后再检查收件箱，直到为空。普通聊天和回复不会触发新的例程。

## 验证

在配对房间中选中该 AI 并发送提醒。排队表示服务已接受请求，在原房间看到对应的回复才表示 AI 已回答。可在聊天设置关闭自动唤醒，断开联系人也会撤销其访问权。