快速起步：30 分钟跑通你的第一个 Claw

💡 目标：30 分钟内在自己电脑上装好 OpenClaw、连上一个模型，在浏览器 Control UI 里收到你第一个 Claw 的第一句回复。这是整部 OpenClaw 教程的第一站，零基础也能跟着走完。

OpenClaw 是一个跑在自己设备上的开源 AI 助手：一个 Gateway 进程管会话、工具和渠道连接，状态、记忆、凭据全留在你的硬件上；模型是可换的插件，DeepSeek、通义千问、智谱 GLM、Kimi 等国产模型都是一等公民。OpenClaw 怎么用、从哪里入门？跟着本阶段一课一课走就行。

🎯 阶段目标

装好并跑起 OpenClaw：openclaw gateway status 显示 Gateway 正在运行（默认监听 18789 端口）
连上至少一个模型：复用已有的 Claude Code / Codex CLI 登录，或配一家模型的 API Key（DeepSeek、Qwen、GLM、Kimi、MiniMax、豆包、混元、千帆都有官方插件）
完成第一次对话：openclaw dashboard 打开 Control UI，发一条消息，收到 AI 回复
装不上时能自救：先用 openclaw triage 一键诊断，再去排错页对照报错

⏳ 预计耗时

只想尽快跑通：1.1、1.3 两课约 18 分钟（1.2 讲 2.0 新变化，可后补）。其中动手部分——安装 + onboarding + 首次对话——官方口径约 5 分钟，前提是手上已有可用的模型凭据（Claude Code / Codex CLI 登录或 API Key）
想接国产模型再跑：加 1.6 模型总览 + 一家 provider 专页（比如 1.7 DeepSeek），合计约 34 分钟——多出的约 16 分钟（1.6 + 一家专页），换来一家国产模型的完整配置；API Key 注册时间另计
完整学完本阶段（15 课，含 2.0 新变化、备用安装、排错与 9 个模型接入页）：约 132 分钟，预留浮动后约 90–170 分钟

🚀 开始之前

一台 macOS / Linux / Windows 电脑。Windows 有三条路：原生 Windows Hub 应用、PowerShell 安装器、WSL2 Gateway
Node.js 24.16.0+（24.x）或 26.1.0+，推荐 Node 26。没有也没关系：安装器缺 Node 时会在 macOS 装 Node 26、Linux 装 Node 24 LTS
一张「模型通行证」：已有的 Claude Code 或 Codex CLI 登录，或任一模型 provider 的 API Key——onboarding 能自动检测并复用
国内用户：主流国产模型都有官方 provider 插件——DeepSeek、通义千问、智谱 GLM、Kimi、MiniMax、豆包/火山引擎、混元、千帆，1.7–1.13 逐家讲配置
预算有限？1.15 本地模型教你用 Ollama、vLLM 把模型跑在自己机器上，不花 API 钱
一杯水 ☕——从敲下安装命令到收到第一句回复，比你想的快

💡 已经装过 OpenClaw？

直接跳到 1.6 连接模型总览换模型，或去日常使用学 Control UI 和聊天命令。卡在报错上，先翻装不上怎么办。

📚 本阶段课程

课程	内容	时长
1.1 OpenClaw 是什么	开源自托管 AI 助手、Gateway 架构、能做什么、免费吗、旧名 Clawdbot / Moltbot	8 分钟
1.2 OpenClaw 2.0 新变化	v2026.8.1（即 OpenClaw 2.0）更新了什么：全新 Control UI、跨会话记忆、Skills、原生 App	10 分钟
1.3 安装：5 分钟跑通	一条命令安装、onboarding 引导、Gateway 装成后台服务、Control UI 里第一次对话	10 分钟
↳ 1.4 安装备用方式	桌面应用（Windows Hub、macOS 菜单栏）、Docker、npm 直装	8 分钟
1.5 装不上怎么办	安装与启动排错：Node 版本、Gateway 起不来、更新失败	8 分钟
1.6 连接模型总览	provider 体系、`provider/model` 引用写法、`openclaw models` 命令、聊天内切换模型	8 分钟
↳ 1.7 接入 DeepSeek	V4 系列配置；`deepseek-chat` 等旧 ID 已于 2026-07-24 退役，必须换新	8 分钟
↳ 1.8 接入通义千问 Qwen	DashScope 三种套餐（Coding / Standard / Token Plan）、默认 `qwen3.5-plus`	8 分钟
↳ 1.9 接入智谱 GLM	Z.AI 双端点、Coding Plan、`glm-5.3`	8 分钟
↳ 1.10 接入 Kimi	Moonshot 与 Kimi Coding 两个插件要分清、默认 `kimi-k3`	10 分钟
↳ 1.11 接入 MiniMax	M3 系列、Coding Plan（OAuth）与 API Key 两种接法	8 分钟
↳ 1.12 接入豆包/火山引擎	方舟端点、Coding Plan 默认 `ark-code-latest`	8 分钟
↳ 1.13 接入混元与千帆	腾讯 TokenHub（`hy4-preview`）、百度千帆（`ernie-5.1`）	10 分钟
↳ 1.14 更多国产与中转	没有官方插件的模型（星火、百川等）、OpenRouter / LiteLLM、自定义中转端点	10 分钟
↳ 1.15 本地模型	Ollama、vLLM、ds4：模型跑在自己机器上	10 分钟

🎒 你将收获

一个装好、能后台运行的 OpenClaw Gateway，和一只能对话的 Claw——后面所有阶段都在它上面展开
「Gateway 是信任边界，模型与 agent harness 都是可换插件」的架构直觉，看配置文件不再发懵
至少一家模型的接入配置：环境变量、端点、provider/model 引用一次写对
跑通之后的路线图：去日常使用学记忆系统和聊天命令，去场景实战把 Claw 挂进企业微信、飞书

快速起步：30 分钟跑通你的第一个 Claw ​

🎯 阶段目标 ​

⏳ 预计耗时 ​

🚀 开始之前 ​

📚 本阶段课程 ​

🎒 你将收获 ​