手把手教你搞定 OpenClaw首次安装后的初始化-夜雨聆风

手把手教你搞定 OpenClaw首次安装后的初始化

点击“蓝字“设为星标，常备干货不走丢。

我们致力于探索、分享和推荐最新的实用技术栈、开源项目、框架和实用工具。每天都有新鲜的开源资讯等待你的发现！

本号寄语：希望我分享的内容能够帮助到正在阅读的朋友们。技术之路，与君共勉。

本篇是 OpenClaw 安装系列第二章第一篇。上一篇完成了 OpenClaw 的安装，本篇重点讲「装完之后的第一步」要怎么做，即是 Onboarding 向导的完整初始化流程，将会详细介绍每一个选项，让你清楚每一步是做什么的。

阅读目录

什么是 Onboarding？为什么这一步很重要？
触发 Onboarding 的命令
逐步拆解：Onboarding 向导完整流程

3.1 选择配置模式（Quickstart vs Custom）
3.2 选择 AI 大模型
3.3 配置 API Key
3.4 配置 Channel（聊天渠道）
3.5 配置 Skill
3.6 配置 Hooks
3.7 安装 Gateway Service

初始化完成后的验证步骤
常见报错 & 解决方案
总结

1. 什么是 Onboarding？为什么这一步很重要？

OpenClaw 安装好以后，它只是一个”空壳”，若没有配置 AI 模型、配置渠道等，它是什么都干不了。

Onboarding 向导就是帮你完成这个「从空壳到能用」的初始化过程，主要完成 4 件事：

配置项	作用
AI 大模型	告诉 OpenClaw 用哪个大脑思考
API Key	让 OpenClaw 有权限调用这个大脑
Channel	告诉 OpenClaw 从哪里接收你的消息
Gateway Service	让 OpenClaw 在后台常驻运行

⚠️ 重要：如果这步跳过了或者配置出错，你会发现 OpenClaw 装了也用不了、或者发消息没反应，90% 的新手问题都出在这里。

2. 触发 Onboarding 的命令

安装完成后，打开 PowerShell（必须以管理员身份运行），执行：

openclaw onboard --install-daemon

📌 为什么要加 --install-daemon？这个参数会让 OpenClaw 同时安装 Gateway Service（后台守护进程），实现「开机自启动、后台常驻」。不加这个参数，OpenClaw 窗口一关就停了。

如果不是第一次配置，想重新走一遍向导：

openclaw onboard

这个命令随时可以重新执行，不会清空已有配置，只会更新你修改的部分。

3. 逐步拆解：Onboarding 向导完整流程

执行命令后，控制台会进入交互式向导。下面逐步拆解每一个环节。

3.1 选择配置模式（Quickstart vs Custom）

 How would you like to configure OpenClaw?  > Quickstart（推荐新手）    Custom（高级配置）

建议选 Quickstart，它会帮你预填一些默认值，让整个过程更快。

Quickstart：适合第一次配置，快速上手，后续可以随时修改
Custom：适合有特定需求的用户（比如想用多个模型、自定义端口）

3.2 选择 AI 大模型

 Which AI provider would you like to use?  > MiniMax（国内免费额度，推荐新手）    Anthropic (Claude)    OpenAI (GPT-4)    Google Gemini    Ollama（本地免费）    ...more

如何选择？

大模型	适合人群	费用	网络要求
MiniMax	国内新手，测试用途	注册赠额度，后续按量计费	国内直连 ✅
Claude (Sonnet)	追求高质量输出	按量计费	需要代理 ⚠️
OpenAI (GPT-4o)	通用场景，生态最好	按量计费	需要代理 ⚠️
Gemini 2.0	免费额度大，适合测试	有免费套餐	需要代理 ⚠️
Ollama	追求完全免费+隐私	完全免费	本地运行，无需联网 ✅
DeepSeek	国内用户，性价比高	极低价格	国内直连 ✅

💡 新手推荐路线：第一次装，先选 MiniMax，注册即赠额度，国内直连，测试最方便。稳定使用后，再换成 DeepSeek 或 Claude，性价比更高。

选中模型后，还会让你选具体的型号：

 Which MiniMax model?  > MiniMax M2.5 (CN)    ← 推荐选这个    MiniMax M1    MiniMax M2

3.3 配置 API Key

 Enter your MiniMax API Key:  > [在这里粘贴你的 API Key]

如何获取 API Key？（以 MiniMax 为例）

打开 MiniMax 官网：https://www.minimaxi.com/
选择「API 开放平台」→ 注册/登录
登录成功后，首页点击「获取你的 Key」
创建 API Key，复制后妥善保存（只显示一次！）

粘贴完成后，会出现：

 What would you like to do with the current config?  > Keep current（保持当前配置）    Update（更新）    Reset（重置）

