2.4 首次启动：引导配置详解

概述

一、引导配置是什么

当你第一次运行 openclaw onboard 时，会进入一个交互式引导界面，帮助你完成初始配置。

你不需要理解所有技术细节，只需要跟着提示一步步选择和填写。

二、引导流程概览

欢迎界面
    ↓
选择语言
    ↓
配置 AI 模型（API Key）
    ↓
配置渠道（飞书/钉钉）
    ↓
配置管理员
    ↓
安装服务
    ↓
完成

三、每一步详细说明

Step 1：欢迎界面

🦞 欢迎使用 OpenClaw！
我们即将引导你完成初始配置。
这个过程大约需要 3-5 分钟。
按 [Enter] 继续...

操作：直接按回车即可。

Step 2：选择语言

请选择界面语言：
1. English
2. 简体中文
请输入数字 [1-2]：

操作：输入 2，选择简体中文。

Step 3：配置 AI 模型（API Key）

这是最关键的一步，AI 的"智商"就靠这个。

📡 配置 AI 模型
请选择模型提供商：
1. MiniMax（推荐，中文支持好，速度快）
2. DeepSeek（推理能力强）
3. 阿里云百炼
4. OpenAI（需要代理）
5. 自定义
请输入数字 [1-5]：

操作：

• 推荐选 1（MiniMax）
• 或选 2（DeepSeek）
• 选完后会提示输入 API Key

API Key：___________________

输入你的 API Key（从平台控制台获取）。

⚠️ 注意：

• API Key 不显示是正常的（隐藏密码），直接输入即可
• API Key 类似于账号密码，不要泄露给陌生人

Step 4：配置渠道

📱 配置消息渠道
你想让 AI 在哪些平台响应消息？
可用的渠道：
1. 飞书（适合企业用户）
2. 钉钉（适合企业用户）
3. 企业微信
4. Telegram
5. 暂不配置（仅使用网页控制台）
请选择 [1-5]，多个用逗号分隔：

操作：

• 想接入飞书：输入 1
• 想接入钉钉：输入 2
• 只想先体验：输入 5

以接入飞书为例：

请选择 [1-5]：1
飞书配置：
App ID：cli_xxxxxxxxxx
App Secret：________________

输入飞书机器人的 App ID 和 App Secret。

Step 5：配置管理员

👤 配置管理员
管理员拥有最高权限，可以：
访问所有配置
管理其他用户权限
访问敏感数据
请输入你的飞书 Open ID（用于识别你的身份）：

输入你的飞书 Open ID（通常是一个以 ou_ 开头的字符串）。

Step 6：安装服务

🔧 正在安装...
[████████████████████░░░░] 80%

等待安装完成。

Step 7：完成

🎉 恭喜！OpenClaw 配置完成！
Gateway 地址：http://127.0.0.1:18789
控制台：http://127.0.0.1:18789/
下一步：
启动服务：openclaw gateway start
查看状态：openclaw gateway status
配置更多渠道：openclaw configure
按 [Enter] 退出引导...

四、引导之后

启动 Gateway

每次电脑重启后，如果 Gateway 没有自动运行，手动启动：

openclaw gateway start

查看状态

openclaw gateway status

五、常见问题

六、下一步学什么

• 2.5 连接第一个渠道：飞书（图文版） → 完整的飞书配置步骤
• 2.7 发送第一条消息：Hello World → 验证你的安装是否成功

如有疑问，欢迎在群内提问！