OpenClaw 交互式初始化详细指南

本文档详细说明 OpenClaw 安装完成后的交互式初始化流程，帮助用户完成首次配置。

---

📋 初始化流程概览

OpenClaw 安装完成后，运行以下命令启动交互式初始化：

openclaw onboard

或者使用快捷方式：

# macOS
openclaw

# 如果是首次安装，CLI 会自动提示运行 onboarding

---

🔧 初始化大项详解

1️⃣ 选择初始化模式

提示：

Welcome to OpenClaw! Let's get you set up.

How would you like to proceed?
› Quick setup (recommended for most users)
  Advanced setup (more options)
  Manual configuration

选项	说明	适用场景
Quick setup	快速配置，推荐大多数用户	首次使用，想要快速上手
Advanced setup	高级选项	需要自定义配置
Manual configuration	手动配置	高级用户，已有配置文件

举例：

• 新手用户：选择 Quick setup，系统会自动检测环境并配置常用选项
• 有经验的用户：选择 Advanced setup 可以配置更多细节
• 需要迁移的用户：选择 Manual configuration 可以导入已有配置

---

2️⃣ 工作空间设置

提示：

📁 Workspace Setup

Where should OpenClaw store its data?
› ~/.openclaw/workspace
  Custom path: ___

选项	说明
默认路径	~/.openclaw/workspace（推荐）
自定义路径	输入绝对路径，如 /Users/username/my-openclaw

举例：

# 默认直接回车即可
📁 Workspace Setup
Where should OpenClaw store its data?
› ~/.openclaw/workspace

✅ Workspace ready: /Users/username/.openclaw/workspace

---

3️⃣ 网关连接模式

提示：

🌐 Gateway Connection

How should clients connect to your gateway?
› Local (loopback) - Same machine only
  LAN - Local network accessible
  Tailscale - Secure remote access
  Auto-detect (recommended)

选项	说明	适用场景
Local (loopback)	仅本机可访问	仅本地使用
LAN	局域网可访问	家庭/办公网络多设备
Tailscale	远程安全访问	需要远程访问
Auto-detect	自动检测（推荐）	不确定网络环境

举例：

🌐 Gateway Connection
How should clients connect to your gateway?
› Auto-detect (recommended)

🔍 Detected: LAN mode (192.168.1.100:18789)

---

4️⃣ 网关认证方式

提示：

🔐 Gateway Authentication

How should clients authenticate?
› Token (recommended) - Generate a secure token
  Password - User-defined password
  None - No authentication (not recommended)

选项	说明	安全级别
Token	自动生成安全令牌	⭐⭐⭐ 高
Password	自定义密码	⭐⭐ 中
None	无认证	⭐ 低（不推荐）

举例：

🔐 Gateway Authentication
How should clients authenticate?
› Token (recommended)

🔑 Generated token: oc_sk_xxxxx...xxxxx
💾 Save this token - you'll need it to connect!

---

5️⃣ API Key 配置

提示：

🔑 API Keys

Let's set up your AI provider. You can add multiple later.

Select provider:
› OpenAI
  Anthropic (Claude)
  Google Gemini
  Azure OpenAI
  Local/Others...

主流提供商	说明	常用模型
OpenAI	GPT-4o, GPT-4o mini	gpt-4o, gpt-4o-mini
Anthropic	Claude 4	claude-sonnet-4-20250514
Google Gemini	Gemini 2.5	gemini-2.5-pro-preview
MiniMax	国产大模型	MiniMax-M2.5
百度文心一言	国产大模型	ernie-4.5-8k
阿里通义千问	国产大模型	qwen-max

举例 - 配置 OpenAI：

🔑 API Keys
Select provider: OpenAI

🔑 Enter your OpenAI API key:
sk-__________________________  # 输入你的 API key

✅ OpenAI configured successfully!
Model: gpt-4o

举例 - 配置 MiniMax（国产）：

🔑 API Keys
Select provider: MiniMax

🔑 Enter your MiniMax API key:
abcd1234__________________  # 输入你的 API key

✅ MiniMax configured successfully!
Model: MiniMax-M2.5

---

6️⃣ 频道配置（消息渠道）

提示：

💬 Channels

Which messaging platforms would you like to enable?

Telegram
› ○ Enable
  ○ Skip

Feishu (飞书)
  ○ Enable
  ○ Skip
...

频道	说明	备注
Telegram	即时通讯	需要 Bot Token
Feishu (飞书)	企业通讯	需要 App ID/Secret
Discord	游戏社区	需要 Bot Token
WhatsApp	即时通讯	需要 WhatsApp Business API
Slack	企业协作	需要 Bot Token
Signal	私密通讯	需要 Signal 机器人

举例 - 配置 Telegram：

💬 Channels
Telegram: Enable

🔑 Enter your Telegram Bot Token:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

✅ Telegram configured!

---

7️⃣ 搜索服务配置

提示：

🔍 Search Provider

Choose a web search backend (optional but recommended):

