文档
OpenClaw 新手安装引导地图
给零基础用户的分步导航：安装、配置、接入 Telegram、常见报错修复，一页走通
继续查看
安装、排障和深入阅读最常用的入口都在这里。
不知道从哪里开始，或者不知道下一步该做什么，就从这页开始。
这是一张给新手的“任务导航图”：
- 想快速安装，就走安装轨道
- 想配置模型 API，就走配置轨道
- 想接 Telegram 机器人，就走通道轨道
- 遇到报错，就走排错轨道
每条轨道都配了可直接复制的命令和验收标准，按顺序做就能完成。
按你的当前目标，直接点击对应入口：
安装轨道
按系统生成最短安装路径，10 分钟可跑通。
配置轨道
模型平台、鉴权方式、配置模板一次讲清。
通道轨道
Telegram / 飞书 / Discord / QQ 分通道落地。
技能轨道
按业务目标装技能，不盲目“全装”。
排错轨道
401、插件失效、pairing、搜索失效快速修复。
0) 开始前统一检查
node --version
npm --version
openclaw --version
建议：Node.js >= 22。
1) 安装轨道（Install Track）
Step 1: 选系统
macOS / Linux / Windows / Docker，先选一个主路径，不要混用。
1.1 一键脚本（推荐）
curl -fsSL https://raw.githubusercontent.com/upgiorgio/FastOpenClaw/main/install.sh | bash
1.2 完成初始化
openclaw onboard --install-daemon
openclaw status
openclaw health
验收标准：Gateway: running。
Step 2: 首次成功标准
- 命令可执行（无 command not found）
- health 无阻塞错误
- 可进入下一轨道（配置/通道）
2) 配置轨道（Configure Track）
Step 1: 选模型平台
先稳定可达，再谈最强模型。建议主模型 + 备用模型。
2.1 环境变量模板（新手最稳）
OPENCLAW_PROVIDER=openrouter
OPENCLAW_API_KEY=sk-xxxx
OPENCLAW_MODEL=anthropic/claude-3.5-sonnet
OPENCLAW_ENABLE_FALLBACK=true
OPENCLAW_FALLBACK_MODEL=deepseek-chat
2.2 改完后固定动作
openclaw gateway restart
openclaw status
openclaw health
关联阅读：/docs/model-api-lines/ · /docs/env-vars/
3) 通道轨道（Channel Track）
Step 1: 只先接 1 个通道
推荐顺序：Telegram -> 飞书 -> Discord -> QQ。先单通道成功，再扩展。
3.1 Telegram（小白版）
- Telegram 搜索
@BotFather - 发送
/newbot - 复制 Bot Token
- 搜索
@userinfobot获取用户 ID - 运行
openclaw onboard填 token 与 allowlist
3.2 通道通用验收
openclaw status
openclaw logs --tail 150
连续发送 3 条消息，均有回复才算通过。
关联阅读：/docs/channels-and-bots/ · /faq/bot-connectivity/
4) 技能轨道（Skill Track）
Step 1: 按任务装技能，不按“好奇心”装技能
先从“新手稳妥包”开始，24 小时观察错误率。
推荐顺序：
- 新手稳妥包
- 联调排障包
- 内容创作包
关联阅读：/docs/skills-recommended/
5) 排错轨道（Troubleshoot Track）
先判层级，再改配置
层级顺序：Gateway -> Channel -> Model/API -> Search/Deploy。
5.1 最小诊断命令集
openclaw status
openclaw health
openclaw gateway restart
npm run build:search
5.2 高频问题入口
- 401/token 问题：/faq/token-errors/
- 机器人不回复：/faq/bot-connectivity/
- 30+ 小白问答：/faq/quick-answers/
- 社区证据与趋势：/faq/community-trend-radar-2026w10/
6) 一次完整引导（可复制执行）
# 1) 安装
curl -fsSL https://raw.githubusercontent.com/upgiorgio/FastOpenClaw/main/install.sh | bash
# 2) 初始化
openclaw onboard --install-daemon
# 3) 健康检查
openclaw status
openclaw health
# 4) 改配置后重启
openclaw gateway restart
7) 中英文双语入口
- 中文（本页）：
/docs/setup-wizard/ - English: /en/docs/setup-wizard/