OpenClaw 入门第二课:安装详细教程

你好，我是陈询，又见面了，感恩遇见
🎯 课程目标：掌握OpenClaw的多种安装方式，30分钟内完成部署
⏱️ 预计学习时间：30分钟 | ⭐⭐⭐ 难度等级：初级

📑 本课目录

1️⃣ 安装前准备

2️⃣ 安装方式对比

3️⃣ 方式一：云服务器一键安装（推荐新手）

4️⃣ 方式二：Docker安装

5️⃣ 方式三：本地安装

6️⃣ 配置AI模型

7️⃣ 安装验证

8️⃣ 常见问题

9️⃣ 本课小结

1️⃣ 安装前准备

💻 硬件要求

配置项	最低要求	推荐配置
CPU	2核	4核+
内存	2GB	4GB+
硬盘	10GB可用	40GB+
网络	能访问互联网	稳定宽带

⚠️ 重要提示：内存必须2GB以上，否则运行会卡顿！

🔧 软件要求

✅ 服务器/电脑

✅ 大模型API Key（下面教你免费申请）

✅ IM账号（飞书/钉钉/企业微信等，可选）

🔑 免费申请API Key（2分钟）

服务商	申请地址	免费额度	推荐指数
阿里云百炼	bailian.console.aliyun.com	有免费额度	⭐⭐⭐⭐⭐
百度千帆	qianfan.baidu.com	有免费额度	⭐⭐⭐⭐
智谱AI	open.bigmodel.cn	有免费额度	⭐⭐⭐⭐
Claude中转站	aicodemirror.com	按需付费	⭐⭐⭐⭐

阿里云百炼申请步骤：

1️⃣ 打开 bailian.console.aliyun.com

2️⃣ 登录阿里云账号

3️⃣ 点击"密钥管理"

4️⃣ 点击"创建API-Key"

5️⃣ 复制Key备用

2️⃣ 安装方式对比

安装方式	难度	耗时	费用	适用场景	推荐指数
云服务器一键安装	⭐⭐	5分钟	¥60/月起	新手推荐、7x24运行	⭐⭐⭐⭐⭐
Docker安装	⭐⭐⭐	10分钟	免费	有Docker基础的用户	⭐⭐⭐⭐
本地安装	⭐⭐⭐⭐	30分钟	免费	本地使用、数据敏感	⭐⭐⭐

💡 新手建议：强烈推荐云服务器一键安装，最简单最稳定！

3️⃣ 方式一：云服务器一键安装（推荐新手）

☁️ 支持的平台

• 阿里云轻量应用服务器

• 腾讯云轻量应用服务器

• 京东云轻量云主机

• 百度云轻量应用服务器

• 火山引擎云服务器

🚀 阿里云一键安装步骤

步骤1：访问阿里云OpenClaw专题页

打开：https://www.aliyun.com/activity/ecs/clawdbot

点击【一键购买并部署】

步骤2：选购轻量应用服务器

配置选择：

• 镜像：OpenClaw(Moltbot)镜像

• 实例：内存必须2GiB及以上

• 地域：默认美国（弗吉尼亚）

• ⚠️ 注意：中国内地域（除香港）联网搜索功能受限
• 建议选择：中国香港、新加坡、美国

• 时长：根据预算选择（1年性价比最高）

点击【立即购买】→【去支付】

步骤3：配置OpenClaw

购买完成后：

1️⃣ 进入轻量应用服务器控制台

2️⃣ 找到实例，点击【应用详情】

3️⃣ 放行端口：点击【一键放通】18789端口

4️⃣ 配置API-Key：

• 点击【一键配置】
• 输入百炼API-Key
• 点击【执行命令】写入配置

5️⃣ 生成Token：

• 点击【执行命令】
• 生成访问OpenClaw的Token

6️⃣ 访问OpenClaw：

• 点击【打开网站页面】
• 进入OpenClaw对话界面

🎉 完成！ 现在可以开始使用了！

🚀 腾讯云一键安装步骤

步骤1：访问腾讯云OpenClaw专题页