› Perplexity (recommended)
  Brave Search
  Google Custom Search
  Tavily
  None

搜索服务	说明	需要
Perplexity	AI 增强搜索（推荐）	API Key
Brave Search	独立搜索引擎	API Key
Google CSE	Google 自定义搜索	API Key + Search Engine ID
Tavily	AI 搜索	免费配额

举例 - 配置 Perplexity：

🔍 Search Provider
Select: Perplexity

🔑 Enter your Perplexity API key:
pplx-__________________________

✅ Search configured!
Default model: sonar-pro

---

8️⃣ Skills 安装

提示：

🛠️ Skills

Would you like to install recommended skills?

› Install recommended skills (Y/n)
  Skip
  Browse skill library

选项	说明
安装推荐技能	安装常用技能集（推荐）
跳过	稍后手动安装
浏览技能库	查看全部可用技能

推荐安装的 Skills：

Skill	用途
clawhub	搜索/安装/发布技能
healthcheck	系统安全检查
weather	天气查询
video-frames	视频帧提取

举例：

🛠️ Skills
Install recommended skills (Y/n): y

📦 Installing skills...
✅ Installed: clawhub, healthcheck, weather, video-frames

---

9️⃣ 后台服务安装

提示：

🚀 Daemon Setup

OpenClaw can run as a background service (recommended).

› Install as user launch agent (macOS)
  Install as systemd service (Linux)
  Skip (run manually)

平台	推荐方式
macOS	LaunchAgent
Linux (systemd)	systemd
手动	每次手动运行 openclaw gateway

举例 - macOS：

🚀 Daemon Setup
Install as user launch agent (macOS): y

✅ Daemon installed and running!
Service: com.openclaw.daemon
Status: active (running)

---

🔟 Control UI 访问

提示：

🎨 Control UI

Your gateway is ready!

Access your dashboard:
› http://localhost:18789 (local)
  http://192.168.1.100:18789 (LAN)

API Token: oc_sk_xxxxx...xxxxx

---

📝 完整初始化流程示例

🦞 OpenClaw 2026.3.7 - Welcome!

📁 Workspace Setup
Where should OpenClaw store its data?
› ~/.openclaw/workspace
✅ Workspace ready

🌐 Gateway Connection
How should clients connect?
› Auto-detect (recommended)
🔍 Detected: LAN mode (192.168.1.100:18789)

🔐 Gateway Authentication
How should clients authenticate?
› Token (recommended)
🔑 Generated token: oc_sk_abc123...

🔑 API Keys
Select provider: OpenAI
Enter your OpenAI API key: sk-xxxx...
✅ Configured! Model: gpt-4o

💬 Channels
Telegram: Enable
Enter Bot Token: 1234:ABC...
✅ Telegram enabled!

🔍 Search Provider
Select: Perplexity
Enter API key: pplx-xxxx...
✅ Search configured!

🛠️ Skills
Install recommended skills (Y/n): y
✅ Installed: clawhub, healthcheck

🚀 Daemon Setup
Install as launch agent (Y/n): y
✅ Running!

🎉 All done!

🌐 Access: http://192.168.1.100:18789
🔑 Token: oc_sk_abc123...
📖 Docs: https://docs.openclaw.ai

---

⚙️ 非交互式初始化

如果需要自动化部署，可以使用命令行参数：

# 完整非交互式配置
openclaw onboard \
  --flow quickstart \
  --gateway-bind auto \
  --gateway-auth token \
  --openai-api-key "sk-xxx" \
  --skip-channels \
  --install-daemon

常用参数

参数	说明
--flow	流程模式：quickstart/advanced/manual
--workspace	工作空间路径
--gateway-bind	连接模式：loopback/lan/tailnet/auto
--gateway-auth	认证方式：token/password
--openai-api-key	OpenAI API Key
--minimax-api-key	MiniMax API Key
--skip-channels	跳过频道配置
--skip-skills	跳过技能安装
--install-daemon	安装后台服务

---

🔧 初始化后配置

初始化完成后，你还可以：

添加更多频道

openclaw config set channels.telegram.enabled true
openclaw config set channels.feishu.enabled true

添加更多 API Key

openclaw config set providers.anthropic.apiKey "sk-ant-xxx"

安装更多 Skills

clawhub install stock-analysis
clawhub install weather

查看状态

openclaw status

---

❓ 常见问题

Q: 初始化卡住了怎么办？

A: 按 Ctrl+C 退出，然后重新运行 openclaw onboard --reset

Q: 如何重新配置某个选项？

A: 运行 openclaw onboard --reset 重新开始，或使用 openclaw config set 单独修改

Q: API Key 在哪里获取？

• OpenAI: https://platform.openai.com/api-keys
• Anthropic: https://console.anthropic.com/
• MiniMax: https://platform.minimax.io/
• Perplexity: https://www.perplexity.io/settings

Q: 如何查看详细日志？

openclaw logs --follow

---

📖 更多文档请访问：https://docs.openclaw.ai