Clawdbot 完整安装教学：2026 年最火的开源AI 个人助理

导读：为什么大家都在谈论Clawdbot？本文将从下载到设定，手把手教你打造最强开源AI。赶快上车，跟上这波AI 技术革命！

Clawdbot 在2026 年初席卷硅谷甚至整个科技圈，GitHub 星数在短短数天内从5,000 飙升至20,000 以上。

这款由奥地利开发者Peter Steinberger（PSPDFKit 创办人）打造的开源项目，让使用者能在自有硬件上运行24/7 全天候AI 助理，并可透过WhatsApp、Telegram、Discord、Slack 等日常通讯软件进行互动。

与传统AI 聊天机器人的根本差异在于：Clawdbot 具备“执行能力”。它不只回答问题，还能实际操作浏览器、管理档案、发送邮件、预约行程，甚至在你睡觉时主动完成任务。

系统需求与前置准备

Clawdbot 对硬件要求相当宽松。基本聊天功能仅需2GB 内存与双核处理器；若要启用浏览器自动化或多工作流程，建议配备4GB 以上内存与20GB 硬盘空间。

它支持的平台包括macOS、Linux，以及通过WSL2 运行的Windows 环境。

官方建议使用Node.js 22 或更新版本。

快速安装步骤

开启终端执行以下指令：

curl -fsSL https://clawd.bot/install.sh | bash

安装程序会自动检测系统环境、安装必要依赖，并启动安装向导。

iwr -useb https://clawd.bot/install.ps1 | iex

若需要在CI/CD 环境或自动化脚本中使用：

curl -fsSL https://clawd.bot/install.sh | bash -s -- --no-onboard

安装完成后，执行exec bash重新载入环境变数，再手动执行引导设定：

clawdbot onboard --install-daemon

引导设置向导详解

执行clawdbot onboard后，系统会逐步引导完成以下配置：

Gateway 模式选择

• Local：适合单机使用，推荐首次安装选择
• Remote：适合云端VPS 部署

AI 模型认证

• Anthropic API Key（推荐）：前往console.anthropic.com取得
• OpenAI API Key
• OAuth（Claude Pro/Max 订阅用户）
• OpenAI Codex 订阅

模型选择

• anthropic/claude-opus-4-5：最高品质，适合复杂推理任务
• anthropic/claude-sonnet-4-5：平衡效能与成本

通讯频道设定

支持的平台包括WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Google Chat、Microsoft Teams、Matrix 等。以WhatsApp 为例，系统会显示二维码，使用手机扫描即可完成连结。

启动Gateway 服务

clawdbot gateway --port 18789 --verbose

若要让服务在背景持续运行：

# 安裝 systemd 服務（Linux）

sudo loginctl enable-linger "$USER"systemctl --user daemon-reloadsystemctl --user enable --now clawdbot-gateway.service

确认服务状态：

clawdbot statusclawdbot healthclawdbot gateway status

云端VPS 部署指南

本文以DigitalOcean 为例，选择Ubuntu 24.04 LTS、2GB RAM、1 vCPU 的Droplet：

ssh root@YOUR_IPadduser clawd && usermod -aG sudo clawd && su - clawdcurl -fsSL https://clawd.bot/install.sh | bashexec bashclawdbot setup --wizardclawdbot gateway --bind lan --port 18789

通过SSH 通道存取本地端：

ssh -L 18789:127.0.0.1:18789 clawd@YOUR_IP

开启http://127.0.0.1:18789即可存取控制界面。

其他云端平台选项包括Hetzner、Linode、Railway、Render 等，部分提供免费额度供测试使用。

社群热议的核心应用场景

Clawdbot 能够自动处理数千封邮件，包括退订电子报、分类归档、草拟回覆等。每天早上八点，它会主动发送包含行事历、待办事项、天气、市场动态的每日摘要。

在社区使用者分享的案例中，有人让Clawdbot 自动搜寻机票、填写表单、完成订位。当OpenTable 预约失败时，它甚至会通过ElevenLabs 语音技术打电话给餐厅完成预约。