选 Keep current 即可（除非你要修改刚才的配置）。

⚠️ 避坑提示：API Key 粘贴时注意不要多了空格。如果测试一直提示「Invalid API Key」，先检查有没有前后空格或换行符混进去。

3.4 配置 Channel（聊天渠道）

? Which channel would you like to configure?  > Skip for now（暂时跳过）    WeChat（个人微信）    WeCom（企业微信）    Slack    Telegram    Feishu（飞书）    ...

Channel 是你和 OpenClaw 的「沟通窗口」，配好之后，你即可在微信/飞书/Telegram 发一条消息，OpenClaw 就会响应并帮你干活。

首次配置建议选 Skip for now（暂时跳过），因为：

Channel 配置相对复杂，各平台要求不同
配置错了不影响核心功能
Web UI 已经够用，可以先用浏览器界面熟悉操作

📌 Channel 配置单独出一篇详解，可以参考本系列前面介绍如何接入微信、飞书、QQ 等渠道。

3.5 配置 Skill

? Would you like to install any Skills?  > no（暂时不装）    yes（选择安装）

Skill 是 OpenClaw 的「扩展能力包」，让它能做更多事（如浏览器控制、代码执行等）。

首次配置选 no 即可，安装完基础配置先跑通，Skill 后面随用随装。

3.6 配置 Hooks

? Select hooks to install:  > Skip for now（推荐新手）    pre-tool-use    post-tool-use    notification    ...（使用空格键选择）

Hooks 是「钩子函数」，可以在 OpenClaw 执行某些操作前后触发自定义逻辑（比如：每次 AI 要执行危险命令时先弹出确认框）。

新手直接选 Skip for now，不影响正常使用。

💡 操作技巧：这里用键盘上下方向键移动，空格键选中/取消，回车键确认。不要用鼠标点，鼠标点了没用。

3.7 安装 Gateway Service

完成上面的配置后，OpenClaw 会自动开始安装 Gateway Service（后台服务）：

Installing Gateway Service...✓ Gateway Service installed successfully

这个过程可能需要 1-3 分钟，不要关闭窗口，等进度条完成。

安装成功后会提示：

? Would you like to open the Web UI?  > Yes, open Web UI    No

选 Yes，浏览器会自动打开 http://127.0.0.1:18789，这就是 OpenClaw 的网页控制台。

⚠️ PowerShell 必须以管理员身份运行，否则 Gateway Service 会安装失败。如果失败了，重新用管理员模式打开 PowerShell，再次执行 openclaw onboard --install-daemon 即可。

4. 初始化完成后的验证步骤

Onboarding 完成后，做 3 个验证确认配置成功：

验证 1：检查服务状态

在 PowerShell 中执行：

openclaw status

正常输出应该是：

✓ Gateway: running✓ API: connected✓ Model: MiniMax M2.5 (CN)

如果看到 Gateway: stopped，说明服务没起来，执行：

openclaw start

验证 2：打开 Web UI 发一条消息

浏览器打开 http://127.0.0.1:18789，在对话框里发：

你好，现在几点了？

如果 OpenClaw 正常回复了，说明 AI 模型配置成功 ✅

如果提示「API Error」或没有回复，说明 API Key 有问题，重新执行 openclaw onboard 检查密钥配置。

验证 3：测试执行能力（不只是聊天）

发送指令：

帮我在桌面创建一个叫 test.txt 的文本文件，内容写"Hello OpenClaw"

如果桌面上出现了这个文件，说明 OpenClaw 的执行能力也正常了 ✅

5. 常见报错 & 解决方案

报错信息	原因	解决方法
`Gateway Service installation failed`	没有以管理员运行 PowerShell	关闭，用管理员模式重新打开，再次执行命令
`Invalid API Key`	密钥错误或有多余空格	重新执行 `openclaw onboard`，重新粘贴密钥
`Cannot connect to model`	网络问题（用了需要代理的模型）	换成 MiniMax 或 DeepSeek 等国内直连模型
浏览器打开是空白页	Gateway 还没完全启动	等 10-20 秒后刷新页面
`EACCES: permission denied`	文件权限不足	换成管理员模式，或检查安装路径权限
卡在 `Installing dependencies...`	网络慢或 npm 源问题	换国内 npm 镜像源：`npm config set registry https://registry.npmmirror.com`

6. 总结

Onboarding 向导的核心流程可以用一句话概括：选模型 → 填 Key → 装服务 → 验证跑通。

完整流程回顾：

openclaw onboard --install-daemon  ↓Quickstart 模式  ↓选 AI 模型（新手选 MiniMax 或 DeepSeek）  ↓填 API Key  ↓Channel 暂时跳过  ↓Skill / Hooks 暂时跳过  ↓Gateway Service 安装（等待完成）  ↓打开 Web UI 验证