🚀 最稳一键安装命令
macOS / Linux（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell（管理员）
iwr -useb https://openclaw.ai/install.ps1 | iex
Windows CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
备选方案：npm 全局安装（适合已有 Node.js 环境）
npm install -g openclaw
# 或
pnpm add -g openclaw
⚙️ 配置操作步骤
第一步：环境检查
确保系统满足要求：
- Node.js ≥ 22（一键脚本会自动安装）
- 内存 ≥ 2GB（运行最低要求）
第二步：运行安装脚本
执行上述对应系统的一键安装命令，等待自动下载和安装完成。
第三步：初始化配置向导
安装完成后，运行 onboarding 向导：
openclaw onboard
按提示完成以下配置：
| 步骤 | 配置项 | 推荐选择 |
|---|---|---|
| 1 | 安全警告 | 选择 "Yes" 确认了解风险 |
| 2 | 引导模式 | 选择 "QuickStart"（快速启动） |
| 3 | 选择 AI 模型 | 国内用户选 阿里云百炼 / Google Gemini；国外选 OpenAI GPT |
| 4 | 输入 API Key | 从对应平台获取并粘贴 |
| 5 | 选择具体模型 | 推荐 qwen3.5-plus、kimi-k2.5 或 gpt-4o-mini |
| 6 | 通讯渠道 | 新手选 "Skip for now"（稍后配置） |
| 7 | 技能配置 | 选 "No"（先基础运行） |
| 8 | 守护进程 | 选 "Yes"（后台持续运行） |
第四步：验证安装
# 检查版本
openclaw --version
# 诊断状态
openclaw doctor
# 查看运行状态
openclaw status
第五步：访问控制面板
# 自动打开浏览器
openclaw dashboard
# 或手动访问（默认端口 18789）
http://localhost:18789
🔧 常用运维命令
# 启动/停止/重启服务
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
# 查看日志
openclaw logs
# 重新配置
openclaw onboard
# 修复配置问题
openclaw doctor --fix
📁 重要文件路径
| 内容 | 路径 |
|---|---|
| 配置文件 | ~/.openclaw/openclaw.json |
| 日志文件 | ~/.openclaw/logs/ |
| 技能目录 | ~/.openclaw/skills/ |
💡 国内用户特别建议
网络优化：如遇下载卡顿，可配置 npm 镜像
npm config set registry https://registry.npmmirror.com推荐模型：阿里云百炼的 Coding Plan（月费 7.9 元起，成本可控）
云部署：建议使用阿里云轻量应用服务器（2核2G，约 38-68元/年），选择 OpenClaw 镜像 可一键部署，避免本地环境折腾
⚠️ 注意事项
- 端口安全：默认使用随机端口（非 18789），首次使用需在防火墙放行
- API Key 安全：切勿泄露，OpenClaw 仅保存在本地
~/.openclaw/目录 - 权限问题：Windows 安装失败时，请使用管理员身份运行 PowerShell
如需接入飞书、钉钉、微信等通讯工具，可在初始化完成后运行 openclaw onboard 重新配置渠道。
