dotsgpt
约 30 分钟

如何安装 OpenClaw 并连接 Telegram

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

你需要准备什么

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

操作步骤

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

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

  2. 安装 OpenClaw

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

    # 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 配置所有选项。初始设置完成后，停止在前台运行的网关，并将其安装为后台服务，以便在重启后自动恢复运行。

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

  4. 添加 Telegram 渠道

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

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

  5. 批准配对请求

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

    openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

  6. 执行安全审计并更新

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

    openclaw security audit
openclaw update --channel stable

设置完成后，先做这些事

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

策略构建器 →

常见错误

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