
准备工作
在开始使用 Claw 之前,你需要准备好开发环境和必要的账号资源。本章将指导你完成所有前置准备工作。
系统要求
Claw 支持主流操作系统,但对硬件和软件环境有一定要求:
最低配置:
- CPU: 2核心
- 内存: 4GB RAM
- 存储: 10GB 可用空间
- 操作系统: Linux (Ubuntu 20.04+), macOS (12+), Windows 10/11 (with WSL2)
推荐配置:
- CPU: 4核心或更多
- 内存: 8GB RAM 或更多
- 存储: 20GB SSD
- 稳定的网络连接(用于 API 调用)
对于生产环境部署,建议使用至少 8GB 内存和 4 核 CPU,以确保多 Agent 并发执行时的稳定性。如果你计划使用浏览器自动化功能,内存需求会更高(建议 16GB)。
必备软件安装
Node.js 环境
Claw 需要 Node.js 18 或更高版本。推荐使用 LTS 版本:
`# 检查当前 Node.js 版本
node --version
使用 nvm 安装(推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20
验证安装
node --version # 应显示 v20.x.x
npm --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.sh
sudo sh get-docker.sh
验证安装
docker --version
docker compose version
配置用户权限(Linux)
sudo usermod -aG docker $USER
需要重新登录以生效
`
对于生产环境,建议使用 Docker Compose 进行部署,这样可以更方便地管理配置和数据持久化。
Git 版本控制
`# 安装 Git(如果尚未安装)
macOS
brew install git
Ubuntu/Debian
sudo apt-get update
sudo apt-get install git
验证安装
git --version
`
LLM API 密钥准备
Claw 的核心功能依赖于大语言模型 API。你需要至少准备一个 LLM 提供商的 API 密钥。
OpenAI API
- 访问 OpenAI Platform
- 注册并完成身份验证
- 在 Dashboard 中创建 API Key
- 设置使用限额和预算提醒(推荐)
# 测试 API 密钥 curl https://api.openai.com/v1/models \ -H "Authorization: Bearer YOUR_API_KEY"
成本估算: GPT-4 Turbo 的成本约为 $0.01/1K tokens (输入) + $0.03/1K tokens (输出)。一般的对话任务,每天 100 次交互大约花费 $2-5。
Anthropic Claude API
- 访问 Anthropic Console
- 申请 API 访问权限
- 生成 API Key
- 记录你的配额限制
Claude 3.5 Sonnet 在编码和推理任务上表现优异,适合作为 Claw 的主力模型。
本地模型(可选)
如果你担心成本或隐私问题,可以使用本地模型:
`# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
拉取模型
ollama pull llama3.1:8b
ollama pull qwen2.5-coder:7b
验证运行
ollama run llama3.1:8b "Hello!"
`
本地模型的优势是零 API 成本和完全的数据隐私,但需要更强的硬件配置(至少 16GB RAM 用于 7B 模型)。
消息平台账号
根据你的需求,准备以下平台的机器人账号:
Telegram Bot
- 在 Telegram 中找到 @BotFather
- 发送
/newbot 创建新机器人
- 按提示设置机器人名称和用户名
- 保存 Bot Token(格式:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
# 测试 Bot Token curl "https://api.telegram.org/bot/getMe"
Discord Bot(可选)
- 访问 Discord Developer Portal
- 创建新的 Application
- 在 Bot 选项卡中创建 Bot
- 启用必要的 Intents(Message Content Intent 等)
- 复制 Bot Token
环境变量模板
创建一个 .env 文件作为配置模板:
`# LLM API Keys
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
Message Channels
TELEGRAM_BOT_TOKEN=123456789:ABC...
DISCORD_BOT_TOKEN=MTk4...
Database (可选)
DATABASE_URL=postgresql://user:pass@localhost:5432/claw
Other Settings
NODE_ENV=development
LOG_LEVEL=info
`
安全提示: 永远不要将 .env 文件提交到 Git 仓库。确保 .gitignore 中包含 .env。
检查清单
在进入下一章之前,确认你已完成:
完成这些准备后,你就可以开始安装 Claw 了。