第 1 步
执行安装命令
打开终端，运行一键安装脚本，自动安装 OpenClaw
🍎 macOS / Linux / WSL2
bash
# 国内加速版（推荐）
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 官方原版
curl -fsSL https://openclaw.ai/install.sh | bash
🪟 Windows（PowerShell 管理员）
PowerShell
# 国内加速版（推荐）
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
💡 脚本会自动检测系统、安装 Node.js、部署 OpenClaw 并启动配置向导
第 2 步
启动初始化向导
安装完成后，向导会自动启动。如果没有，手动执行以下命令
bash
✅ 安装完成！
⏳ 正在启动初始化向导（Onboarding Wizard）...
如果没有自动启动，请手动运行：
openclaw onboard --install-daemon
🔍 验证安装成功
openclaw --version → 显示 v2026.6.1 则为安装成功
💡 --install-daemon 会在安装网关的同时将其设为后台服务，开机自启
第 3 步
安全提示确认
向导第一步 → 确认了解风险，选 Yes 继续
bash
$ openclaw onboard --install-daemon
⏳ 正在检查环境...
⚠️ OpenClaw 将获得本地文件、网络、
聊天工具访问权限。请确认已了解风险。
Continue?
● Yes
○ No
👉 选择 Yes，按回车继续
💡 个人电脑选 Yes 即可。首次安装自动跳过已有配置检测。
第 4 步
选择引导模式
新手选 QuickStart，自动配置默认值，最快上线
bash
◆ Onboarding mode
Choose how to set up your bot.
● QuickStart Configure details later via configure.
○ Advanced
👉 保持默认 QuickStart，按回车
自动配置：本地网关 · 端口 18789 · Token 认证 · 工作区
💡 后面可以用 openclaw configure 随时调整细节
第 5 步
选择模型提供商
选择你已准备好 API Key 的 AI 大模型（DeepSeek 推荐）
bash
◆ Model/auth provider
● DeepSeek 推荐：免费额度高，国内直连
○ Moonshot (Kimi K2)
○ Qwen（通义千问）
○ MiniMax
○ OpenAI
○ Ollama（本地模型）
○ Custom Provider
👉 用 ↑↓ 键选择 · 回车确认
💡 国内用户推荐 DeepSeek（免费送 500 万额度）或 Moonshot (Kimi)
第 6 步
输入 API Key
粘贴你从模型官网申请的 API Key（看不到明文是正常的）
bash
◆ How do you want to provide this API key?
● Paste API key now
○ Use external secret provider
DEEPSEEK_API_KEY: ●●●●●●●●●●●●●●●●
👉 选 Paste API key now → 粘贴 Key → 回车
看不到明文是安全行为，直接 Ctrl+V / 右键粘贴即可
💡 DeepSeek 官网 → 开放平台 → API Keys → 创建 Key → 复制保存
第 7 步
选择默认模型
选择你要使用的 AI 模型（DeepSeek V4 Flash 为默认）
bash
◆ Model ID
Select the default model for conversations.
● deepseek/deepseek-v4-flash 推荐 · 100万上下文
○ deepseek/deepseek-v4-pro
○ deepseek/deepseek-chat
○ deepseek/deepseek-reasoner
○ Other...
👉 选择 deepseek-v4-flash（默认推荐），回车确认
💡 V4 Flash 适合日常对话 · V4 Pro 更强但更贵 · 以后随时可更换
第 8 步
跳过可选配置
全部选 Skip / No，先让 OpenClaw 跑起来，以后随时补
◆ Select channel
Skip for now
通讯渠道（Telegram / Discord / QQ / 飞书 等）
◆ Search provider
Skip for now
◆ Configure skills?
No
◆ Enable hooks?
Skip for now
✅ 统一原则：看到 Skip / No 就选它
这些选项以后随时可用 openclaw configure 重新配置
💡 按 ↑↓ 切换选项，空格选中，回车确认。
第 9 步
安装网关服务
设为后台服务，开机自启，不用每次都手动启动
bash
◆ Gateway service action
OpenClaw Gateway runs as a background service.
● Install as system service （开机自启 ✓）
○ Run in foreground only
✅ 选择「Install as system service」
- 网关在后台自动运行，关闭终端不影响
- 电脑重启后网关自动启动
💡 Windows：计划任务 | macOS：LaunchAgent | Linux：systemd 用户单元
第 10 步
选择启动方式
选 Open the Web UI，浏览器直接使用，不需要记命令
bash
◆ How do you want to hatch your bot?
Choose how to interact with your agent.
○ Hatch in TUI (recommended)
● Open the Web UI （推荐教学用）
○ Do this later
👉 选择「Open the Web UI」
浏览器自动打开 Web 界面，图形化使用，无需记命令
💡 TUI 是终端界面适合开发者，Web UI 适合日常和教学
完成！
🎉 安装完成！
恭喜你成功安装了 OpenClaw！
bash
🎉 Onboarding complete.
Gateway started on http://127.0.0.1:18789
Dashboard URL: http://127.0.0.1:18789/#token=xxxxxxxxx
✅ 验证安装成功
浏览器自动打开 → 聊天框输入「你好」→ 收到 AI 回复 → 大功告成！
📖 常用命令速查
| openclaw dashboard | 手动打开 Web UI |
| openclaw gateway status | 查看网关运行状态 |
| openclaw gateway restart | 重启网关服务 |
| openclaw configure | 修改已有配置 |
| openclaw onboard | 重新运行配置向导 |