打开：https://curl.qcloud.com/eWZtc3Q

步骤2：选购轻量应用服务器

配置选择：

• 应用模板：OpenClaw(Clawdbot)

• 地域：法兰克福（或其他海外地域）

• 配置：4GB内存（至少4G，否则会卡）

• 登录方式：密码登录

• 密码：设置自定义密码（务必记住）

点击【立即购买】→【去支付】

步骤3：登录服务器配置

1️⃣ 进入轻量应用服务器控制台

2️⃣ 点击【登录】

3️⃣ 选择【免密连接】→【登录】

4️⃣ 看到命令行界面，准备执行安装命令

步骤4：执行安装命令

在终端粘贴命令：

openclaw onboard --install-daemon

按回车执行

步骤5：跟着向导配置

向导会一步步询问，按以下选择：

• 选择 "QuickStart"

• 选择 "Reset"

• 选择 "Full reset"

• 选择 "Google"

• 选择 "飞书"（或其他IM工具）

步骤6：创建飞书机器人（如选择飞书）

1️⃣ 打开飞书开放平台：https://open.feishu.cn/app

2️⃣ 点击【创建企业自建应用】

3️⃣ 输入应用名称（如"OpenClaw助手"）

4️⃣ 进入【凭证与基础信息】页面

5️⃣ 复制 App ID 和 App Secret

6️⃣ 粘贴到OpenClaw向导对应位置

步骤7：配置AI模型

继续跟着向导：

• 选择 "Feishu"

• 选择 "Open"

• 选择 "No"

• 勾选后面四个选项（用空格键勾选）

• 选择 "Restart"

• 选择 "Hatch in TUI"

步骤8：配置中转站API

OpenClaw需要连接AI模型才能工作：

1️⃣ 注册中转站：https://www.aicodemirror.com

2️⃣ 充值（按需充值，很便宜）

3️⃣ 创建API密钥：

• 点击【API密钥】
• 点击【创建API密钥】
• 渠道选择"三方逆向"
• 复制保存API密钥

4️⃣ 修改OpenClaw配置文件：

• 进入服务器文件管理
• 找到 .openclaw/openclaw.json
• 添加模型配置（参考官方文档）

🎉 完成！ 现在可以通过飞书与OpenClaw对话了！

4️⃣ 方式二：Docker安装

🐳 安装Docker

Windows/macOS：

1️⃣ 访问 docker.com/products/docker-desktop

2️⃣ 下载并安装Docker Desktop

3️⃣ 启动Docker Desktop

Linux（Ubuntu/CentOS）：

# Ubuntu/Debiansudo apt-get updatesudo apt-get install -y docker.io docker-composesudo systemctl start docker# CentOSsudo yum install -y docker docker-composesudo systemctl start docker

🚀 一键启动OpenClaw

# 创建目录mkdir -p ~/openclaw && cd ~/openclaw# 创建docker-compose文件cat > docker-compose.yml << 'EOF'version: '3.8'services:  openclaw:    image: openclaw/openclaw:latest    container_name: openclaw    ports:      - "3000:3000"    volumes:      - ./data:/app/data      - ./.env:/app/.env    restart: unless-stoppedEOF# 创建环境配置文件cat > .env << 'EOF'# 填入你的API KeyDASHSCOPE_API_KEY=sk-你的API密钥DEFAULT_MODEL=dashscope/qwen-turboEOF# 启动！docker-compose up -d# 查看日志docker-compose logs -f

✅ 验证安装

打开浏览器访问：http://localhost:3000

看到OpenClaw界面即表示成功！🎉

5️⃣ 方式三：本地安装

🪟 Windows本地安装

步骤1：安装Node.js

1️⃣ 访问 nodejs.org 下载LTS版本

2️⃣ 双击安装，一路Next

3️⃣ 验证安装：

node --version  # 显示 v18.x 或更高npm --version   # 显示 9.x 或更高

步骤2：安装OpenClaw

# 创建目录mkdir C:\openclaw && cd C:\openclaw# 下载代码git clone https://github.com/openclaw/openclaw.gitcd openclaw# 安装依赖npm install# 构建项目npm run build

