📋 前置要求
系统要求
- 操作系统: macOS 12+ (Apple Silicon 或 Intel)
- Node.js: v18+ (推荐 v20+)
- npm: v9+
- Git: 用于克隆仓库和管理技能
- 存储空间: 至少 2GB 可用空间
检查环境
# 检查 Node.js 版本
node –version
# 检查 npm 版本
npm –version
# 检查 Git
git –version
🚀 第一步：安装 OpenClaw
方法一：npm 全局安装（推荐）
npm install -g openclaw
方法二：从源码安装
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
npm install
# 全局链接
npm link
验证安装
openclaw –version
openclaw help
⚙️ 第二步：初始化配置
创建配置目录
# OpenClaw 默认配置目录
mkdir -p ~/.openclaw/workspace
mkdir -p ~/.openclaw/skills
mkdir -p ~/.openclaw/memory
初始化工作区
cd ~/.openclaw/workspace
openclaw init
核心配置文件
创建 ~/.openclaw/config.json：
{
\”workspace\”: \”/Users/wei/.openclaw/workspace\”,
\”model\”: {
\”default\”: \”qwen-portal/coder-model\”,
\”provider\”: \”qwen-portal\”
},
\”channels\”: {
\”webchat\”: {
\”enabled\”: true,
\”port\”: 3000
}
},
\”skills\”: {
\”enabled\”: [\”github\”, \”weather\”, \”healthcheck\”]
},
\”security\”: {
\”riskLevel\”: \”standard\”,
\”requireConfirmation\”: [\”external\”, \”destructive\”]
}
}
🔌 第三步：配置通信渠道
WebChat（内置）
# 启动 WebChat 服务
openclaw gateway start
访问：http://localhost:3000
Telegram Bot
# 1. 通过 @BotFather 创建 bot，获取 TOKEN
# 2. 配置 channels.json
创建 ~/.openclaw/channels/telegram.json：
{
\”provider\”: \”telegram\”,
\”token\”: \”YOUR_BOT_TOKEN\”,
\”webhook\”: false,
\”polling\”: true
}
Discord Bot
# 1. 在 Discord Developer Portal 创建应用
# 2. 获取 Bot Token
# 3. 邀请 bot 到服务器
创建 ~/.openclaw/channels/discord.json：
{
\”provider\”: \”discord\”,
\”token\”: \”YOUR_BOT_TOKEN\”,
\”guildId\”: \”YOUR_SERVER_ID\”
}
