安装指南
本指南帮助你快速安装和配置 OpenClaw，开始你的 AI 助手之旅。
系统要求
推荐配置
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 12+ / Windows 10 / Ubuntu 18.04 | macOS 14+ (体验最佳) |
| 内存 | 4GB | 8GB+ |
| 存储 | 500MB | 2GB+ |
| 网络 | 能访问 AI API | 稳定网络连接 |
为什么推荐 Mac？
OpenClaw 在 Mac 上体验最好：
- 原生支持日历、备忘录、提醒事项
- 截图功能完美支持
- 与 iPhone、iPad 无缝同步
- 文件管理更智能
安装方式
方式一：一键安装（推荐）
Mac / Linux：
bash
curl -fsSL https://openclaw.ai/install.sh | bashWindows（PowerShell 管理员模式）：
powershell
irm https://openclaw.ai/install.ps1 | iex安装过程会自动：
- 检测系统环境
- 安装 Node.js（如果未安装）
- 下载并配置 OpenClaw
方式二：GitHub Releases
- 访问 GitHub Releases
- 下载对应平台的安装包
- 解压并运行安装程序
验证安装
bash
openclaw --version显示版本号（如 2026.3.2）表示安装成功！
首次配置
启动配置向导
bash
openclaw onboard配置步骤
1. 接受风险提示
选择 Yes 继续配置。
2. 选择启动模式
推荐选择 QuickStart（快速启动）。
3. 选择 AI 模型
OpenClaw 支持多种 AI 模型：
| 模型 | 价格 | 特点 | 推荐场景 |
|---|---|---|---|
| Claude Haiku | $0.25/百万token | 快速、便宜 | 日常使用 |
| DeepSeek | $0.14/百万token | 极致性价比 | 代码任务 |
| Kimi | $0.60/百万token | 200万字上下文 | 长文档处理 |
| Gemini | 有免费额度 | 多模态支持 | 图片识别 |
新手推荐
推荐 DeepSeek 或 Claude Haiku，性价比高且完全够用。
4. 输入 API Key
根据选择的模型，输入对应的 API Key：
- Anthropic (Claude): console.anthropic.com
- DeepSeek: platform.deepseek.com
- Kimi (Moonshot): platform.moonshot.cn
- Google (Gemini): makersuite.google.com
注意
API Key 是敏感信息，请勿分享给他人！
5. 选择聊天工具（可选）
可以选择接入以下平台：
- 飞书（国内推荐）
- Telegram（国外推荐）
- 企业微信、钉钉、QQ
也可以选择 None，后续再配置。
6. 端口设置
默认端口 18789，一般无需修改。
7. 选择技能包
根据需要选择技能，也可以跳过，后续随时安装。
8. 完成配置
配置完成后，会自动启动服务并打开 Web UI。
启动和使用
启动服务
bash
# 启动 Gateway 服务
openclaw gateway start
# 设置开机自启（推荐）
openclaw gateway enable访问 Web UI
打开浏览器访问：
http://127.0.0.1:18789/chat发送第一条消息
在 Web UI 中输入：
你好，能听到我说话吗？如果收到 AI 的回复，说明配置成功！
停止服务
bash
openclaw gateway stop常用命令
| 命令 | 说明 |
|---|---|
openclaw --version | 查看版本 |
openclaw onboard | 配置向导 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw gateway status | 查看状态 |
openclaw update | 更新版本 |
openclaw models list | 查看可用模型 |
常见问题
Mac 提示「无法打开，因为它来自身份不明的开发者」
解决方案：
bash
# 方法一：系统设置
# 打开「系统偏好设置」→「安全性与隐私」→ 点击「仍要打开」
# 方法二：命令行
xattr -cr /Applications/OpenClaw.appWindows 安装失败
可能原因：
- 杀毒软件拦截
- 权限不足
解决方案：
- 临时关闭杀毒软件
- 右键「以管理员身份运行」PowerShell
API Key 无效
检查项：
- 确认 API Key 是否正确复制（无多余空格）
- 确认 API Key 是否过期
- 确认账户是否有余额
连接超时
解决方案：
- 检查网络连接
- 如在国内，可能需要配置代理
如何更新 OpenClaw
bash
openclaw update如何卸载
bash
openclaw uninstall