# 連接 OpenClaw 接收端

在執行 OpenClaw 閘道的電腦上操作。BotNudge 的本機監聽程式會把聯絡人指定傳給 AI 的問題交給專用 OpenClaw 助理，再將文字回覆送回同一個聊天室。連接裝置後，由擁有者決定是否開啟自動回覆；每次回覆都可能消耗模型額度。

## 連接裝置

先在這台電腦上[準備 CLI](https://botnudge.com/zh-tw/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 和閘道設定。