OpenClaw 入门指南：2026年如何搭建 Telegram AI 助手

如果你希望将 AI 助手整合到 Telegram 或 Discord 中，而不必每次都打开网页，这篇文章将为你提供帮助。本文结构为「准备 → 安装 → 配置 → 排错 → 安全」，即使是新手也能轻松跟着操作。

什么是 OpenClaw？适合哪些用户？

OpenClaw 是一个本地运行的 AI 网关，具体功能如下：

  • 你的设备负责运行 Gateway（中转服务）
  • Gateway 连接聊天平台（如 Telegram、Discord、WhatsApp）
  • Gateway 再连接大型模型（如 GPT、Claude、DeepSeek 等）
  • 你在聊天软件中发送消息，Gateway 将其转发给模型并返回结果

适用用户包括：

  • 需要在聊天软件中随时调用 AI 的用户
  • 不希望频繁切换多个 AI 网页或客户端的用户
  • 渴望保留本地配置和可控工作流的高级用户

首先，了解基础知识 如果你是完全的新手，建议先阅读 什么是翻墙，然后再继续本指南。

开始前的准备（务必执行）

1）系统与运行环境

  • macOS：体验最佳，原生支持
  • Windows：建议使用 WSL2 + Ubuntu 22.04（可以参照 WSL 将 Ubuntu 换成 Debian 的思路）
  • Linux：可直接安装

如果打算全天候在线，建议使用低功耗设备（如 Mac mini）或 VPS。

2）模型 API 准备

OpenClaw 本身并不是模型，它需要你接入模型提供商。新手建议：

  • 可以先使用按量计费方案（如 OpenRouter / AI/ML API）进行快速试验
  • 在稳定使用后再考虑订阅方案
  • 不建议一开始就使用不稳定的中转服务，因为排错成本较高

3）网络环境检查（关键步骤）

Telegram/Discord 需要可用的代理环境。可以参考以下常见客户端：

终端快速验证： 返回 200 或 301/302 通常表示链路可达。

安装 OpenClaw（请按顺序执行）

步骤 1：安装 Node.js（要求 >= 22）

如果版本低于 22，请先进行升级。

步骤 2：安装 OpenClaw

推荐使用官方安装脚本： 安装后请进行验证：

步骤 3：初始化并安装守护进程

–install-daemon 表示后台常驻运行，重启后可自动恢复。

首次配置流程（最容易遇到问题的步骤）

1）选择模型提供商

  • 如果已有官方账号：按向导授权
  • 使用第三方 API：选择 Skip，稍后手动配置

2）选择聊天平台

新手建议先接入 Telegram（Bot API）：

  • 配置简单，出错几率较小
  • Bot 管理成熟，验证流程清晰

如果尚未注册 Telegram 账号，建议先查看 Telegram 注册使用教程。

3）创建 Telegram Bot

在 Telegram 中搜索 @BotFather，依次执行：

  • /start
  • /newbot
  • 设置 Bot 名称
  • 设置用户名（必须以 _bot 结尾）

随后会获得 Token（例如 123456:xxxx），请将其粘贴回 OpenClaw 向导中。

4）完成引导并确认启动

正常情况下会看到类似的输出：

配置第三方模型（以 OpenRouter 为例）

方式 A：Web UI（推荐）

访问：http://127.0.0.1:18789

路径：Settings -> Models -> Add Provider

填写参数：

  • Provider Name：openrouter
  • Base URL：https://openrouter.ai/api/v1
  • API Key：你的密钥
  • Model ID：如 anthropic/claude-opus-4

方式 B：直接修改配置文件

示例（根据你的密钥与模型进行替换）：

重启服务：

代理设置（如果 Bot 不回复消息请先检查此处）

首先确认本地代理端口（如 7890/7891），然后设置环境变量：

追加：

生效并重启：

如果你的代理本身不稳定，建议先参考 电脑如何翻墙 或 手机如何翻墙 来确保基本链路畅通。

常见问题排查（先执行这三步）

1）Bot 不回复消息

  • ECONNREFUSED / timeout：通常是网络或代理问题
  • 401 Unauthorized：API Key 错误或失效
  • rate limit：额度不足或触发限流

2）端口占用（18789）

3）Telegram 配对失败

可以通过 Telegram 的 @userinfobot 获取 User ID。

安全加固（强烈建议）

OpenClaw 功能强大，安全配置必不可少：

  • 在模型提供商后台设置每日或每月预算上限
  • 对高风险工具启用审批（如 exec、email）
  • Gateway 保持本地监听（127.0.0.1），不要改成 0.0.0.0

审批示例：

成本建议（新手版）

  • 轻度尝鲜：按量 API + 本地设备，优先确认可用性
  • 稳定使用：按月评估成本后再升级模型档位
  • 不建议：在未成功配置之前直接进行年付或重投入

先确保功能正常再进行优化，才能更省钱。

本站相关文章（建议收藏）

结语

OpenClaw 的价值在于将 AI 使用场景从「打开网页」转变为「在聊天软件内直接操作」。如果你第一次配置未成功，首先检查三件事：代理是否可用、API Key 是否有效、日志中是否有明确的错误信息。按照本文的步骤排查，基本上能定位到问题。