快速开始
从零开始配置并运行 OpenClaw
在开始之前，请确保你已经：
- 完成了 OpenClaw 的安装。
- 准备好至少一个 AI 模型的 API Key（如 MiniMax、Kimi、Claude 等）。
- 有一个常用的聊天平台账号（Telegram、Discord、飞书等）。
🚀 第一步：运行引导向导
启动配置向导
在终端执行以下命令：
openclaw onboard --install-daemon这个命令会自动执行三件事：
- 启动交互式配置向导。
- 安装后台守护进程（可选）。
- 建立必要的配置文件和环境目录。
配置流程详解
1. 选择配置模式
? 选择配置模式:
❯ QuickStart - 快速开始（推荐新手）
Custom - 自定义配置（高级用户）💡 提示：推荐选择 QuickStart，它会引导你完成最基础的配置。
2. 配置 AI 模型
选择你要使用的 AI 模型供应商：
? 选择 AI 模型供应商:
❯ MiniMax M2.5(CN) - 国内可用，中文支持好
Kimi - 月之暗面，长文本处理强
DeepSeek - 推理能力强，代码能力出色
Claude - Anthropic 出品（需国际网络）
OpenAI GPT - 经典选择（需国际网络）
Gemini - Google 出品（需国际网络）
Ollama - 本地模型，完全离线🌏 国内用户推荐：MiniMax 或 Kimi（无需翻墙，响应快）
3. 输入 API Key
根据选择的模型供应商，粘贴对应的 API Key：
? 输入 API Key: [粘贴你的 API Key]
✓ 正在验证 API Key...
✓ 认证成功！如何获取 API Key？
- MiniMax：访问 MiniMax 开放平台
- Kimi：访问 月之暗面开放平台
- DeepSeek：访问 DeepSeek 开放平台
- Claude：访问 Anthropic Console
- OpenAI：访问 OpenAI Platform
4. 跳过可选配置
首次配置时，建议跳过以下高级组建的初始化，稍后单独设置：
? 是否现在配置 Channel（渠道）?
❯ 跳过，稍后配置
? 是否现在安装 Skills（技能）?
❯ 跳过，稍后安装
? 是否现在配置 Hooks（钩子）?
❯ 跳过，稍后配置5. 打开 Web UI
? 是否打开 Web Dashboard?
❯ 是
✓ 正在启动 Gateway...
✓ Gateway 已启动在端口 18789
✓ 正在打开浏览器...
✓ Dashboard 地址: http://127.0.0.1:18789配置结束后，浏览器会自动打开 OpenClaw 的 Web 管理界面。
💬 第二步：连接聊天平台
建议先连接一个常用的聊天平台进行初步测试。
推荐平台对比
| 平台 | 难度 | 国内可用 | 推荐场景 |
|---|---|---|---|
| Telegram | ⭐ 简单 | ✅ 是 | 个人使用、快速测试 |
| Discord | ⭐⭐ 中等 | ✅ 是 | 开发者社区、团队协作 |
| 飞书 | ⭐⭐ 中等 | ✅ 是 | 企业团队、工作协作 |
| 微信 | ⭐⭐⭐ 复杂 | ✅ 是 | 国内用户、日常沟通 |
| ⭐⭐ 中等 | ❌ 需国际网络 | 国际用户 |
快速接入 Telegram（推荐最容易）
- 在 Telegram 中搜索 @BotFather。
- 发送
/newbot指令创建新机器人。 - 按照提示输入机器人名称和 Username。
- 复制获得的
Bot Token。
然后在终端执行：
openclaw channels add选择 Telegram 选项，然后填入刚刚的 Token 即可！
🧪 第三步：测试你的首个对话
在聊天平台中测试
- 打开你配置的聊天平台（如 Telegram）。
- 发起对话，找到你刚创建的机器人。
- 发送第一条测试消息：
你好，OpenClaw！ - 如果机器人成功回复了你，恭喜你配置大功告成！
使用终端代理测试
你也可以直接在命令行内与 Agent 进行直接对话测试：
openclaw agent --message "你好，请自我介绍一下" --thinking high🧩 第四步：安装你的首个 Skill
Skills （技能）是 OpenClaw 的核心扩展模块。让我们尝试安装一个非常实用的 Browser（浏览器）技能：
安装 ClawHub CLI 工具
npm install -g clawhub搜索与安装 Browser 技能
clawhub search browser
clawhub install browser验证验证工作状态
openclaw skills list如果列表中
browser的状态显示为绿色的ready，则表示技能已经挂载成功！
测试验证技能
回到你之前接入的聊天平台（例如 Telegram）中，发送以下自然语言指令：
打开浏览器，搜索 OpenClaw 是什么，并告诉我摘要此时，你可以看到 OpenClaw 正在调用它的浏览器辅助工具在后台完成搜索工作！
🔐 安全与最佳实践
OpenClaw 默认启用了多项安全机制，避免被陌生人滥用：
1. 私信认证机制（Pairing）
新联系人默认无权执行任何命令，需要所有者主动授权：
# 查看拦截列表中的配对对象
openclaw pairing list
# 批准特定会话的配对请求
openclaw pairing approve <contact-id>2. 白名单隔离（Allowlist）
如果机器人运行在公有群组，强烈建议对配置环境开启白名单。
在 配置文件 设置中增加：
{
"channels": {
"telegram": {
"groupPolicy": "allowlist",
"allowedUsers": [
"your_user_id_1"
]
}
}
}3. 多模型自动回退（Fallback）
为了防止单一的 AI 服务中断导致助手宕机，你可以随时添加并管理备选推理模型：
openclaw models add
openclaw models list
openclaw models set-default <model-name>🛠️ 后台日常管理指令
对于日常服务的运维操作，主要集成了以下终端指令集：
# 启动 Gateway (网关接入)
openclaw gateway
# 以 Daemon 后台方式守护运行
openclaw gateway --daemon
# 停止后端所有依赖模块
openclaw stop
# 重启守护进程
openclaw restart如果遇到了异常故障不回消息，你可以通过内置 Log 功能查阅：
# 查看运行状态
openclaw status
# 查看实时错误日志追踪
openclaw logs --follow
openclaw logs --level error🎯 接下来该去哪？
恭喜！你不仅完成配置，而且已经掌握了 OpenClaw 最重要的工具链！接下来你可以：