1. 首页
  2. 设置
  3. OpenClaw
设置指南 · 约 30 分钟

如何安装 OpenClaw:Telegram 设置指南

预留约半小时,即可从一台空白设备开始,搭建一个自托管代理,让它通过 Telegram 回复,并遵循你亲自编写的规则。

分步指南

  1. 选择运行设备

    用笔记本电脑试用 OpenClaw 没问题,但如果希望代理全天候可用,最好将它部署在始终开机的设备上,例如家用服务器或租用的 VPS,因为只有设备运行时,它才能回复。无论选择哪种设备,都绝不能让网关端口暴露在公共互联网上。

  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
    # stop the foreground gateway with Ctrl+C, then run it as a service:
    openclaw gateway install
  4. 连接 Telegram

    在 Telegram 中打开与 @BotFather 的聊天,仔细核对账号名称,发送 /newbot,并保存收到的令牌。使用该令牌将 Telegram 注册为频道,然后运行状态检查,确认连接正常。

    openclaw channels add --channel telegram --token <bot-token>
    openclaw channels status --probe
  5. 批准配对

    给你的机器人发一条消息。它不会直接回复,而是向陌生发送者提供配对码。查看待处理的请求,并在一小时内批准你自己的请求。

    openclaw pairing list telegram
    openclaw pairing approve telegram <CODE>
  6. 运行安全审计并保持更新

    运行 OpenClaw 自带的安全审计,检查设置并解决发现的问题,然后从稳定版更新频道获取更新。2026.4.22 之前发布的版本都存在已知的严重漏洞,因此请将这两条命令纳入日常操作。

    openclaw security audit
    openclaw update --channel stable
  7. 编写长期规则

    在代理工作区的 AGENTS.md 中用通俗语言写明规则,并在 ~/.openclaw/openclaw.json 中设置相应的硬性限制;请对照你所用版本的文档核对键名。将 dmPolicy 保持为 pairing,在你确认设置可靠之前,让 exec 每次执行前都征求批准。

第一周

把第一周当作试运行期。网关应保持在 loopback 上,通过 Tailscale 或 SSH 访问,不要暴露端口。Shell 命令继续设置为需要批准;谨慎添加第三方技能,只选择你了解的发布者;每天检查模型用量,因为陷入循环的代理会持续消耗令牌。每次更改配置后,都要重新运行安全审计。

需要避免的错误

  • 将网关暴露在互联网上,而不是让 gateway.bind 保持为 loopback。
  • 安装大量第三方技能;对待它们应像对待浏览器扩展一样保持警惕。
  • 运行过时版本;所有早于 2026.4.22 的版本都存在已知的严重漏洞。