夜雨聆风全程复制粘贴，5分钟搞定，不用装Node.js、不用改环境变量。
📋 安装前检查（必看）
• 系统：Windows 10+/macOS 12+
• 内存：≥8GB（推荐16GB）
• 硬盘：预留≥2GB空间
• 网络：正常联网（国内用镜像更快）
🪟 Windows 安装（最常见）
1. 打开管理员PowerShell（关键！）
1. 左下角搜索：PowerShell
2. 右键「Windows PowerShell」→ 以管理员身份运行
3. 弹出UAC，点是
2. 一键安装（复制粘贴）
国内镜像（推荐，速度快）
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
官方原版（海外/直连）
iwr -useb https://openclaw.ai/install.ps1 | iex
• 回车，等待3–8分钟，不要关窗口、不要断网
• 自动装Node.js、配置环境、安装OpenClaw
3. 验证安装
openclaw --version
显示版本号（如v2.1.0）即成功
🍎 macOS 安装（更简单）
1. 打开终端
启动台→其他→终端，或快捷键 Command+空格 搜「终端」
2. 一键安装（复制粘贴）
国内镜像（推荐）
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
官方原版
curl -fsSL https://openclaw.ai/install.sh | bash
• 回车等待，自动完成
3. 验证安装
openclaw --version
显示版本号即成功
🚀 初始化与启动（安装后必做）
1. 运行配置向导
openclaw onboard
• 按提示选择模型（OpenAI/Gemini/国内大模型）
• 输入你的 API Key（从模型平台获取）
• 新手直接按默认即可
2. 启动服务
openclaw gateway start
3. 访问Web面板
浏览器打开：http://localhost:18789
❌ 常见小白报错（一键解决）
Windows 报错：脚本无法运行
先执行（输入Y确认）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
再重新运行安装命令
macOS 报错：权限不足
命令前加 sudo，输入电脑密码：
sudo curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
命令找不到
重启终端/ PowerShell，再试
✅ 安装完成！
现在你可以在浏览器里用OpenClaw管理AI模型、对接聊天平台了。
已安装好OpenClaw，按下面步骤5分钟上手，直接能用。
一、启动与进入面板（必做）
1. 启动网关服务
打开终端/PowerShell，运行：
openclaw gateway start
• 看到 Gateway running on http://localhost:18789 即成功
• 不要关终端，保持运行
2. 打开Web控制面板
浏览器访问：http://localhost:18789
• 首次进入会自动加载配置向导
二、核心配置：添加AI模型（关键）
1. 进入模型设置
左侧菜单 → Settings → Models
2. 添加模型（以GPT为例）
• 点击 Add Model
• 选择 OpenAI
• 填写：
◦ Name：自定义（如 gpt-4o）
◦ API Key：你的OpenAI密钥（从OpenAI官网获取）
◦ Model：gpt-4o 或 gpt-3.5-turbo
• 点击 Test Connection → 显示 Success
• 设为 Default Model → Save
3. 国内模型（通义/文心/豆包）
• 选择对应厂商
• 填写 API Key + Base URL（厂商提供）
• 测试成功后保存
三、创建第一个AI助手（Agent）
1. 新建Agent
左侧菜单 → Agents → New Agent
2. 基础设置（新手直接填）
• Name：助手名（如 我的AI助理）
• Identity：角色（如 全能办公助手）
• Instructions：指令（如 帮我处理文档、写文案、查资料）
• Model：选刚才添加的默认模型
• 点击 Create
四、开始聊天（最常用）
1. 进入聊天
左侧菜单 → Chat → 选择刚创建的Agent
2. 发送指令（自然语言即可）
• 示例1：帮我写一份灵犀之约平台的推广文案
• 示例2：总结这篇文档：https://xxx
• 示例3：创建一个自由职业者接单流程表
3. 常用聊天命令
• /status：查看模型、Token用量
• /new：重置当前对话
• /help：查看所有命令
五、安装技能（扩展能力）
1. 进入技能市场
左侧菜单 → ClawHub
2. 安装常用技能（新手必装）
• weather：查天气（零配置）
clawhub install weather
• file-manager：管理本地文件
• web-search：联网搜索
• memory：记忆功能
3. 使用技能
安装后直接发指令：
• 查深圳今天天气
• 打开桌面的灵犀之约文档
• 记住：灵犀之约抽佣8%-15%
六、接入常用平台（可选）
1. 接入微信/飞书/钉钉
左侧菜单 → Channels → Add Channel
• 选择平台 → 按向导授权/填Token
• 完成后可在对应软件里@AI助手
2. 接入Discord/Telegram
同理选择对应渠道，完成API配置
七、常见问题（小白必看）
1. 模型连接失败
• 检查API Key是否正确
• 网络是否正常（国内可换国内模型）
• 重启网关：openclaw gateway restart
2. 命令找不到
• 重启终端/PowerShell
• 重新安装：npm install -g openclaw
3. 面板打不开
• 确认网关已启动
• 访问：http://127.0.0.1:18789
八、快速启动流程（总结）
1. 启动网关：openclaw gateway start
2. 打开面板：http://localhost:18789
3. 添加模型（填API Key）
4. 创建Agent
5. 开始聊天/安装技能