Clawdbot是一款支持本地化部署、系统级任务执行与全渠道消息互通的开源个人AI智能体，需4核CPU/8GB内存及Node.js≥22.0、Docker≥20.10，推荐Docker一键部署并配置Telegram Bot Token实现快速启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
Clawdbot 全流程安装教程与配置方法
一、Clawdbot是什么？
Clawdbot 是一款为个人用户设计的开源AI智能体（Personal AI Agent），其核心功能在于实现了 本地化部署、系统级任务执行与全渠道消息互通。您可以轻松通过Telegram、WhatsApp等日常沟通工具向它下达指令，让它自动为您完成整理文件、部署代码、同步日历等繁琐任务。最关键的是，所有数据均存储在您自己的设备上，确保隐私安全无虞。
• GitHub 星标： 2026年1月已突破 4万+
• 支持平台： Windows / Mac / Linux / 云服务器
二、安装前的准备工作
1. 硬件配置核对
为了保证Clawdbot流畅运行，推荐您的设备至少拥有4核CPU和8GB内存。如果您计划运行本地大语言模型（如Llama 3），那么一块具备 8GB以上显存的独立显卡 将是必要的。
2. 软件环境与系统权限
类别： 运行环境
必备组件： Node.js
版本要求： ≥ 22.0.0
获取路径： Node.js 官网
类别： 部署工具
必备组件： Docker (推荐)
版本要求： ≥ 20.10.0
获取路径： Docker 官网
类别： 系统要求
必备组件： Windows
版本要求： Win 10 2004+ / 11
获取路径： 需启用 WSL2 (Ubuntu 22.04)
类别： 系统要求
必备组件： macOS
版本要求： 12+
获取路径： 原生支持
3. 关键凭证准备（至少选择一种）
• AI 模型 API Key：例如 Claude、GPT-4 (需网络代理)、智谱 GLM-4.5、或阿里云百炼等平台的API密钥。
• 聊天平台 Token：例如 Telegram Bot Token (新手首选)、WhatsApp Token、Discord Token 或 Slack Token。
三、获取Clawdbot安装文件
资源类型： 源码仓库
路径： GitHub
说明： 官方最新开源代码，可通过git clone获取。
资源类型： 一键安装 (Unix)
路径： curl -fsSL https://clawd.bot/install.sh | bash
说明： 此脚本适用于 Mac 和 Linux 系统，能够快速完成安装。
资源类型： 插件市场
路径： Clawdhub
说明： 官方提供的技能插件库，用于扩展Clawdbot的功能。
四、核心安装流程详解
方式一：Docker 部署（跨系统通用，推荐新手）
1. 环境准备：请确保您已正确安装并启动了Docker服务。对于Windows用户，必须先启用WSL2功能。
2. 拉取源码与配置：打开您的终端，依次执行以下命令来获取项目文件并创建配置文件。
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
cp .env.example .env
# 接下来，请使用文本编辑器打开.env文件，修改其中 CLAWS_BOT_NAME, CLAWS_SERVER_PORT, CLAWS_DEFAULT_MODEL 这几个必填项。
3. 启动容器：在项目根目录下，执行以下命令来构建并启动Docker容器。
docker-compose up -d --build
4. 验证安装：打开浏览器，访问 http://localhost:8080，如果看到Clawdbot的欢迎页面，则代表安装成功。
方式二：一键脚本安装（Mac/Linux 原生）
如果您使用的是Mac或Linux系统，可以直接在终端中运行以下命令完成所有安装步骤。
curl -fsSL https://clawd.bot/install.sh | bash
clawdbot onboard --install-daemon
五、配置Telegram机器人
1. 在Telegram应用中搜索官方机器人 @BotFather，向它发送 /newbot 指令，根据提示创建您自己的机器人，并获取一串 API Token。
2. 打开项目中的 .env 配置文件，找到 TELEGRAM_BOT_TOKEN 这一行，将您获取到的密钥填入引号中。
3. 如果您使用Docker部署，请执行 docker-compose restart 命令来重启服务，使配置生效。
4. 现在，在Telegram中找到您的机器人，向它发送 /start 指令即可激活并开始使用。
六、基础使用指令演示
功能类型： 文件管理
指令示例： “帮我整理一下下载文件夹，把里面的PDF和图片按类型分好类”
说明： Clawdbot会自动扫描指定目录并创建子文件夹进行归类。
功能类型： 系统监控
指令示例： “监控一下服务器的CPU使用率，如果超过80%就立刻通知我”
说明： 这是一个主动告警功能，能帮您随时了解系统状态。
功能类型： 日程同步
指令示例： “把明天下午2点的会议加到我的系统日历里”
说明： 此功能需要您从插件市场安装对应的日历插件。
七、安装配置FAQ
• 安装失败怎么办？请优先检查您的Docker版本是否过低，或者Node.js版本是否满足22.0.0以上的要求。
• 发送指令后机器人没反应？请检查.env配置文件中的 PROXY_URL 是否正确设置。在国内网络环境下，连接Telegram等服务通常需要配置网络代理。
• 安全提示： Clawdbot被设计为拥有系统级的操作权限，这赋予了它强大的能力，但也带来了安全风险。强烈建议您将其运行在闲置设备或专用的云服务器上，避免在存储有个人敏感数据的主力电脑上进行高权限操作。
