🤖

Clawdbot 中文教程

← 返回首页

安装指南

本教程将带你一步步安装 Clawdbot。如果你是第一次使用，不用担心，我们准备了最详细的说明。你可以根据你的操作系统选择对应的方法。

📋 安装前准备 - 系统要求

Node.js: 版本 18 或更高（推荐使用 v22 以获得最佳性能）

npm: 版本 9 或更高（通常随 Node.js 自动安装）

内存: 建议 2GB 以上可用内存

磁盘空间: 至少 500MB 可用空间

网络: 能够访问 npm 包管理器和 AI 服务商 API

💡 小提示： 不确定系统环境？运行 node -v 和 npm -v 查看版本

🐧 Linux 系统安装

适用于 Ubuntu、Debian、CentOS 等主流 Linux 发行版

步骤 1：安装 Node.js

我们推荐使用 NodeSource 官方仓库来安装最新版的 Node.js，这样可以确保获得稳定的版本：

# 1. 添加 NodeSource 官方仓库（安装 Node.js 22.x 版本）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 2. 使用 apt 安装 Node.js 和 npm
sudo apt-get install -y nodejs

# 3. 验证安装
node -v  # 应该显示 v22.x.x
npm -v   # 应该显示 npm 版本

如果你是 CentOS 或 RedHat 系统，使用 yum 替代 apt-get

步骤 2：安装 Clawdbot

使用 npm 全局安装 Clawdbot，这样可以在任何目录下使用命令：

# 全局安装 Clawdbot
sudo npm install -g clawdbot

# 验证安装
clawdbot --version

步骤 3：初始化工作空间

创建一个目录作为你的 Clawdbot 工作空间，然后初始化配置：

# 创建工作目录
mkdir ~/my-clawdbot
cd ~/my-clawdbot

# 初始化配置文件
clawdbot init

# 这将在当前目录创建必要的配置文件：
# - AGENTS.md    # Agent 配置（AI 模型、人设等）
# - MEMORY.md    # 长期记忆文件
# - TOOLS.md     # 工具配置
# - SOUL.md      # 个性化设置

步骤 4：配置 AI 模型

编辑 AGENTS.md 文件，设置你要使用的 AI 模型和 API Key：

# 编辑 AGENTS.md
nano AGENTS.md

# 在文件中设置默认模型（示例使用 OpenAI）
# 添加以下内容：
default_model: openai/gpt-4

# 然后设置环境变量
export OPENAI_API_KEY="sk-your-api-key-here"

# 永久保存到 ~/.bashrc 或 ~/.zshrc
echo 'export OPENAI_API_KEY="sk-your-api-key-here"' >> ~/.bashrc

 macOS 系统安装

适用于 macOS 10.15 及以上版本

步骤 1：安装 Homebrew（如果没有）

Homebrew 是 macOS 上最流行的包管理器：

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步骤 2：使用 Homebrew 安装 Node.js

# 安装 Node.js
brew install node

# 验证安装
node -v
npm -v

步骤 3：安装和初始化 Clawdbot

# 安装 Clawdbot
npm install -g clawdbot

# 创建工作目录
mkdir ~/my-clawdbot
cd ~/my-clawdbot

# 初始化配置
clawdbot init

🪟 Windows 系统安装

适用于 Windows 10/11 系统

步骤 1：下载并安装 Node.js

访问 nodejs.org 下载最新的 LTS 版本，运行安装程序（记得勾选"Add to PATH"选项）

步骤 2：安装 Clawdbot

# 打开 PowerShell 或命令提示符，运行：
npm install -g clawdbot

# 验证安装
clawdbot --version

步骤 3：创建工作目录并初始化

# 创建目录（在你想放置的位置）
mkdir C:\Users\你的用户名\my-clawdbot
cd C:\Users\你的用户名\my-clawdbot

# 初始化配置
clawdbot init

🐳 Docker 安装（推荐服务器部署）

Docker 方式安装最简单，适合没有复杂环境配置需求的场景

步骤 1：拉取官方镜像

docker pull clawdbot/clawdbot:latest

步骤 2：创建数据卷（持久化配置）

# 创建数据目录
mkdir -p ~/.clawdbot/data

步骤 3：运行容器

docker run -d \
  --name clawdbot \
  -v ~/.clawdbot/data:/root/.clawdbot \
  -e OPENAI_API_KEY="your-api-key" \
  clawdbot/clawdbot:latest

提示：需要时可以用 docker exec -it clawdbot bash 进入容器进行配置

✅ 验证安装

完成安装后，运行以下命令验证：

# 查看 Clawdbot 版本
clawdbot --version

# 查看帮助信息
clawdbot --help

🎉 安装完成！下一步？

恭喜你成功安装了 Clawdbot！现在可以开始配置聊天平台，或者直接查看快速入门指南了解如何使用

前往快速入门 →配置聊天平台 →