在 5 小时内构建您的个人 AI 基础设施
将您的计算机转变为自主 AI 指挥中心。本指南将带您完成安装、配置和首次自动化任务——无需系统管理员经验。
开始之前：了解您正在构建的内容
大多数 AI 安装指南将软件视为黑盒：下载、安装、忘记。Clawdbot 不同，因为您不是在安装应用程序——您是在建立基础设施。可以将其想象为设置自己的私人电子邮件服务器，但不是管理消息，而是编排一个能够真正控制您数字环境的 AI。
本指南解释了每个步骤做什么以及为什么重要。理解架构使故障排除变得直观，定制变得简单。
5 小时后您将拥有什么
- 在您的设备上持续运行的 Gateway 服务，协调所有 AI 活动
- 连接到您选择的 AI 模型（Claude、GPT-4 或免费的本地 Ollama）
- 至少一个与您的 AI 链接的消息渠道（WhatsApp、Telegram 等）
- 演示真正系统控制的功能自动化
- 了解如何扩展、定制和排除设置故障
先决条件：您真正需要什么
硬件要求
- • 操作系统：macOS 11+、Linux（Ubuntu 20.04+、Debian 11+）或 Windows 10+（带 WSL2）
- • 内存：至少 2GB 可用（推荐 4GB 以实现更流畅的操作）
- • 磁盘空间：核心安装需要 500MB，外加 AI 模型缓存空间
- • 网络：稳定的互联网连接用于 AI API 调用（除非使用本地 Ollama）
软件依赖
Clawdbot 需要 Node.js 22 或更高版本。为什么是这个特定版本？较新的 Node.js 版本包含了 Clawdbot 实时通信所依赖的关键性能改进和安全补丁。安装程序通常会处理此问题，但手动安装需要预先安装。
AI 模型访问（选择一个）
成本效益分析：您应该选择哪个 AI 模型？
选项 1：Anthropic Claude（推荐给大多数用户）
选项 2：OpenAI GPT-4
选项 3：本地 Ollama 模型（完全免费）
步骤 1：下载适合您平台的正确软件包
Clawdbot 分发特定于平台的安装程序，捆绑了所需的一切。为什么有多种格式？不同的操作系统处理后台服务的方式不同——安装程序会正确配置这些。
macOS 安装
下载 DMG 安装程序以获得最简单的体验：
安装程序的功能：
- • 将 Gateway 服务安装到 /Applications/Clawdbot.app
- • 在 ~/.clawdbot/ 创建配置目录
- • 配置自动化功能的系统权限
- • 可选择设置启动时自动启动（推荐）
Linux 安装
通过 npm（推荐）或 Docker 安装：
然后初始化配置：
Windows 安装 (WSL2)
Windows 需要 WSL2 (Windows 子系统 for Linux)。如果未安装：
Windows 原生支持
原生 Windows 支持（不使用 WSL2）是实验性的。WSL2 提供了与 Node.js 系统集成和 shell 命令执行更好的兼容性。
步骤 2：安装并启动 Gateway
Gateway 是 Clawdbot 的核心——一个持久化服务，管理消息平台、AI 模型和您的系统之间的所有通信。将其视为中枢神经系统：渠道将消息发送到 Gateway，Gateway 将它们路由到适当的 AI 模型，接收响应，然后将它们发送回来。
macOS：打开下载的 DMG 并将 Clawdbot 拖到应用程序。启动它。
Linux/WSL：npm 安装后，启动 Gateway：
验证它是否正在运行：
您应该看到：Gateway is running on ws://127.0.0.1:18789
幕后发生的事情
Gateway 在端口 18789（可自定义）上创建 WebSocket 服务器。这个仅限本地的服务器接受来自以下的连接：
- • 渠道插件（WhatsApp、Telegram 等）转发用户消息
- • 节点客户端（移动应用、Web 界面）用于直接交互
- • 扩展功能的技能和工具
除非您明确配置远程访问（在高级指南中介绍），否则所有通信都保留在您的机器上。
步骤 3：连接您的 AI 大脑
Gateway 运行后，它需要 AI 模型来生成响应。此步骤配置您将使用的模型以及验证 API 访问。
打开配置文件：
或手动编辑 ~/.clawdbot/clawdbot.json。添加您的 API 凭据：
步骤 4：链接您的通信渠道
渠道是您与 AI 交互的方式——移动设备上的 WhatsApp、桌面设备上的 Telegram、团队协作的 Discord。每个渠道独立连接到 Gateway，Clawdbot 在所有渠道之间维护统一的对话历史。
连接您的第一个渠道：WhatsApp 示例
这将启动交互式设置：
1. 您的终端中出现二维码
2. 在手机上打开 WhatsApp → 设置 → 已链接的设备 → 链接设备
3. 扫描二维码
4. Clawdbot 确认连接并保存会话凭据
WhatsApp 账户安全
WhatsApp 的服务条款禁止使用机器人。虽然 Clawdbot 实现了速率限制和类人行为模式，但我们建议使用辅助电话号码而不是您的主要个人 WhatsApp 账户。考虑：
- - 获取 Google Voice 或类似的虚拟号码
- - 使用您不主动使用的旧 SIM 卡
- - 尝试 Telegram（官方支持机器人）
步骤 5：执行您的第一个自主任务
一切配置完成后，让我们验证 Clawdbot 能够真正控制您的系统——而不仅仅是响应文本。
测试系统集成
应该发生什么：
1. Clawdbot 通过渠道接收您的消息
2. Gateway 将其路由到您配置的 AI 模型
3. AI 生成包括 shell 命令的响应计划
4. Clawdbot 执行：echo "..." > ~/Documents/test.txt
5. 您收到确认：“已创建 test.txt，包含...”
6. 检查您的文档文件夹——文件存在
您刚刚演示了真正的 AI 自动化
Clawdbot 与 ChatGPT 或 Siri 的区别：它不仅仅告诉您如何创建文件——它实际上创建了它。这种能力扩展到：
- 管理您的日历并发送会议邀请
- 监控日志文件并提醒您错误
- 从 API 提取数据并生成报告
- 通过 Home Assistant 控制智能家居设备
- 运行开发工作流程（测试、构建、部署）
接下来构建什么
1. 从 ClawdHub 安装技能
技能是预构建的自动化模块。浏览市场：
- • google-calendar：自然语言日历管理
- • home-assistant：智能家居控制集成
- • github-assistant：仓库管理和 PR 审查
- • daily-briefing：早晨日历、天气、新闻摘要
在 hub.clawdbot.ai 浏览数百个额外技能
2. 创建自定义自动化
技能只是带有 SKILL.md 文件的文件夹。创建您自己的：
完整指南：docs.clawdbot.ai/skills/creating
3. 配置主动行为
与传统 AI 不同，Clawdbot 可以主动联系。启用心跳监控：
现在 Clawdbot 将主动向您发送早晨简报，无需询问。
4. 部署到云端（可选）
在笔记本电脑上运行 Clawdbot 可以工作，但云部署确保 24/7 可用性。可用指南：
逐步云部署指南：docs.clawdbot.ai/deployment
常见问题和解决方案
Gateway 无法启动
症状：Error: EADDRINUSE: address already in use
原因：另一个进程正在使用端口 18789。
AI 模型返回错误
症状：“API authentication failed”或“Invalid model specified”
原因：配置中的 API 密钥或模型名称不正确。
WhatsApp 频繁断开连接
症状：每隔几天需要重新进行二维码身份验证。
原因：会话凭据未正确持久化。
您现在正在运行自己的 AI 基础设施
您构建的不仅仅是一个聊天机器人——它是一个个人自动化平台，将前沿 AI 模型的智能与本地系统控制的能力相结合。与限制 AI 能力的 云服务不同，您的 Clawdbot 安装可以访问您的数字环境，就像您一样。
这种权力伴随着责任：Clawdbot 可以执行您批准的任何命令。沙箱和权限系统可以防止意外损坏，但最终您是在授予 AI 有意义的控制权。从简单的自动化开始，了解如何做出决策，并在建立信任时逐步扩展功能。