Clawdbot是一款本地部署、系统控制、全渠道沟通的个人AI小助手，支持Telegram/WhatsApp远程操控电脑执行文件整理、系统监控、日程管理等任务，所有数据保留在用户设备上确保隐私安全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
一、Clawdbot是什么？
欢迎来到Clawdbot的世界！简单来说，Clawdbot就是一款为您量身打造的个人AI小助手。它的核心魅力在于 “本地部署、系统控制、全渠道沟通” 三大特点。您可以通过手机上的Telegram或WhatsApp等聊天软件，直接指挥家里或云端的电脑完成各种任务，比如自动整理杂乱的下载文件夹、一键部署新的代码项目等。最重要的是，所有数据都保存在您自己的设备上，隐私安全得到最高保障。
• GitHub 星标： 2026年1月已突破 4万+
• 支持平台： Windows / Mac / Linux / 云服务器
二、开始前的准备清单
在正式开始安装前，我们先来核对一下“装备”是否齐全，这能让后续过程事半功倍。
1. 硬件配置
基础运行需要至少4核CPU和8GB内存。如果您想让它运行更强大的本地AI模型（例如 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：您需要一个大模型API的密钥，可以是国外的Claude/GPT-4，也可以是国内的智谱GLM-4.5或阿里云百炼等。
• 聊天平台 Token：这是让Clawdbot和你对话的“钥匙”。新手最推荐使用的是 Telegram Bot Token，获取简单，配置方便。
三、第一步：获取Clawdbot
资源类型： 源码仓库
路径： GitHub
说明： 官方代码所在地，适合喜欢自己动手的朋友。
资源类型： 一键安装脚本 (Mac/Linux)
路径： 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的配置文件。接下来，请打开这个.env文件，填入 机器人名字、服务端口、默认AI模型 等关键信息。
3. 启动！
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为例）
安装完成后，我们需要让Clawdbot能接收到您的指令。
1. 在Telegram里搜索一个叫 `@BotFather` 的官方机器人，向它发送 `/newbot` 指令，按照提示操作，就能轻松获得一长串 API Token。
2. 回到您刚刚创建的 `.env` 配置文件，找到 `TELEGRAM_BOT_TOKEN=` 这一行，把获取到的Token粘贴到引号里。
3. 重启服务以应用新配置，Docker用户执行：`docker-compose restart`。
4. 去Telegram里找到你创建的机器人，给它发个 `/start`，它就正式开始为您服务了！
六、第四步：上手实战！
现在，让我们通过几个实例，感受一下Clawdbot的强大之处。
场景： 文件整理
你发送： “把下载文件夹里的PDF和图片给我分类整理好”
效果： Clawdbot会迅速在下载文件夹中创建“PDF文档”、“图片收藏”等子文件夹，并将对应文件移动进去，让您的文件夹瞬间井井有条。
场景： 系统监控
你发送： “帮我盯着服务器的CPU，要是使用率超过80%就告诉我”
效果： Clawdbot会化身7x24小时的监控员，一旦CPU负载过高，会立即通过Telegram向您发送警报。
场景： 日程管理
你发送： “提醒我，明天下午两点要开会，并把这个日程加到我的日历里”
效果： 它会自动调用系统日历功能（需安装插件），为您创建日程并设置提醒，成为您可靠的私人秘书。
七、新手常见问题与避坑指南 (FAQ)
• 安装失败了？别慌，先检查一下你的Docker和Node.js版本是否符合前面提到的最低要求。
• 机器人不理我？大概率是网络问题。如果您在国内，请检查 `.env` 文件里的 `PROXY_URL` 代理设置是否正确填写。
• 【极其重要的安全提示】 Clawdbot拥有直接操作您电脑的权限，能力越大，风险也越大。为了您的数据安全，强烈建议您将Clawdbot安装在非主力、无敏感数据的闲置设备或云服务器上，避免潜在风险。
