安装 Clawdbot

前提条件

安装 Clawdbot 前，请确保你有：

• Python 3.10 或更高版本
• Git（用于克隆仓库）
• Anthropic API 密钥（在此获取）
• pip（Python 包管理器）

安装方法

macOS

1. 安装 Python（如果尚未安装）：

   # 使用 Homebrew
   brew install python@3.11

2. 克隆仓库：

   git clone https://github.com/polvoazul/clawdbot.git
   cd clawdbot

3. 创建虚拟环境：

   python3 -m venv venv
   source venv/bin/activate

4. 安装依赖：

   pip install -r requirements.txt

5. 配置环境：

   cp .env.example .env
   # 用你的 Anthropic API 密钥编辑 .env

Linux

1. 安装 Python：

   # Ubuntu/Debian
   sudo apt update
   sudo apt install python3.11 python3.11-venv python3-pip
   
   # Fedora
   sudo dnf install python3.11
   
   # Arch
   sudo pacman -S python

2. 克隆仓库：

   git clone https://github.com/polvoazul/clawdbot.git
   cd clawdbot

3. 创建虚拟环境：

   python3 -m venv venv
   source venv/bin/activate

4. 安装依赖：

   pip install -r requirements.txt

5. 配置环境：

   cp .env.example .env
   nano .env  # 编辑添加 API 密钥

Docker

1. 拉取镜像：

   docker pull ghcr.io/polvoazul/clawdbot:latest

2. 创建配置目录：

   mkdir -p ~/.clawdbot

3. 创建 .env 文件：

   cat > ~/.clawdbot/.env << EOF
   ANTHROPIC_API_KEY=your_api_key_here
   EOF

4. 运行容器：

   docker run -d \
     --name clawdbot \
     -v ~/.clawdbot:/app/config \
     --env-file ~/.clawdbot/.env \
     ghcr.io/polvoazul/clawdbot:latest

配置

环境变量

创建或编辑 .env 文件：

.env

# 必需：你的 Anthropic API 密钥
ANTHROPIC_API_KEY=sk-ant-xxxxx

# 可选：模型选择（默认：claude-sonnet-4-20250514）
CLAUDE_MODEL=claude-sonnet-4-20250514

# 可选：日志级别
LOG_LEVEL=INFO

# 频道特定设置（按需添加）
# TELEGRAM_BOT_TOKEN=your_token
# DISCORD_BOT_TOKEN=your_token

验证安装

测试安装：

# 激活虚拟环境
source venv/bin/activate

# 运行测试命令
python -m clawdbot --version

你应该能看到版本号输出。

下一步

安装完成后，继续：

• 快速开始: 运行你的第一次对话
• WhatsApp 设置: 连接 WhatsApp
• Telegram 设置: 连接 Telegram