
准备工作
系统要求
Claw 支持主流操作系统,但对硬件和软件环境有一定要求:
最低配置:
CPU: 2核心
内存: 4GB RAM
存储: 10GB 可用空间
操作系统: Linux (Ubuntu 20.04+), macOS (12+), Windows 10/11 (with WSL2)
CPU: 4核心或更多
内存: 8GB RAM 或更多
存储: 20GB SSD
稳定的网络连接(用于 API 调用)
必备软件安装
Node.js 环境
openClaw 需要 Node.js 18 或更高版本。推荐使用 LTS 版本:
# 检查当前 Node.js 版本node --version# 使用 nvm 安装(推荐)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashnvm install 20nvm use 20# 验证安装node --version # 应显示 v20.x.xnpm --version # 应显示 10.x.x
若你使用的是 Windows,可以从 Node.js 官网 下载安装包,或使用 nvm-windows。
Docker 安装(推荐)
Docker 是运行 Claw 最简单的方式,避免了复杂的依赖配置:
# macOS 和 Windows: 下载 Docker Desktop# https://www.docker.com/products/docker-desktop# Linux (Ubuntu) 安装curl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.sh# 验证安装docker --versiondocker compose version# 配置用户权限(Linux)sudo usermod -aG docker $USER# 需要重新登录以生效
生产环境推荐使用 Docker Compose 部署,便于统一管理服务配置与实现数据持久化。
Git 版本控制
# 安装 Git(若没安装)# macOSbrew install git# Ubuntu/Debiansudo apt-get updatesudo apt-get install git# 验证安装git --version
准备 LLM API 密钥
openClaw 的核心功能基于大语言模型 API 实现,需至少准备一个 LLM 服务商的 API 密钥方可正常使用。
OpenAI API
访问 OpenAI Platform
注册并完成身份验证
在 Dashboard 中创建 API Key
设置使用限额和预算提醒(推荐)
# 测试 API 密钥curl https://api.openai.com/v1/models \-H "Authorization: Bearer YOUR_API_KEY"
Anthropic Claude API
访问 Anthropic Console
申请 API 访问权限
生成 API Key
记录你的配额限制
Claude 3.5 Sonnet 在编码和推理任务上表现优异,适合作为 Claw 的主力模型。
本地模型(可选)
若对调用成本或数据隐私有所顾虑,可选择接入本地部署的大模型:
# 安装 Ollamacurl -fsSL https://ollama.com/install.sh | sh# 拉取模型ollama pull qwen3.5:9b# 验证运行ollama run qwen3.5:9b "Hello!"
本地部署模型的核心优势在于零 API 调用成本与全本地的数据隐私安全,但相应的硬件门槛更高,运行 7B 级别模型建议配置至少 16GB 内存。
消息平台账号准备
根据你的需求,准备以下平台的机器人账号:
Telegram Bot
在 Telegram 中找到 @BotFather 发送 /newbot创建新机器人按提示设置机器人名称和用户名 保存 Bot Token(格式: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
# 测试 Bot Tokencurl "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe"
Discord Bot(可选)
访问 Discord Developer Portal 创建新的 Application 在 Bot 选项卡中创建 Bot 启用必要的 Intents(Message Content Intent 等) 复制 Bot Token
环境变量
创建一个 .env 文件作为配置模板:
# LLM API KeysOPENAI_API_KEY=sk-...ANTHROPIC_API_KEY=sk-ant-...# Message ChannelsTELEGRAM_BOT_TOKEN=123456:ABC@@@DISCORD_BOT_TOKEN=MTk4...# Database (可选)DATABASE_URL=postgresql://user:pass@localhost:5432/claw# Other SettingsNODE_ENV=developmentLOG_LEVEL=info
安全提示: 永远不要将 .env 文件提交到 Git 仓库。确保 .gitignore 中包含 .env。
检查清单
进入下一章节前,请确保已完成以下准备工作:
安装 Node.js 18+ 或 Docker
安装 Git 并配置基本信息
获得至少一个 LLM API 密钥并测试可用
创建至少一个消息平台机器人账号
准备好 .env 配置文件模板
确保网络可以访问相关 API 服务
当所有准备工作就绪后,即可开始进行 openClaw 的安装部署了。
夜雨聆风