手把手教你用 OpenClaw 打造 Telegram AI 助手，新手必看（2026实战指南）

想在 Telegram 里直接跟 AI 对话，而不是每次都打开网页？今天这篇教程，手把手教你在 30 分钟内把 OpenClaw 接入 Telegram，打造一个属于你自己的 AI 助手。

一、OpenClaw 是什么？

简单来说，OpenClaw 就是一个本地 AI 网关。它的运作逻辑是这样的：

你的设备运行一个 Gateway 服务
Gateway 连接 Telegram/Discord/WhatsApp 等聊天平台
Gateway 再对接 GPT、Claude、DeepSeek 等大模型
你在 Telegram 发消息，Gateway 自动转发给 AI 并把结果返回给你

这个方案特别适合：不想每次都开网页、希望在聊天软件里随时调用 AI、想要本地可控配置的进阶用户。

二、安装前的准备工作

1. 系统环境要求

macOS：体验最佳，原生支持
Windows：推荐 WSL2 + Ubuntu 22.04
Linux：直接安装即可

如果需要 24 小时在线运行，可以考虑低功耗设备如 Mac mini 或者 VPS。

2. 申请一个大模型 API

OpenClaw 本身不提供 AI 模型能力，需要你自己接入。新手建议先用按量计费的方案（比如 OpenRouter、AI/ML API）试水，等流程跑通后再考虑订阅方案。

3. 确保网络通畅（关键步骤）

Telegram 在国内需要代理才能使用。先在终端验证一下：

curl -I https://api.telegram.org

如果返回 200 或 301/302，说明代理链路没问题。

三、安装 OpenClaw（三个步骤）

第一步：检查 Node.js 版本

node --version
npm --version

要求版本 >= 22，如果版本过低请先升级。

第二步：运行官方安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后验证：

openclaw --version

第三步：初始化并启动守护进程

openclaw onboard --install-daemon

加 --install-daemon 参数可以让服务在后台常驻，关机重启后自动恢复。

四、Telegram Bot 对接（最详细的部分）

1. 在 Telegram 创建 Bot

打开 Telegram，搜索 @BotFather，依次发送：

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

创建成功后你会拿到一个 Token，格式类似：123456:xxxx，把这个 Token 粘贴到 OpenClaw 向导里。

2. 完成引导配置

正常启动后会看到这样的输出：

Gateway started on http://127.0.0.1:18789
Telegram channel connected
Ready to chat

五、接入第三方模型（以 OpenRouter 为例）

方法一：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

方法二：手动编辑配置文件

nano ~/.openclaw/openclaw.json

填入你的 API Key 和模型信息后，保存并执行：

openclaw restart

六、Bot 不回消息？先检查这几项

代理配置

如果 Bot 没有响应，大概率是代理没配对。在 ~/.zshrc 或 ~/.bashrc 里追加：

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7891

然后 source ~/.zshrc 生效，重启 OpenClaw。

排查命令

openclaw status
openclaw logs --tail 50
openclaw agent --message "测试" --thinking high

常见错误

ECONNREFUSED / timeout：网络或代理问题
401 Unauthorized：API Key 错误或已失效
rate limit：触发了限流，检查额度

七、安全建议（别省这一步）

OpenClaw 功能强大，安全配置不能忽略：

在 API 后台设置每日/每月消费上限
高风险操作（如执行命令、发送邮件）建议开启审批机制
Gateway 建议保持本地监听 127.0.0.1，不要改成公网可访问

总结

OpenClaw 的核心价值是把 AI 从「打开网页」变成「在聊天软件里直接使用」。第一次配置如果卡住了，优先检查三件事：代理是否正常、API Key 是否有效、日志里有没有明确报错。按这个思路排查，基本都能解决。

祝你部署顺利！