跳到正文
🟠 需外部服务 — 需自备相关账号/权限 入门 入门上手

OpenClaw 5分钟快速上手

从零安装 OpenClaw,连接 Telegram,5分钟内收到第一条 AI 回复

⚔️ 难度 ★☆☆ 入门
⏱ 配置耗时 5 分钟
🎁 掉落 节省 5 分钟
🦞 部署 可一键部署

🎯 做完你会得到

安装完成并在 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

向导会引导你:

  1. 选择 AI 模型(推荐 Anthropic Claude,国内可选千问/硅基流动)
  2. 填写 API Key
  3. 配置渠道(选 Telegram)
  4. 安装系统服务(开机自启)

第三步:配置 Telegram Bot

  1. 在 Telegram 找 @BotFather,发送 /newbot,按提示创建 Bot,获取 Token

  2. ~/.openclaw/openclaw.json 里加入:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:AAxxxxx",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}
  1. 重启 Gateway:
openclaw gateway restart
  1. 给你的 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