夜雨聆风一、安装部署 OpenClaw
OpenClaw运行依赖Node.js 24+ 和 Git，Node.js安装包自带npm，无需单独下载，以下为各系统适配的安装步骤，Windows操作需全程以管理员身份打开PowerShell。
1. Node.js 安装
官方地址：nodejs.org/
选择 LTS v24+ （稳定）版本，页面自动识别系统，直接下载对应安装包；
安装时默认选项即可，务必勾选Add to PATH，确保命令行可识别。
安装时勾选 Automatically install the necessary tools（自动安装构建工具）
验证安装：打开 PowerShell 输入
node -v
npm -v
能正常输出版本号即安装成功。
2. 允许运行脚本
按下 Win + X，选择「Windows PowerShell (管理员)」或「终端 (管理员)」
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
3. 一键安装 OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex
安装完成后自动进入交互式配置流程，按以下选项选择即可，部分配置可后续在Web UI/终端修改，配置项后附简单说明，方便理解选择原因：
配置项 选择/操作 配置说明
I understand this is powerful and inherently risky. Continue? 选择 “Yes” 确认知晓风险并继续部署
Onboarding mode 选择 “QuickStart” 快速启动模式，适合新手，简化配置
Model/auth provider 选免费Qwen / 选"Skip for now" 推荐先选Qwen（免费），后续可配置其他模型；暂不配置则选Skip
Filter models by provider 选择 “All providers” 显示所有模型提供商，方便后续切换
Default model 使用默认配置 保持默认，后续可在配置文件中修改
Select channel (QuickStart) 选择 “Skip for now” 暂不配置渠道
Configure skills now? (recommended) 选择 “No” 暂不配置技能，后续按需添加
Enable hooks? 按空格键选中 → 按回车键下一步 启用钩子功能，支持命令日志、会话记忆等核心特性
How do you want to hatch your bot? 选择 “Hatch in TUI” 从终端界面启动机器人，基础交互更便捷
4. 关掉当前窗口，重新打开一个新窗口 PowerShell
检查版本：
openclaw --version
出现版本号 = 安装成功。
5. 启动网关
openclaw gateway start
6. 打开控制面板
浏览器访问：
http://127.0.0.1:18789
到这里就全部安装完成了。
二、更新与卸载
1. 更新到最新版
# 方式1：重新运行安装脚本（原地升级）
iwr -useb https://openclaw.ai/install.ps1 | iex
# 方式2：npm 手动更新
openclaw gateway stop
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
openclaw doctor
openclaw gateway restart
2. 完全卸载
# 停止并卸载网关服务
openclaw gateway stop
openclaw gateway uninstall
# 卸载 npm 包
npm uninstall -g openclaw
# 删除配置目录（可选）
Remove-Item -Recurse -Force \$env:USERPROFILE\.openclaw
三、切换模型
1.先启动网关并打开面板
PowerShell 运行：
openclaw gateway start
浏览器打开：
http://127.0.0.1:18789
方法 1：面板可视化切换（最直观）
进入面板后，点击顶部 Config（配置）标签页docs.openclaw.ai。
找到
Models
（模型）区域：
Primary Model：设置全局默认模型（如 openai/gpt-4o、anthropic/claude-sonnet、glm/GLM-5）。
Fallbacks：添加备用模型（主模型不可用时自动切换）。
点击 Save 保存，网关会自动热重载，无需重启docs.openclaw.ai。
也可在 Chat 聊天页，直接用 /model 命令打开选择器（见方法 2）。
方法 2：聊天中临时切换（当前会话生效）
在面板的 Chat 页面输入框里，直接用命令切换：
打开模型选择器：/model
列出所有可用模型：/model list
按编号切换（如第 3 个）：/model 3
直接指定模型：/model openai/gpt-4o、/model glm/GLM-5
查看当前模型：/model statusopenclaws.io
特点：只对当前聊天会话生效，刷新 / 重启后恢复默认模型。
方法 3：CLI 命令永久切换默认模型
在 PowerShell 运行：
# 查看当前模型状态
openclaw models status
# 永久设置默认模型（示例）
openclaw models set openai/gpt-4o
openclaw models set anthropic/claude-sonnet-4-6
openclaw models set glm/GLM-5
# 添加备用模型（主模型挂了自动切）
openclaw models fallbacks add openai/gpt-4o-mini
设置后重启网关生效：
openclaw gateway restart
2.常见模型格式（直接复制用）
openai/gpt-4o
openai/gpt-4o-mini
anthropic/claude-sonnet-4-6
anthropic/claude-haiku
glm/GLM-5
deepseek/deepseek-chat-v3
qwen/qwen-2-72b-chat
3.添加新模型 / 自定义模型（如国产模型）
在面板 Config → Models → Providers 里添加服务商配置。
填写：baseUrl、apiKey、models 列表。
保存后即可在 /model 列表里选择。
四、常用命令
# 服务管理
openclaw gateway start # 启动网关
openclaw gateway stop # 停止网关
openclaw gateway restart# 重启网关
openclaw gateway status # 查看网关状态
# 配置管理
openclaw config validate # 验证配置
openclaw config set <key> <value> # 设置配置项
# 插件管理
openclaw plugins list # 查看已安装插件
openclaw plugins install <插件地址> # 安装插件
openclaw plugins uninstall <插件名> # 卸载插件
# 诊断与修复
openclaw doctor # 诊断问题
openclaw doctor --fix # 诊断并修复
# 交互方式
openclaw dashboard # 启动Web UI
openclaw tui # 启动TUI终端