一位Reddit 用户展示了使用Clawdbot 在30 分钟内将完整的CUDA 后端移植到AMD ROCm 的案例，这项成果被认为显著削弱了NVIDIA 的CUDA 技术护城河。

Claude Code的深度整合让开发者能够通过聊天界面发送错误信息、取得修正建议，并直接套用到程序代码中。

通过Skills 扩展系统，Clawdbot 可连接Philips Hue 灯具、智能恒温器、音乐播放系统。使用者甚至能让它生成图片、创建引导冥想音乐、转录语音信息等。

Skills 技能扩充系统

ClawdHub是Clawdbot 的技能注册平台，提供现成的扩充功能：

• Gmail 分类与管理
• Todoist 任务整合
• Notion 同步
• Hetzner 基础设施管理
• 其它交易API 连接

技术用户可使用JavaScript 或TypeScript 撰写自定义技能，非技术用户则可直接浏览并一键安装。

安全性考量与最佳实践

Clawdbot 预设采用配对机制防止未授权存取。未知发送者会收到六位数配对码，需由管理员批准后才能与机器人互动：

clawdbot pairing approve whatsapp 123456

官方文件提到，若未妥善配置安全防护，恶意网页内容或邮件可能通过Prompt Injection 系统泄漏敏感信息。建议措施包括如下：

1. 使用专用硬件运行，避免在日常工作电脑上部署
2. 启用Docker 沙箱模式执行工具
3. 为不同风险等级建立独立Agent
4. 定期备份~/.clawdbot文件夹

成本结构分析

Clawdbot 本身完全免费开源（MIT 授权），主要成本来自AI 大模型的API 使用费。一般用户每月支出约USD 15-40，与ChatGPT Plus 或Claude Pro 订阅费用相近，但功能更为强大。

重度使用者（如一周消耗1.8 亿tokens）可能面临USD 200 以上的帐单。

硬件方面，Mac Mini 的一次性投资约USD 599，但透过VPS 部署每月仅需USD 3-10。

Raspberry Pi 是最经济的选项，电费成本几乎可忽略。

为什么Mac Mini 销量暴增？

社群观察到一个有趣现象：2026 年一月的Mac Mini 销量达到黑色星期五等级。原因在于多数Clawdbot 教学都推荐使用Mac Mini 作为专用主机，理由包括：

• 低功耗与静音运作
• 对macOS 原生应用的深度整合（Shortcuts、AppleScript、Messages、Photos、Health）
• Apple Silicon 的统一内存架构优势

Google DeepMind 的产品经理Logan Kilpatrick也公开表示购入Mac Mini 用于运行Clawdbot。但如前所述，这并非技术必要——任何符合基本规格的硬件都能胜任。

常见问题排查

1）clawdbot 指令找不到

执行exec bash或重新开启终端机，让PATH 环境变量生效。

2）WhatsApp 连线失败

重新执行clawdbot channels login并扫描新的二维码。

3）Gateway 无法启动

检查Port 18789 是否被占用，或使用clawdbot doctor进行诊断。

4）更新至最新版本

clawdbot update --channel stableclawdbot doctor

扩展资源

• 官方文档（https://docs.clawd.bot/）
• GitHub （https://github.com/clawdbot/clawdbot）

Clawdbot 代表了AI Agent技术从概念走向实用的重要里程碑。

创业者Alex Finn表示，他将Clawdbot部署于本地，用于内容脚本、电子报与竞品研究等流程自动化；研发人员Shruti Mishra则指出，透过权限与工具配置，Clawdbot可让大型语言模型不只生成文字，而是进一步执行档案处理与网络爬虫操作等实际行动。

目前，Clawdbot更接近一个开发者框架，还没有到达消费级产品的能力。但它证明了个人AI 助理并不必依赖云端服务商，使用者能够完全掌控自己的资料与自动化工作流程。对于愿意投入时间配置的使用者而言，这可能是2026 年最值得关注的生产力工具。