步骤3：配置API Key

# 复制配置文件copy .env.example .env# 编辑.env文件，填入你的API Key# DASHSCOPE_API_KEY=sk-你的实际API密钥

步骤4：启动OpenClaw

# 窗口1：启动Gatewaynpm run start:gateway# 窗口2：启动Agent（新开CMD窗口）cd C:\openclaw\openclawnpm run start:agent

🍎 macOS本地安装

# 安装Homebrew/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 安装Node.jsbrew install node# 安装OpenClawmkdir -p ~/openclaw && cd ~/openclawgit clone https://github.com/openclaw/openclaw.gitcd openclawnpm install && npm run build# 配置cp .env.example .env# 编辑.env文件，填入API Key# 启动npm run start:gateway  # 终端1npm run start:agent    # 终端2

6️⃣ 配置AI模型

🔧 配置阿里云百炼

在 .env 文件中添加：

DASHSCOPE_API_KEY=sk-你的百炼API密钥DEFAULT_MODEL=dashscope/qwen-max

🔧 配置百度千帆

QIANFAN_API_KEY=你的KeyQIANFAN_SECRET_KEY=你的Secret

🔧 配置Claude（通过中转站）

# 在配置文件中添加CLAUDE_API_KEY=sk-你的中转站KeyCLAUDE_BASE_URL=https://api.aicodemirror.com/api/claudecode

7️⃣ 安装验证

✅ 验证清单

检查项	验证方法	预期结果
Web界面	访问 localhost:3000 或服务器IP:18789	看到OpenClaw界面
Gateway运行	查看启动日志	显示"Gateway started"
Agent运行	查看启动日志	显示"Agent connected"
API Key有效	发送测试消息	AI正常回复

🔍 常用命令

# 检查端口lsof -i :3000# 查看进程ps aux | grep openclaw# 查看日志tail -f ~/.openclaw/logs/agent.log# 重启服务docker-compose restart# 停止服务docker-compose down

8️⃣ 常见问题

❌ 问题1：安装失败，权限不足

错误信息：

npm ERR! code EACCES

解决方法：

sudochown -R $(whoami) ~/.npm

❌ 问题2：端口被占用

错误信息：

Error: Port 3000 is already in use

解决方法：

# 查找占用端口的进程lsof -i :3000# 杀死进程kill -9 <PID># 或修改端口export WEB_PORT=3001

❌ 问题3：内存不足，运行卡顿

现象：OpenClaw响应慢，经常崩溃

解决方法：

• 升级服务器配置到4GB内存

• 关闭不必要的服务

• 使用Swap分区扩展内存

❌ 问题4：API Key无效

解决步骤：

1️⃣ 检查 .env 文件中的API Key是否正确

2️⃣ 确认API Key是否过期

3️⃣ 检查账户余额是否充足

4️⃣ 确认网络可以访问API服务

❌ 问题5：无法访问Web界面

解决方法：

1️⃣ 检查防火墙是否放行端口

2️⃣ 检查安全组规则

3️⃣ 确认服务已启动

4️⃣ 查看日志排查错误

9️⃣ 本课小结

✅ 核心知识点

3种安装方式

• 云服务器一键安装（5分钟，推荐新手）

• Docker安装（10分钟）

• 本地安装（30分钟）

关键配置

• 内存必须2GB以上

• 需要大模型API Key

• 防火墙放行对应端口

推荐方案

云服务器一键安装最简单最稳定！

📚 下节预告

第三课：OpenClaw常用技能安装

• 什么是Skill

• 必装Skill推荐

• Skill安装实战

🎉 恭喜！你已经成功安装了OpenClaw，下节课我们将学习如何扩展它的能力！

💬 安装遇到问题？

欢迎在评论区留言，我会一一解答！

👍 觉得有用？

别忘了点赞、喜欢、转发三连！谢谢你

另外，如果你也身在职场，想探索副业，给自己未来更多选择的可能性，欢迎加V【crx168】，围观我的副业日常呀，送你一份我自己付费参与的小龙虾训练营实战详细教程