命令概述
openclaw onboard 是面向新用户的交互式引导命令，它与 setup 的区别在于更侧重于教学和功能演示，而非仅完成安装。
启动引导
openclaw onboard
引导流程
步骤一：欢迎与概念介绍
Welcome to OpenClaw! 🎉
OpenClaw is an AI assistant platform that connects
language models to your favorite messaging channels.
Key concepts:
• Provider: Where your AI model runs (OpenAI, Ollama, etc.)
• Channel: Where users interact (Telegram, Discord, etc.)
• Skill: Special abilities for your AI (web search, image gen, etc.)
• Gateway: The server that connects everything
Press Enter to continue...
步骤二：配置第一个供应商
引导用户配置模型供应商，包含详细说明：
Let's set up your first model provider.
Which provider would you like to start with?
[1] OpenAI - Most popular, requires API key
[2] Ollama - Free, runs locally on your machine
[3] Anthropic - Claude models, requires API key
> 1
To get an OpenAI API key:
1. Go to https://platform.openai.com/api-keys
2. Click "Create new secret key"
3. Copy the key
Enter your OpenAI API key: sk-...
Testing connection... ✓ Connected!
Available models: gpt-4o, gpt-4o-mini, gpt-3.5-turbo
Which model would you like to use? [gpt-4o-mini]
> gpt-4o-mini
步骤三：配置第一个频道
Now let's connect a messaging channel.
Which channel would you like to set up first?
[1] Telegram - Easy setup, works great
[2] Discord - For gaming communities
[3] Web Chat - Built-in web interface
[4] Skip for now
> 3
Starting Web Chat on http://localhost:3000/chat
You can test your AI assistant right in the browser!
步骤四：测试对话
Let's test your AI assistant!
You: 你好
AI: 你好！我是你的 AI 助手，有什么可以帮你的吗？
You: 今天天气怎么样？
AI: 我目前没有获取实时天气的能力，但你可以添加天气
技能让我帮你查询天气。需要我帮你设置吗？
Great! Your AI is working perfectly. ✓
步骤五：添加技能（可选）
Would you like to add some skills?
Available skills:
[x] Web Search - Search the internet
[ ] Weather - Get weather information
[x] Code Execution - Run code snippets
[ ] Image Generation - Create images
Installing selected skills... ✓
命令选项
跳过特定步骤
openclaw onboard --skip-intro # 跳过概念介绍
openclaw onboard --skip-test # 跳过测试对话
openclaw onboard --quick # 最少步骤完成
指定语言
openclaw onboard --lang zh # 中文引导
openclaw onboard --lang en # 英文引导
openclaw onboard --lang ja # 日文引导
恢复中断的引导
openclaw onboard --resume
引导完成后
引导结束时会显示后续步骤建议：
Onboarding complete! Here's what to do next:
📖 View your config: openclaw configure --show
📱 Add more channels: openclaw channels add
🔧 Add more skills: openclaw plugins install
📊 Open dashboard: openclaw dashboard
📝 View logs: openclaw logs
Documentation: https://oepnclaw.com
Community: https://discord.gg/openclaw
Happy chatting! 🎉
与 setup 的区别
| 特性 | setup | onboard |
|---|---|---|
| 目标 | 快速安装 | 学习和理解 |
| 交互程度 | 简洁 | 详细解释 |
| 测试环节 | 无 | 包含测试对话 |
| 概念介绍 | 无 | 逐步讲解 |
| 适合人群 | 有经验的用户 | 新手用户 |
再次运行
已完成引导后再次运行：
# 显示引导摘要
openclaw onboard --summary
# 重新开始完整引导
openclaw onboard --restart
总结
openclaw onboard 是新用户了解和上手 OpenClaw 的最佳入口。通过交互式引导和即时测试，用户可以在理解核心概念的同时完成基础配置，为后续的深入使用打下基础。