OpenClaw 安装完整指南(2026 最新版)
📋 前置要求
- 操作系统: Linux / macOS / Windows
- Node.js: v18.0 或更高版本
- 内存: 至少 2GB 可用内存
- 存储: 至少 500MB 可用空间
🚀 快速安装
一键安装(推荐)
# 自动安装 Node.js 和所有依赖
curl -fsSL https://clawd.org.cn/install.sh | bash
安装完成后验证:
openclaw --version
📦 手动安装
1. 安装 Node.js
# macOS
brew install node
# Linux (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
2. 安装 OpenClaw
npm install -g @openclaw/core
3. 验证安装
openclaw --version
⚙️ 基础配置
1. 初始化配置
openclaw init
系统会引导你完成:选择 AI 模型、输入 API Key、选择消息渠道、配置存储路径。
2. 配置文件说明
{
"model": {
"provider": "anthropic",
"apiKey": "sk-...",
"model": "claude-sonnet-4-20250514"
},
"channels": {
"feishu": {
"enabled": true,
"appId": "...",
"appSecret": "..."
}
}
}
🔌 安装第一个技能
# 访问技能市场
openclaw skills browse
# 安装热门技能
openclaw skills install searxng
推荐新手技能: searxng (搜索), code (编程), web_search (网络搜索)
💬 配置消息渠道
飞书集成
openclaw channels config feishu
1. 登录 飞书开放平台 创建应用
2. 获取 App ID 和 App Secret
3. 在 OpenClaw 配置中填入
Telegram 集成
openclaw channels config telegram
联系 @BotFather 创建机器人,获取 Bot Token
🐛 常见问题
1. 安装失败
# 清理 npm 缓存
npm cache clean --force
# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com
# 重新安装
npm install -g @openclaw/core
2. API Key 无效
- 检查 API Key 是否正确
- 确认账户余额充足
- 检查网络连接