如果你之前看过我的其他OpenClaw教程，这篇相当于"终极版"——把安装、配置、优化、排坑全部打包在一起。如果你是第一次接触OpenClaw，直接看这篇就够，不需要再去翻其他文章了。

OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

第一阶段：安装（3分钟）

根据你的系统选择安装方式：

Windows用户：
下载 .exe 安装包 → 双击运行 → 全程下一步

macOS用户：
确认芯片类型（uname -m）→ 下载对应dmg → 拖入Applications

Linux用户（推荐Docker）：
docker run -d --name openclaw --restart unless-stopped
-p 3456:3456 -v ~/.qclaw:/root/.qclaw
nicepkg/openclaw:latest

Linux用户（源码）：
确认Node.js 18+ → git clone → npm install
第二阶段：配置（2分钟）

1. 创建 ~/.qclaw/.env 文件
2. 填入API Key：
   ZHIPU_API_KEY=你的Key
3. （可选）修改 config.yaml 调整端口和模型设置

Windows用户特别注意：文件名必须是 .env 不是 .env.txt。在文件夹选项里开启"显示文件扩展名"后再确认。

第三阶段：启动验证（1分钟）
openclaw gateway start

浏览器打开 http://localhost:3456
发送"你好"测试

收到回复 = 成功。没收到 = 检查.env文件。

第四阶段：基础配置

人设定制：编辑 ~/.qclaw/workspace/SOUL.md

你是一个专业的技术助手。
使用简体中文回复。
回复风格简洁直接。

模型选择：编辑 config.yaml

models:

• id: “daily”
  provider: “zhipu”
  model: “glm-4-flash”
  maxTokens: 2048
• id: “pro”
  provider: “zhipu”
  model: “glm-4”
  maxTokens: 4096

消息通道：在config.yaml添加

channels:
telegram:
botToken: “${TELEGRAM_BOT_TOKEN}”
allowedUsers: [“你的ID”]
第五阶段：Skill管理

查看已安装

openclaw skill list

安装新Skill

openclaw skill install xlsx # Excel操作
openclaw skill install email # 邮件收发

Skill安装后自动加载，不需要重启

第六阶段：日常运维
常用命令：
openclaw gateway status # 查看运行状态
openclaw gateway stop # 停止服务
openclaw gateway restart # 重启服务
openclaw --version # 查看版本号

数据备份：
定期备份 ~/.qclaw 目录即可
包含所有配置、记忆、对话历史
常见问题快速索引
端口冲突 → 改config.yaml里的port
Key无效 → 检查.env拼写和空格
npm超时 → 配npmmirror镜像
白屏 → 清浏览器缓存
Docker数据丢 → 检查-v卷映射
Windows乱码 → chcp 65001 或用PowerShell

从安装到日常使用，核心就是这些内容。建议把这篇收藏起来，以后遇到问题直接对照着查。