快速开始
约 1937 字大约 6 分钟
2026-03-02
🎁 新手福利
夸克网盘资源包:包含完整的安装包、配置文件、视频教程、常用技能等资源,帮助你快速上手!
👉 立即下载资源包 👈
包含内容:
- ✅ 完整安装包(Windows/Mac/Linux)
- ✅ 配置文件模板和示例
- ✅ 视频教程(从安装到使用)
- ✅ 常用技能包合集
- ✅ 常见问题解决方案
前提条件
在开始之前,请确保你已经:
- 完成了 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 是最容易配置的平台,适合快速测试:
- 在 Telegram 中搜索 @BotFather
- 发送
/newbot创建新机器人 - 按提示设置机器人名称和用户名
- 复制获得的 Bot Token
然后在终端执行:
openclaw channels add选择 Telegram,输入 Token 即可。
详细步骤请参考:Telegram 接入指南
接入其他平台
第三步:测试你的第一个对话
在聊天平台中测试
- 打开你配置的聊天平台(如 Telegram)
- 找到你创建的机器人
- 发送一条测试消息:
你好,OpenClaw!- 如果机器人正常回复,说明配置成功!
使用命令行测试
你也可以直接在终端与 Agent 对话:
openclaw agent --message "你好,介绍一下你自己" --thinking high第四步:安装你的第一个 Skill
Skills 是 OpenClaw 的能力扩展模块。让我们安装一个实用的 Skill:
安装 ClawHub CLI
npm install -g clawhub搜索 Skills
clawhub search browser安装 Browser Skill
clawhub install browser验证安装
openclaw skills list你应该能看到 browser skill 的状态为 ready(绿色)。
测试 Browser Skill
在聊天平台中发送:
打开浏览器,搜索 OpenClaw 是什么OpenClaw 会自动调用 Browser Skill 执行搜索。
模型与授权最佳实践
推荐模型配置
根据不同场景选择合适的模型:
日常对话和任务处理
- MiniMax M2.5:国内可用,中文支持好,性价比高
- Kimi:长文本处理能力强,适合文档分析
代码相关任务
- DeepSeek:代码能力出色,推理能力强
- Claude Sonnet:代码理解和生成能力强
复杂推理和长上下文
- Claude Opus 4.6:最强的长上下文处理能力
- Anthropic Pro/Max:更强的防注入能力
本地部署
- Ollama:完全离线,隐私保护最好
- 推荐模型:Llama 3、Mistral、Qwen
配置多个模型
OpenClaw 支持配置多个模型并自动回退:
# 添加备用模型
openclaw models add
# 查看已配置的模型
openclaw models list
# 设置默认模型
openclaw models set-default <model-name>OAuth 与 API 密钥管理
- 支持 OAuth 授权(如 Google、GitHub)
- 支持 API 密钥轮换
- 自动回退到备选模型
安全默认配置
OpenClaw 默认启用了多项安全机制:
私信配对机制
未知联系人默认不执行命令,需要先配对:
# 查看待配对的联系人
openclaw pairing list
# 批准配对请求
openclaw pairing approve <contact-id>白名单策略
建议为生产环境启用白名单:
# 在配置文件中设置
{
"channels": {
"telegram": {
"groupPolicy": "allowlist",
"allowedUsers": [
"user_id_1",
"user_id_2"
]
}
}
}定期安全检查
# 运行诊断工具
openclaw doctor
# 检查配置安全性
openclaw security check
# 查看审计日志
openclaw logs --filter security常用操作
启动和停止服务
# 启动 Gateway
openclaw gateway
# 后台运行
openclaw gateway --daemon
# 停止服务
openclaw stop
# 重启服务
openclaw restart查看状态和日志
# 查看运行状态
openclaw status
# 查看实时日志
openclaw logs --follow
# 查看特定 Agent 的日志
openclaw logs --agent main
# 查看错误日志
openclaw logs --level error管理 Agents
# 列出所有 Agents
openclaw agents list
# 创建新 Agent
openclaw agents add coder
# 编辑 Agent 的 SOUL
openclaw agents edit coder --soul
# 删除 Agent
openclaw agents remove coder更新与版本管理
切换版本通道
# 稳定版(推荐)
openclaw update --channel stable
# 测试版(新功能)
openclaw update --channel beta
# 开发版(最新,可能不稳定)
openclaw update --channel dev从源码更新
如果你是从源码安装的:
cd openclaw
git pull
pnpm install
pnpm build
pnpm gateway:watch下一步
恭喜!你已经完成了 OpenClaw 的基础配置。接下来你可以:
- 探索更多渠道:渠道配置指南
- 安装更多 Skills:Skills 市场
- 配置多 Agent:多 Agent 配置
- 学习高级功能:配置指南
- 查看实战案例:使用案例
常见问题
Q: 配置完成后机器人不响应?
检查以下几点:
- Gateway 是否正在运行:
openclaw status - Channel 状态是否为 Running:
openclaw channels list - 查看日志排查问题:
openclaw logs
Q: 如何更换模型?
# 重新运行配置向导
openclaw onboard
# 或直接添加新模型
openclaw models addQ: 忘记了 Dashboard 地址?
默认地址是 http://127.0.0.1:18789,或运行:
openclaw dashboardQ: 如何备份配置?
配置文件位于 ~/.openclaw/,直接备份该目录即可:
# Linux/macOS
cp -r ~/.openclaw ~/.openclaw.backup
# Windows
xcopy %USERPROFILE%\.openclaw %USERPROFILE%\.openclaw.backup /E /I