🎯 做完你会得到
安装完成并在 Telegram 里收到 AI 回复
👤 适合谁
- OpenClaw新手
- 刚接触AI助手的用户
⚡ 效果预览
10分钟安装配置OpenClaw,发第一条消息,立刻感受AI助手的能力
🔧 Step 0:先配置消息接收渠道
⚠️ 本案例需要发送通知到你的手机,先配置消息渠道 👉 去配置 Telegram/飞书/微信接入 →
这个场景解决什么问题
第一次接触 OpenClaw 不知道从哪里开始?这篇把核心流程浓缩成 3 步,5 分钟内让你在 Telegram 收到 AI 回复。
前置条件
- Node.js 22+(运行
node -v确认) - 一个 Telegram 账号(用来接收 AI 回复)
如果 Node 版本不够:
# Linux/macOS 推荐用 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22 && nvm use 22
直接复制这段:完整安装流程
第一步:安装 OpenClaw
# macOS / Linux(推荐)
curl -fsSL https://openclaw.ai/install.sh | bash
# 或用 npm 全局安装
npm install -g openclaw@latest
Windows 用户:先安装 WSL2,然后在 WSL 内运行上面的 Linux 命令。
第二步:运行引导向导
openclaw onboard --install-daemon
向导会引导你:
- 选择 AI 模型(推荐 Anthropic Claude,国内可选千问/硅基流动)
- 填写 API Key
- 配置渠道(选 Telegram)
- 安装系统服务(开机自启)
第三步:配置 Telegram Bot
-
在 Telegram 找 @BotFather,发送
/newbot,按提示创建 Bot,获取 Token -
在
~/.openclaw/openclaw.json里加入:
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "123456789:AAxxxxx",
"dmPolicy": "pairing",
"groups": { "*": { "requireMention": true } }
}
}
}
- 重启 Gateway:
openclaw gateway restart
- 给你的 Bot 发一条消息,拿到配对码,然后批准:
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
验证是否成功
openclaw gateway status # 确认运行中
openclaw health # 检查整体状态
openclaw status --all # 完整诊断报告
变体:接入飞书(企业用户)
# 向导里选择 Feishu 渠道,或者安装插件:
openclaw plugins install @openclaw/feishu
# 然后配置(App ID 和 App Secret 从飞书开放平台获取):
openclaw channels add
# 选择 Feishu,输入 App ID 和 App Secret
变体:不用 Telegram,先用浏览器聊
openclaw dashboard
# 打开 http://127.0.0.1:18789/ 直接在浏览器聊天
管理命令
# 查看 Gateway 状态
openclaw gateway status
# 重启服务
openclaw gateway restart
# 查看日志
openclaw logs --follow
# 更新 OpenClaw
npm install -g openclaw@latest
注意事项
- Node.js 必须 22+,低版本会报错,
node -v确认 - Telegram 不用
openclaw channels login,直接配置 token 重启即可 - 第一次 Telegram 私聊会有配对码,必须
openclaw pairing approve才能正常响应 - 国内用户推荐千问(
qwen-plus)或硅基流动,不需要梯子 - 群聊里默认需要 @bot 才触发,单聊直接发消息即可
#安装#入门#Telegram#Gateway
⚔️ 同类副本推荐 ⚔️