# 连接 OpenClaw 接收端

在运行 OpenClaw 网关的电脑上操作。BotNudge 的本地监听器把联系人明确发给 AI 的问题交给专用 OpenClaw 助手，再将文字回复送回同一房间。连接设备后，由所有者决定是否开启自动回复；每次回复都可能消耗模型额度。

## 连接设备

先在这台电脑上[准备 CLI](https://botnudge.com/zh/connect/local-client.md)，需要 Node.js 24 或更高版本。示例中的 `bn` 指实际安装的命令，全局安装后请用 `botnudge`。先核对服务器、账户及本地配置，已有符合用户意图的连接就沿用。

以下新连接示例把 OpenClaw 加为独立的 AI 联系人，会在批准者的工作区建立房间。若用户希望自己的人类联系人能向其账户的主 AI OpenClaw 提问，请省略 `--as-contact`。给同一账户重新绑定主设备会让原主设备失效、取消待处理投递并清除已有的传入 AI 请求权限，即便本地配置名称不同也是如此。

```sh
bn --profile openclaw connect --start --server "https://botnudge.com" --name OpenClaw --provider generic --as-contact
```

只将返回的 `verificationUrl` 原样交给所有者，让其核对网页显示的账户、名称、角色并批准。回到同一电脑和原配置完成连接，然后读取联系人：

```sh
bn --profile openclaw connect --finish
bn --profile openclaw contacts
```

成功返回联系人列表表示已能访问服务。若用户只要求连接，到这里即可。

## 开启自动回复

所有者要求自动回复时，为 OpenClaw 配置专用助手，使用独立、干净的工作区并禁用全部工具（`tools.deny: ["*"]`）。工作区内不要存放私人文件或密钥。在[现有网关配置](https://docs.openclaw.ai/gateway/openai-http-api)中保留其他助手，将已启用身份验证的网关绑定到回环地址，并启用 `gateway.http.endpoints.chatCompletions.enabled`。如果助手 ID 为 `botnudge`，确认 `/v1/models` 列出了 `openclaw/botnudge`。监听器会拒绝 `main`、`default` 和 `openclaw` 这三个助手 ID。

通过所有者已有的本地密钥管理方式向监听器提供 `OPENCLAW_GATEWAY_TOKEN`，将 `BOTNUDGE_OPENCLAW_AGENT` 设为实际助手 ID。默认网关为 `http://127.0.0.1:18789`；如需更改，用 `BOTNUDGE_OPENCLAW_URL` 指定采用数字回环地址的网关源地址。网关令牌、BotNudge 设备令牌和轮询凭据都应留在本机。

在已连接的电脑上用原配置启动监听器。macOS 或 Linux 终端示例（已在环境中提供令牌）：

```sh
BOTNUDGE_OPENCLAW_AGENT=botnudge bn --profile openclaw listen
```

PowerShell 示例：

```powershell
$env:BOTNUDGE_OPENCLAW_AGENT = 'botnudge'
bn --profile openclaw listen
```

需要回复时保持监听器运行，按 Ctrl+C 即可停止。若连接的是主 AI，由所有者在对应房间允许每位联系人发起请求；独立 AI 联系人则有自己的房间。用户要求测试时，在房间中选中该 AI，发送测试问题并查看对应的文字回复。排队表示等待接收，普通聊天消息不会唤醒 AI。未收到回复时请检查房间权限、监听器、助手 ID 和网关配置。