官方网站:http://openclaw.ai/ · 本站基于官网提供更快更易部署的中文教程与 GitHub 快装方案

Star FastOpenClaw
FastOpenClaw 快速一键安装OpenClaw官方教程百科

3 分钟快速开始(小白详细版)

2026-03-03

官方网站:http://openclaw.ai/
GitHub 快速安装仓库:https://github.com/upgiorgio/FastOpenClaw

这篇是给新手的“照着点就能完成”版本。
如果你之前没用过 Telegram、没配过 API,也没关系,按下面顺序做就行。

0) 开始前准备(2 分钟)

请先准备好 3 样东西:

  1. 一台电脑(macOS / Linux / Windows)用于安装 OpenClaw。
  2. 一部手机或桌面端 Telegram(用于创建机器人)。
  3. 一个模型 API Key(如果还没有,先看 模型 API 官网导航)。

再确认电脑里能用这两个命令:

node --version
npm --version

建议 Node.js >= 22

1) 在电脑上一行安装 FastOpenClaw

curl -fsSL https://raw.githubusercontent.com/upgiorgio/FastOpenClaw/main/install.sh | bash

看到安装完成后,继续下一步。

2) 启动 OpenClaw 并确认服务正常

openclaw onboard --install-daemon
openclaw status
openclaw health

目标状态:

  • openclaw status 里有 Gateway: running
  • openclaw health 没有阻塞错误

如果这里失败,不要继续配 Telegram,先把服务状态修到 running

3) 手把手创建 Telegram 机器人(BotFather)

下面是最关键的“点击步骤”,请按顺序做。

3.1 打开 Telegram 并找到 BotFather

  1. 打开 Telegram App(手机或桌面都可以)。
  2. 在顶部搜索框输入:BotFather
  3. 点击用户名是 @BotFather 的官方账号(有蓝标)。
  4. 点进聊天窗口后,先点 Start(开始)。

3.2 用 /newbot 创建你的机器人

在输入框发送:

/newbot

然后 BotFather 会依次让你输入:

  1. 机器人显示名称(可中文,比如:我的OpenClaw助手
  2. 机器人用户名(必须英文,且以 bot 结尾,例如:myopenclaw_helper_bot

3.3 复制 Bot Token(非常重要)

创建成功后,BotFather 会返回一段类似下面的字符串:

1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxx

这就是 Bot Token,请完整复制,不要漏字符,不要多空格。

4) 获取你自己的 Telegram 用户 ID(用于白名单)

为了让机器人只对你开放,建议先拿到你的 Telegram 用户 ID。

操作步骤:

  1. 在 Telegram 搜索框输入:userinfobot
  2. 打开 @userinfobot(或同类 ID 查询 bot)
  3. Start
  4. 它会回复你的用户信息,其中有 id(一串数字)

把这串数字记下来,后面要填。

5) 回到 OpenClaw,填入 Telegram 配置

最简单方式:重新运行引导命令(新手推荐)

openclaw onboard

在引导里按提示填写:

  1. 模型平台和 API Key
  2. 选择通道:telegram
  3. 粘贴刚才的 Bot Token
  4. 填你的 Telegram 用户 ID(allowlist)

填完后,执行:

openclaw gateway restart
openclaw status

6) 发送第一条消息做验证

在 Telegram 里搜索你刚创建的机器人用户名,打开聊天窗口,点 Start,发送:

请做自我介绍,并告诉我你可以帮我完成哪些部署任务。

如果 10~20 秒内有回复,说明你已经跑通了第一条链路。

7) 新手最常见 4 个问题(先看这里)

1) 没有回复

  • 先看 openclaw status 是否 running
  • 检查 Bot Token 是否粘贴错误
  • 检查你自己的用户 ID 是否在 allowlist

2) 报 401

3) 命令找不到

重开终端后再试,如果还不行:

npm i -g openclaw@latest
openclaw --version

4) 改完配置还是不生效

每次改配置都要重启:

openclaw gateway restart

8) 下一步建议(按这个顺序)

  1. GitHub 快速安装全路径
  2. 各大模型 API 官网与申请地址
  3. 模型 API 双线路配置
  4. 机器人通道配置(飞书/Telegram/Discord/QQ)
  5. 生产环境上线清单