夜雨聆风从零开始养龙虾，10分钟搞定全流程全网最详细的OpenClaw入门指南
— — — — — — — — — —
一、OpenClaw是什么？
OpenClaw是2026年最火的开源AI Agent项目，GitHub 315K+ Star，被称为"真正能干活的AI助手"。它能帮你：自动监控服务器、清理磁盘、管理日程、搜索信息、执行Shell命令……而且所有操作都在你的本地电脑上运行，隐私安全有保障。
最酷的是，你可以通过微信、Telegram、Discord等聊天软件和它对话，就像和一个真人同事沟通一样。
二、安装前准备
2.1 系统要求
项目 | 要求 |
操作系统 | Windows 10/11、macOS 12+、Ubuntu 20.04+ |
Node.js | v20+（推荐v22 LTS） |
网络 | 能访问大模型API |
硬盘 | 至少500MB可用空间 |
2.2 安装Node.js
OpenClaw基于Node.js运行，需要先安装它：
Windows用户：
访问 https://nodejs.org/zh-cn/download/ 下载安装包双击安装，勾选"Add to PATH"选项安装完成后打开CMD/PowerShell，输入 node -v 验证
macOS用户：
brew install node@22
Linux用户：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs
验证安装：
node -v # 应显示 v22.x.xnpm -v # 应显示 10.x.x
三、安装OpenClaw（三选一）
3.1 方式一：一键安装（推荐小白）
macOS / Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（管理员PowerShell）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUserSet-ExecutionPolicy -Scope Process -ExecutionPolicy Bypassiwr -useb https://openclaw.ai/install.ps1 | iex
3.2 方式二：NPM手动安装
# Windowsnpm install -g openclaw@latest# macOS/Linux（可能需要sudo）sudo npm install -g openclaw@latest
��如果安装过程中sharp模块报错，加上环境变量：SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
3.3 方式三：Docker部署
docker run -d \ --name openclaw \ -p 3000:3000 \ -v ~/.openclaw:/root/.openclaw \ openclaw/openclaw:latest
⚠️ Docker方式需要先安装Docker Desktop，对小白来说略复杂，建议优先选择方式一或方式二。
四、初始化配置
安装完成后，运行初始化命令：
openclaw onboard
按照提示依次操作：
• 第1步：同意风险告知 → 选择 Yes
• 第2步：选择 QuickStart 模式
• 第3步：配置AI模型API Key（国内推荐智谱AI的GLM-4.7）
• 第4步：通讯平台暂时跳过 → 选择 skip for now
• 第5步：Skills 选择 NO（后续可随时添加）
• 第6步：Hooks 选择 skip for now
4.1 如何获取智谱AI的API Key
• 1. 访问 https://open.bigmodel.cn/ 注册智谱AI账号
• 2. 进入控制台 → API Keys → 创建新的API Key
• 3. 复制保存Key（格式：xxxxxxxx.xxxxxxxx）
• 4. 在onboard配置中填入Key和Base URL
五、启动与使用
需要打开两个终端窗口：
窗口A——启动网关服务：
openclaw gateway
窗口B——打开控制台：
openclaw dashboard
浏览器会自动打开 http://localhost:3000 ，这就是你的OpenClaw控制台！
5.1 Windows一键启动脚本
为了方便，可以创建一个 start_openclaw.bat 文件：
@echo offecho Starting OpenClaw Gateway...start cmd /k "openclaw gateway"timeout /t 3echo Starting Dashboard...openclaw dashboard
六、常用操作
操作 | 命令 |
启动网关 | openclaw gateway |
打开控制台 | openclaw dashboard |
切换模型 | openclaw model |
安装技能 | openclaw skills install <技能名> |
查看状态 | openclaw status |
重启服务 | openclaw restart |
查看日志 | openclaw logs |
七、常见问题
问题 | 解决方法 |
安装时权限不足 | macOS/Linux加sudo，Windows用管理员终端 |
sharp模块安装失败 | macOS先 brew install vips，或加 SHARP_IGNORE_GLOBAL_LIBVIPS=1 |
模型调用失败 | 检查API Key、Base URL、模型名，执行 openclaw restart |
端口被占用 | 修改端口：openclaw gateway --port 3001 |
网关启动后无法访问 | 检查防火墙设置，确认3000端口已开放 |
八、进阶玩法
• 连接微信/飞书：通过 openclaw channel 命令配置消息通道，实现手机远程操控
• 安装技能：通过 openclaw skills 浏览和安装社区技能（如K8s管理、React开发等）
• 定时任务：让OpenClaw主动帮你做事（如每天早上检查服务器状态）
• 多模型切换：随时在GPT-5、Claude、GLM之间切换，找到最佳模型
— — — — — — — — — —
本文发布于2026年6月4日。OpenClaw更新频繁，建议关注官方文档 docs.openclaw.ai 获取最新信息。