3 分钟快速开始(小白详细版)
官方网站:http://openclaw.ai/
GitHub 快速安装仓库:https://github.com/upgiorgio/FastOpenClaw
这篇是给新手的“照着点就能完成”版本。
如果你之前没用过 Telegram、没配过 API,也没关系,按下面顺序做就行。
0) 开始前准备(2 分钟)
请先准备好 3 样东西:
- 一台电脑(macOS / Linux / Windows)用于安装 OpenClaw。
- 一部手机或桌面端 Telegram(用于创建机器人)。
- 一个模型 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: runningopenclaw health没有阻塞错误
如果这里失败,不要继续配 Telegram,先把服务状态修到 running。
3) 手把手创建 Telegram 机器人(BotFather)
下面是最关键的“点击步骤”,请按顺序做。
3.1 打开 Telegram 并找到 BotFather
- 打开 Telegram App(手机或桌面都可以)。
- 在顶部搜索框输入:
BotFather - 点击用户名是
@BotFather的官方账号(有蓝标)。 - 点进聊天窗口后,先点
Start(开始)。
3.2 用 /newbot 创建你的机器人
在输入框发送:
/newbot
然后 BotFather 会依次让你输入:
机器人显示名称(可中文,比如:我的OpenClaw助手)机器人用户名(必须英文,且以bot结尾,例如:myopenclaw_helper_bot)
3.3 复制 Bot Token(非常重要)
创建成功后,BotFather 会返回一段类似下面的字符串:
1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxx
这就是 Bot Token,请完整复制,不要漏字符,不要多空格。
4) 获取你自己的 Telegram 用户 ID(用于白名单)
为了让机器人只对你开放,建议先拿到你的 Telegram 用户 ID。
操作步骤:
- 在 Telegram 搜索框输入:
userinfobot - 打开
@userinfobot(或同类 ID 查询 bot) - 点
Start - 它会回复你的用户信息,其中有
id(一串数字)
把这串数字记下来,后面要填。
5) 回到 OpenClaw,填入 Telegram 配置
最简单方式:重新运行引导命令(新手推荐)
openclaw onboard
在引导里按提示填写:
- 模型平台和 API Key
- 选择通道:
telegram - 粘贴刚才的
Bot Token - 填你的 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
- 多半是 API Key 错误、过期,或用错了密钥类型
- 先看 Token 与权限错误排查
3) 命令找不到
重开终端后再试,如果还不行:
npm i -g openclaw@latest
openclaw --version
4) 改完配置还是不生效
每次改配置都要重启:
openclaw gateway restart