在2026年，开源个人AI助理领域最火爆的项目非Clawdbot莫属。它是一个完全自托管的AI助手，能通过Telegram、WhatsApp、Discord、Slack、iMessage等日常聊天工具与你互动，不仅能聊天，还能执行真实任务：浏览网页、运行代码、自动化操作、管理日历、处理邮件、甚至自我扩展技能。Clawdbot的最大亮点在于隐私完全可控——所有数据留在你的设备上，只需API密钥调用大模型（如Claude、GPT等），无需依赖云服务。
本文将手把手教你从零开始安装并运行Clawdbot，适用于macOS、Linux和Windows（通过WSL2）用户。即使你是新手，也能轻松上手。整个过程大约30-60分钟，跟着操作即可拥有属于自己的“AI私人助理”。
文章导航
一、Clawdbot的核心优势与功能
Clawdbot为什么能在2026年爆火？简单来说，它实现了“有手的Claude”——不仅仅是聊天机器人，而是真正能干活的AI代理。
主要功能包括：
- 多渠道接入：支持Telegram、WhatsApp、Discord、Slack、iMessage、Signal等多平台统一管理。
- 工具调用：浏览器自动化、Shell命令、代码执行、文件读写、日历管理等。
- 自我进化：通过“Skills”机制，缺少功能时它能自己编写代码并安装。
- 主动交互：可以主动给你发消息提醒事项。
- 隐私优先：本地运行，所有对话和数据不上传云端。
- 跨设备支持：手机、电脑、服务器均可部署。
| 功能类别 | 具体能力 | 使用场景示例 |
| 通信渠道 | Telegram、WhatsApp、 Discord等 | 手机直接命令AI处理任务 |
| 工具集成 | 浏览器控制、代码执行、文件管理 | 自动订机票、写脚本、整理邮件 |
| 模型支持 | Anthropic Claude、OpenAI、Groq等 | 根据预算选择高智能或高速模型 |
| 扩展性 | Skills自定义技能 | 边用边进化，添加专属功能 |
二、前置准备：系统要求与注意事项
在开始安装前，确保你的环境满足要求：
- 操作系统：macOS 14+（最友好）、Linux（Ubuntu/Debian推荐）、Windows（需WSL2）。
- 硬件要求：普通笔记本即可，建议至少8GB内存；服务器部署推荐2vCPU+4GB内存。
- 软件要求：Node.js ≥ v22（安装脚本会自动处理）。
- API密钥：至少准备一个大模型API（如Anthropic Claude推荐Opus/Sonnet）。
- 风险提醒：Clawdbot拥有完整系统权限（可读写文件、运行Shell），请在隔离环境或虚拟机先测试。API调用费用较高，使用Claude Opus一天可能几十到几百元。
强烈建议：首次部署在本地电脑测试，熟悉后再上服务器。
步骤一：一键安装Clawdbot
Clawdbot提供最简单的一键安装脚本，自动检测环境、安装Node.js和依赖。
- 打开终端（macOS/Linux用Terminal，Windows用PowerShell或WSL终端）。
- 执行以下命令：
bash
curl -fsSL https://clawd.bot/install.sh | bash - 该脚本会自动安装最新版本Clawdbot。
- 如果卡住或网络问题，可手动下载脚本后运行。
- Windows用户推荐使用WSL2（Ubuntu），脚本同样适用。
- 安装完成后，终端会提示重开终端或执行：
bash
exec bash - 验证安装：
bash
clawdbot --version
显示版本号即成功。
这一步通常只需2-5分钟，脚本会把Clawdbot安装到全局环境。
步骤二：Onboarding初始化配置（最关键一步）
安装完成后，运行配置向导：
clawdbot onboard --install-daemon–install-daemon参数会自动设置后台服务（macOS用launchd，Linux用systemd），实现开机自启。
向导会逐步引导你配置，以下是详细操作：
- 风险提醒：会出现“Yes/No”确认，理解风险后用方向键选Yes，空格确认。
- Onboard模式：推荐选择“Quick Start”，适合新手。
- 模型提供商：推荐Anthropic（Claude系列，代码能力最强）。
- 认证方式：选择“Paste setup token”或直接输入API Key。
- 模型选择：Claude-3.5-Sonnet（性价比高）或Opus（最强智能）。
- 其他选项：OpenAI、Groq（更快更便宜）、本地模型（需额外配置）。
| 模型提供商 | 推荐模型 | 优点 | 日费用估算（中等使用） |
| Anthropic | Claude-3.5-Sonnet | 智能高、工具调用强 | 10-50元 |
| Anthropic | Claude Opus | 最强推理能力 | 50-200元 |
| OpenAI | GPT-4o | 生态丰富 | 20-100元 |
| Groq | Llama3-70B | 速度极快、便宜 | 5-30元 |
1、渠道配置（Channels）：
- 推荐先选Telegram（最简单）。
- 其他选项：WhatsApp（需扫码）、Discord、Slack、iMessage（macOS专用）等。
- 可多选，同时开启多个渠道。
2、Telegram渠道详细配置：
- 在Telegram搜索@BotFather，发送/newbot创建机器人。
- 取名并获取API Token。
- 回到Clawdbot向导，粘贴Token。
- 配置完成后，Clawdbot会自动连接。
3、Skills配置：新手建议“Skip for now”，后期可通过社区安装。
4、其他API配置（可选）：Google Calendar、Email、浏览器等，可跳过先用基础功能。
5、Hooks与高级选项：新手全选“Skip for now”。
配置完成后，向导会显示成功信息，Gateway服务自动启动。
步骤三：启动Gateway并首次连接
1、检查服务状态：bash
clawdbot gateway status
2、网页面板测试：
- 打开浏览器访问 http://localhost:18789 （或clawdbot dashboard命令自动打开）。
- 这里可以看到对话界面，直接聊天测试。
3、Telegram连接：
- 在Telegram搜索你的Bot名称，发送/start。
- Bot会回复一个Pairing Code（配对码）。
- 复制代码回到终端，粘贴并回车。
配对成功！现在你可以在Telegram直接与Clawdbot对话。
4、首次测试对话：
- 在Telegram输入：“你好，请介绍一下自己。”
- 或实战：“帮我查一下明天北京的天气。”
如果一切正常，Clawdbot会智能回复并可执行任务。
步骤四：高级使用与优化
部署成功只是开始，下面教你玩出花样。
1. 添加更多渠道
- WhatsApp：运行clawdbot channels login whatsapp，扫码登录。
- Discord：创建Bot应用，填Token。
- 多渠道统一管理，所有消息汇总到同一个AI大脑。
2. 安装Skills扩展功能
Clawdbot支持社区Skills，安装后能力暴增。
– 访问官方Skills中心或GitHub搜索“clawdbot skills”。
– 示例：在对话中让它“安装天气查询Skill”——它会自己搜索并安装。
3. 云端部署（VPS运行24/7）
本地电脑关机就停？部署到VPS实现全天在线。
- 推荐DigitalOcean、Hetzner等，Ubuntu 22.04系统。
- SSH登录后运行相同一键脚本。
- 用Tailscale或Cloudflare Tunnel暴露端口，实现手机远程访问。
4. 性能与费用优化
- 调低思考深度（配置中选Medium）。
- 使用Sonnet代替Opus节省费用。
- 设置渠道白名单，避免误触发。
| 优化项 | 操作方法 | 效果 |
| 降低费用 | 模型选Sonnet + 限制思考深度 | 日费用降50%以上 |
| 提升响应速度 | 使用Groq提供商 | 几乎实时回复 |
| 增强安全性 | 启用沙箱模式（Docker部署） | 隔离高危操作 |
三、常见问题排查
1、命令找不到clawdbot：
- 重开终端或运行exec bash。
- 检查PATH环境变量。
2、Gateway不启动：
- 查看日志：clawdbot gateway –verbose。
- Linux检查systemctl –user status clawdbot。
3、Telegram连接失败：
- 确认Token正确，BotFather未禁用。
- 检查网络是否能访问Telegram。
4、API调用失败：
- 用clawdbot doctor检查连通性。
- 确认API Key有效且有余额。
5、权限问题（macOS）：
系统偏好设置→隐私与安全，授权屏幕录制、文件访问等。
6、吃Token太猛：
- 初始测试阶段正常，后期熟练后大幅降低。
- 设置任务优先级，避免复杂长链推理。
四、安全注意事项与最佳实践
Clawdbot强大但危险：
- 永远不要在root用户下运行。
- 首次测试用虚拟机或隔离账号。
- 定期备份~/.clawdbot配置目录。
- 敏感操作前确认AI回复。
- 加入官方Discord社区获取最新安全更新。
开启你的AI私人助理时代
恭喜你！通过以上步骤，你已经成功从零安装并运行了Clawdbot。现在，它就是你的24小时在线工作伙伴——在Telegram里一句话，就能让它帮你订票、写代码、整理日程。
后续可以探索更多玩法：自定义Skills、接入智能家居、多代理协作等。Clawdbot还在快速迭代，建议定期运行clawdbot update更新。
掌握Clawdbot，你就掌握了2026年最前沿的个人AI生产力工具。开始你的第一条指令吧：“Clawdbot，帮我规划明天的工作日程！”
延展阅读：
