共计 4889 个字符，预计需要花费 13 分钟才能阅读完成。
# OpenClaw 安装教程：从零开始部署你的 AI 助手
> |
—
## 前言
在上一篇文章中，我们了解了 OpenClaw 是什么以及它能做什么。今天，让我们动手把它安装到你的电脑上，开启 AI 助手之旅！
本教程将涵盖 Linux/macOS/Windows 三大平台，确保你能顺利完成部署。
—
## 一、环境要求
在开始之前，请确保你的系统满足以下条件：
### 1.1 硬件要求
| 项目 | 最低配置 | 推荐配置 |
|——|———|———|
| CPU | 2 核 | 4 核 + |
| 内存 | 4GB | 8GB+ |
| 磁盘 | 5GB | 20GB+ |
| 网络 | 能访问互联网 | 稳定宽带 |
### 1.2 软件要求
必需：
– Node.js 18.x 或更高版本
– npm 9.x 或更高版本（随 Node.js 安装）
– Git（用于克隆仓库和版本控制）
可选但推荐：
– pnpm：更快的包管理器
– Docker：容器化部署（进阶用法）
### 1.3 检查现有环境
打开终端，运行以下命令检查：
“bash
检查 Node.js 版本
node –version
应显示 v18.x.x 或更高
# 检查 npm 版本
npm –version
应显示 9.x.x 或更高
# 检查 Git
git –version
应显示 git version x.x.x
“
> 【截图位置 1】
> 展示终端中运行版本检查命令的输出结果
—
## 二、安装 Node.js
如果你的系统还没有 Node.js，请根据操作系统选择安装方式：
### 2.1 Linux (Ubuntu/Debian)
“bash
方法 1：使用 NodeSource（推荐）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash –
sudo apt-get install -y nodejs
# 方法 2：使用 nvm（可管理多版本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
“
### 2.2 macOS
“bash
方法 1：使用 Homebrew（推荐）
brew install node@20
# 方法 2：使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc
nvm install 20
nvm use 20
“
### 2.3 Windows
“bash
方法 1：使用安装包
访问 https://nodejs.org/ 下载 LTS 版本安装包
# 方法 2：使用 winget
winget install OpenJS.NodeJS.LTS
# 方法 3：使用 Chocolatey
choco install nodejs-lts
# 方法 4：使用 nvm-windows
访问 https://github.com/coreybutler/nvm-windows/releases 下载安装
nvm install 20
nvm use 20
“
> 【截图位置 2】
> 展示 Node.js 官网下载页面，标注 LTS 版本下载按钮
—
## 三、安装 OpenClaw
### 3.1 使用 npm 安装（推荐）
这是最简单的安装方式：
“bash
全局安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw –version
“
### 3.2 使用 pnpm 安装
如果你使用 pnpm（更快、更节省空间）：
“bash
先安装 pnpm
npm install -g pnpm
# 安装 OpenClaw
pnpm add -g openclaw
# 验证
openclaw –version
“
### 3.3 从源码安装（开发者）
如果你想参与开发或使用最新特性：
“bash
克隆仓库
git clone https://github.com/openclaw-ai/openclaw.git
cd openclaw
# 安装依赖
npm install
# 构建项目
npm run build
# 链接到全局
npm link
“
> 【截图位置 3】
> 展示终端中成功安装 OpenClaw 后显示的版本号
—
## 四、初始化配置
### 4.1 运行初始化向导
首次使用需要运行初始化命令：
“bash
openclaw init
“
这个命令会：
~/.openclaw/）### 4.2 配置目录结构
初始化后，你会看到以下目录结构：
“
~/.openclaw/
├── .env # 环境变量（API 密钥等）
├── config.json # 主配置文件
├── workspace/ # 工作空间
│ ├── AGENTS.md # 工作空间说明
│ ├── SOUL.md # AI 身份定义
│ ├── USER.md # 用户信息
│ ├── TOOLS.md # 工具配置
│ └── memory/ # 记忆存储
│ └── 2026-03-11.md
└── skills/ # 技能目录
“
### 4.3 配置 API 密钥
OpenClaw 需要大语言模型的 API 密钥才能工作。编辑 ~/.openclaw/.env 文件：
“bash
使用你喜欢的编辑器
nano ~/.openclaw/.env
“
添加以下内容：
“env
模型配置（选择一个）
OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
# 或使用其他兼容的模型服务
例如：智谱 AI、通义千问等
GLM_API_KEY=your-glm-api-key-here
“
> 【截图位置 4】
> 展示 .env 配置文件的内容，API 密钥部分打码处理
—
## 五、启动 OpenClaw
### 5.1 前台启动（测试用）
“bash
启动交互式会话
openclaw start
# 或指定模型
openclaw start –model gpt-4
“
你会看到类似输出：
“
✓ OpenClaw v2026.3.7 启动成功
✓ 工作空间: /root/.openclaw/workspace
✓ 模型: gpt-4
✓ 已加载 11 个技能
🤖 OpenClaw 已就绪，输入消息开始对话 …
“
### 5.2 后台服务模式（生产环境）
如果你需要长期运行（如接入企业微信）：
“bash
启动 Gateway 服务
openclaw gateway start
# 查看状态
openclaw gateway status
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
“
> 【截图位置 5】
> 展示 OpenClaw 启动成功后的终端界面，显示欢迎信息和就绪状态
—
## 六、安装常用技能
OpenClaw 的能力通过技能扩展。以下是一些推荐的入门技能：
### 6.1 使用技能市场
“bash
搜索技能
openclaw skill search <关键词>
# 安装技能
openclaw skill install <技能名>
# 列出已安装技能
openclaw skill list
“
### 6.2 推荐技能清单
| 技能名 | 用途 | 安装命令 |
|——–|——|———|
| tavily-search | AI 优化搜索 | openclaw skill install tavily-search |
| github | GitHub 操作 | openclaw skill install github |
| weather | 天气查询 | openclaw skill install weather |
| summarize | 内容总结 | openclaw skill install summarize |
| smooth-browser | 浏览器自动化 | openclaw skill install smooth-browser |
> 【截图位置 6】
> 展示技能列表界面，显示已安装技能的名称、版本和描述
—
## 七、配置多渠道接入
### 7.1 企业微信接入
1. 创建企业微信应用
– 登录企业微信管理后台
– 创建应用，获取 AgentId 和 Secret
2. 配置 OpenClaw
编辑 ~/.openclaw/.env：
“env
WECOM_CORP_ID=your-corp-id
WECOM_AGENT_ID=your-agent-id
WECOM_SECRET=your-secret
“
3. 启动服务
“bash
openclaw gateway start
“
### 7.2 Discord 接入
1. 创建 Discord Bot
– 访问 Discord Developer Portal
– 创建应用，获取 Bot Token
2. 配置 OpenClaw
“env
DISCORD_BOT_TOKEN=your-bot-token
“
### 7.3 Web 界面
OpenClaw 自带 Web 界面，启动后访问：
“
http://localhost:3000
“
> 【截图位置 7】
> 展示 OpenClaw Web 界面，显示对话窗口和功能按钮
—
## 八、常见问题排查
### 8.1 安装失败
问题：npm install 报错 EACCES
“bash
原因：权限不足
解决方案：修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix ‘~/.npm-global’
echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc
source ~/.bashrc
# 重新安装
npm install -g openclaw
“
问题：网络超时
“bash
使用国内镜像
npm config set registry https://registry.npmmirror.com
# 或使用代理
npm config set proxy http://127.0.0.1:7890
“
### 8.2 启动失败
问题：找不到模块
“bash
重新安装依赖
cd ~/.openclaw
npm install
“
问题：API 密钥无效
“bash
检查配置
cat ~/.openclaw/.env
# 验证密钥有效性
curl https://api.openai.com/v1/models \
-H “Authorization: Bearer $OPENAI_API_KEY”
“
### 8.3 技能安装失败
问题：技能安装后无法使用
“bash
检查技能状态
openclaw skill list
# 重新加载配置
openclaw gateway restart
“
—
## 九、安全建议
### 9.1 API 密钥保护
“bash
设置文件权限
chmod 600 ~/.openclaw/.env
# 不要将 .env 文件提交到 Git
echo “.env” >> ~/.gitignore
“
### 9.2 限制访问范围
“bash
在 config.json 中配置允许的操作
{
“security”: {
“allowFileWrite”: true,
“allowCommandExec”: false,
“allowedCommands”: [“git”, “npm”]
}
}
“
### 9.3 定期更新
“bash
更新 OpenClaw
npm update -g openclaw
# 更新技能
openclaw skill update –all
“
—
## 十、验证安装
运行以下命令确认一切正常：
“bash
检查版本
openclaw –version
# 检查配置
openclaw config show
# 测试对话
openclaw chat “ 你好，请介绍一下你自己 ”
“
如果以上命令都能正常执行，恭喜你，OpenClaw 安装成功！
—
## 总结
让我们回顾一下安装步骤：
1. ✅ 检查环境要求
现在你已经拥有了一个功能完整的 AI 助手！
—
## 下期预告
下一篇文章，我们将深入探讨如何高效地与 OpenClaw 对话：
– 10 个实用提问技巧
– 常用命令速查
– 效率提升秘诀
敬请期待：《OpenClaw 第一次对话：新手必看的 10 个技巧》
—
> 关于作者
> 点小安，AI 安全领域实践者，专注于探索 AI 工具的实际应用与最佳实践。
> 网站：[点滴安全](https://www.dripsafe.cn)
—
相关文章：
– [OpenClaw 是什么？5 分钟快速了解这个 AI 助手神器](./openclaw- 入门 -1.md)
– [OpenClaw 第一次对话：新手必看的 10 个技巧](./openclaw- 入门 -3.md)
—
