一、安装前准备（你要准备什么）
-
一台 Windows 10 或 11 电脑，能上网。
-
若要用 DeepSeek：提前在 DeepSeek 开放平台 注册并充值，在「API 密钥」里创建一个 Key（形如
sk-xxxxxxxx），复制保存好。 -
若要用 飞书：提前在 飞书开放平台 创建自建应用，在「凭证与基础信息」里拿到 App ID 和 App Secret（可选，仅需飞书时再配）。
二、第一步：安装 Node.js（必须先做）
- 打开浏览器，访问：nodejs.org/
- 首页会看到两个大按钮，选 LTS （推荐） 那个，点进去下载 Windows 安装包（.msi）。
- 双击下载好的安装包，一路「下一步」，默认选项即可，最后点「完成」。
- 关掉所有已经打开的 CMD 或 PowerShell 窗口，再新开一个：
- 按
Win + R，输入cmd，回车；或 - 在开始菜单搜「PowerShell」或「命令提示符」，打开。
-
在黑色窗口里输入下面这一行（可复制粘贴），回车：
node -v
-
若出现类似 v22.x.x 或 v24.x.x 的版本号，说明 Node 装好了。若提示「不是内部或外部命令」，说明没装好或没重启终端，请重新安装 Node 并再关掉重开终端试一次。
三、第二步：使用淘宝镜像（让下载更快）
-
保持在上一步打开的 CMD 或 PowerShell 窗口里。
-
输入下面这一行，回车：
npm config set registry https://registry.npmmirror.com
-
一般不会有什么提示，直接出现下一行输入光标就表示成功了。这样后面用 npm 安装时会从国内镜像下载，速度更快。
四、第三步：安装 OpenClaw
-
还是在同一个 CMD 或 PowerShell 窗口里。
-
输入下面这一行，回车（可能需要几分钟，等它跑完）：
npm install -g openclaw@latest
-
过程中可能会出现很多行英文，只要最后没有红色的
ERROR或failed，就说明安装在进行。出现added xxx packages或回到输入光标，即表示安装完成。
五、第四步：验证 OpenClaw 是否安装成功
-
在同一个窗口里输入：
openclaw --version
- 若出现类似 2026.3.2 这样的版本号，说明 OpenClaw 已经安装成功。若提示「不是内部或外部命令」或找不到 openclaw，请检查：
-
Node 是否安装成功（再试一次
node -v）； -
是否用同一个 CMD/PowerShell 窗口（新开的窗口里再试一次
openclaw --version）。
六、第五步：用向导完成配置（推荐小白用这种方式）
- 在 CMD 或 PowerShell 里输入：
openclaw onboard，回车。 - 若提示「无法加载文件…禁止运行脚本」：
-
办法 A：改用 命令提示符 （ CMD ） 再执行一次
openclaw onboard；或 -
办法 B：以管理员身份打开 PowerShell，执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，关掉窗口再重新打开，再执行openclaw onboard。
七、设置向导完整步骤（按界面顺序操作）
下面按向导一屏一屏说明该怎么选，小白照着做即可。
1. 个人使用确认
-
界面问是否确认「个人使用、多人需额外锁定」之类，选 Yes，回车。
2. 向导模式
-
QuickStart：先用默认配置快速跑通，细节以后用
openclaw configure再改（推荐选这个）。 -
Manual：每一步都自己选，适合已经熟悉的人。
-
建议选 QuickStart，回车。
3. 模型 / 认证提供商（Model auth provider）
-
列表里可能没有单独的「DeepSeek」项，用方向键 ↓ 一直翻到最下面。
-
选 Custom Provider（自定义），回车。
-
接下来会依次让你填：
- API Base URL：删掉默认的
http://127.0.0.1:11434/v1，改成**https://api.deepseek.com**，回车。 - API Key：粘贴你的 DeepSeek Key（
sk-xxxxxxxx），回车。 - Endpoint compatibility（接口 兼容性 ） ：选 OpenAI-compatible (Uses /chat/completions) ，回车。
- Model ID：填
**deepseek-chat**（或deepseek-reasoner若你用 R1），回车。 - Endpoint ID：随便起个名字即可，例如
**custom-deepseek**，回车。 - Model alias (optional) ：可留空直接回车跳过，或填
**deepseek** 再回车。
- API Base URL：删掉默认的
-
出现 Verification successful 表示模型配置成功。
4. 选择聊天渠道（Select channel ）
-
Telegram：用 Telegram 和机器人聊天，需有 Bot Token。
-
Feishu /Lark（ 飞书 ） ：用飞书和机器人聊天，需提前在飞书开放平台创建应用并拿到 App ID、App Secret。
-
Skip for now：先不接任何渠道，只在本地或控制台用。
-
选你需要的（例如飞书或 Skip），回车。若选飞书，后面会要：
-
App Secret 提供方式：选 Enter App Secret（把密钥写在配置里），回车，然后按提示填 App ID 和 App Secret。
-
Group chat policy（群聊策略） ：选 Open（在所有群被 @ 就回复，方便先体验），回车。
-
5. 安装技能依赖（ Install missing skill dependencies）
-
第一项是 Skip for now。
-
注意：这里要用 空格（Space） 先勾选「Skip for now」，再按 回车（Enter） 提交；只按回车不会生效。
-
若界面要求「Please select at least one option」，就按 空格 勾选 Skip for now，再 回车。
6. 各种技能 / API Key 询问
-
接下来可能会依次问：是否设置 GOOGLE_PLACES_API_KEY（goplaces）、NOTION_API_KEY（notion）、OPENAI_API_KEY（openai-image-gen、openai-whisper-api）、ELEVENLABS_API_KEY（sag）等。
-
先体验对话、不打算用这些功能时，一律选 No，回车即可。
7. 启用 Hooks
-
选项有：Skip for now、boot-md、bootstrap-extra-files、command-logger、session-memory 等。
-
先体验选 Skip for now 即可；若做开发、希望机器人记住上下文，可勾选 session-memory（用空格勾选再回车）。
8. 向导结束与浏览器
-
最后会提示 Onboarding complete，并可能自动打开 http://127.0.0.1:18789（带一长串 token）。
-
若浏览器显示 「无法访问此网站」：说明本机还没启动 OpenClaw 网关。需要：
- 新开一个 CMD 或 PowerShell 窗口；
- 输入
**openclaw gateway**，回车，保持这个窗口不要关； - 再在浏览器里打开或刷新：http://127.0.0.1:18789（若之前给过带 token 的完整地址，用那个也可以）。
-
页面能打开后，就可以在控制台里查看会话、渠道状态；若接了飞书，在飞书里 @ 机器人即可对话。
八、常用命令速查（装好后用得着）
| 你想做的事 | 输入的命令 |
|---|---|
| 查看 OpenClaw 版本 | openclaw --version |
| 重新走一遍配置向导 | openclaw onboard |
| 检查配置和环境 | openclaw doctor |
| 启动网关（开控制台） | openclaw gateway |
| 打开控制台页面 | openclaw dashboard |
九、遇到问题时
-
openclaw命令找不到：确认已用「第四步」验证通过；若新开的窗口才装好 Node/OpenClaw，请在新窗口里再试。 -
向导里没有 DeepSeek 选项：选 Custom Provider，按「六」里写的填 Base URL 和 Key 即可。
-
页面 127.0.0.1:18789 打不开：先在一个终端里执行
openclaw gateway并保持不关，再访问。 -
DeepSeek 报错：检查 Key 是否填对、是否在 DeepSeek 控制台开启且有余量。
