从零开始养龙虾,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 获取最新信息。
夜雨聆风