# 如何安装 OpenClaw 并连接 Telegram

从一台刚准备好的机器开始，到一个能在 Telegram 中回复你的智能体，预计需要约半小时。这里列出的命令来自官方文档，请对照你所安装的版本进行核实。

## 你需要准备什么

- 一台运行 macOS、Linux、WSL2 或 Windows 的电脑或 VPS
- Node 24.16+ 或 Node 26；安装程序也可以为你安装
- 模型的 API 密钥或订阅，或者本地模型
- 一个 Telegram 账户

## 操作步骤

### 1. 选择机器并创建机器人

笔记本电脑适合试用；若要让智能体始终在线，建议使用小型 VPS 或家用服务器，并且绝不能将网关端口开放到互联网。在 Telegram 中仔细核对用户名后，向 @BotFather 发送消息，运行 /newbot 并复制它提供的令牌。

### 2. 安装 OpenClaw

运行适用于你系统的官方安装程序。它会检测操作系统，在缺少 Node 时将其安装，然后安装 OpenClaw 并启动初始设置。

```bash
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
```

### 3. 完成初始设置并安装网关服务

选择 Quick start 以沿用它检测到的 AI 访问配置，或选择 Custom setup 配置所有选项。初始设置完成后，停止在前台运行的网关，并将其安装为后台服务，以便在重启后自动恢复运行。

```bash
openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install
```

### 4. 添加 Telegram 渠道

使用你的机器人令牌将 Telegram 添加为频道。然后检查频道状态，确认连接正常。

```bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
```

### 5. 批准配对请求

给机器人发送任意消息。未知发送者收到的不是回复，而是配对码；请查看待处理请求，并在一小时内批准自己的配对码。

```bash
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

### 6. 执行安全审计并更新

运行内置安全审计，并从稳定频道更新。早于 2026.4.22 的版本存在已知严重漏洞，因此不要继续使用这些版本。

```bash
openclaw security audit
openclaw update --channel stable
```

## 设置完成后，先做这些事

- 将 dmPolicy 保持为 pairing，避免找到你机器人的陌生人使用它。
- 在确认设置可靠之前，将 exec approvals 设为始终询问。
- 定期重复执行安全审计并更新。

## 常见错误

- 暴露网关端口，而不是让 gateway.bind 保持为 loopback 并通过 SSH 或 Tailscale 连接。
- 安装大量第三方技能；请像对待浏览器扩展一样谨慎，只从信任的来源添加少数技能。
- 忘记陷入循环的智能体会持续消耗模型令牌。