FastOpenClaw 安装手册：从脚本安装到稳定运行
OpenClaw 官方网站：http://openclaw.ai/
FastOpenClaw GitHub：https://github.com/upgiorgio/FastOpenClaw
这篇给第一次部署的同学，目标是 20~30 分钟内完成：
- OpenClaw 安装成功
- Telegram 机器人可回复
- 基础健康检查通过
0) 开始前准备（必须）
你需要准备
- 一台可联网电脑（macOS / Linux / Windows）
- Telegram 账号（用于创建 Bot）
- 至少一个模型 API Key（
sk-...）
先做环境检查
node --version
npm --version
curl --version
建议满足：
- Node.js
>= 22 - npm 正常可用
curl可正常联网
1) 一键安装 FastOpenClaw
在终端执行：
curl -fsSL https://raw.githubusercontent.com/upgiorgio/FastOpenClaw/main/install.sh | bash
如果安装过程无报错，继续下一步。
如果提示权限问题，可先执行：
chmod +x ~/.local/bin/* 2>/dev/null || true
2) 初始化并安装后台守护进程
openclaw onboard --install-daemon
openclaw status
openclaw health
验收标准：
openclaw status显示Gateway: runningopenclaw health不出现阻塞级错误
3) 详细创建 Telegram Bot（小白点击版）
- 打开 Telegram，搜索
BotFather - 进入
@BotFather官方账号并点击Start - 发送
/newbot - 按提示输入：
- 机器人显示名称（可中文）
- 机器人用户名（英文，必须以
bot结尾）
- 复制返回的
Bot Token
Token 示例：
1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxx
4) 获取你的 Telegram 用户 ID（白名单）
- 在 Telegram 搜索
userinfobot - 打开
@userinfobot并点击Start - 记录返回信息中的
id（数字）
这个 ID 后续会写入 allowlist，防止陌生人调用你的机器人。
5) 回到 OpenClaw 填写配置
重新执行引导：
openclaw onboard
按提示填入：
- 模型平台与 API Key
- 通道选择
telegram - Bot Token
- allowlist 用户 ID
配置完成后重启：
openclaw gateway restart
openclaw status
6) 首次验收（必须做）
在 Telegram 找到你的机器人，发送：
请回复：FastOpenClaw 已连接成功。
验收通过条件：
- 10~20 秒内收到回复
- 连续发送 3 条消息都能正常返回
openclaw health仍然正常
7) 常见失败与修复
问题 A：命令找不到
npm i -g openclaw@latest
openclaw --version
问题 B：API 401
- API Key 失效或粘贴错误
- 使用了云账号 AccessKey，而不是模型 API Key
- 当前账号无该模型权限
问题 C：机器人不回复
- Bot Token 粘贴错误
- allowlist 没有你的用户 ID
- 网关未重启
固定排查命令：
openclaw status
openclaw health
openclaw gateway restart
8) 升级与回滚动作
升级
npm i -g openclaw@latest
openclaw gateway restart
openclaw status
回滚（最小动作）
- 切回上一个稳定配置文件
- 重启网关
- 重新做 3 条消息验收