Clawdbot: 您的个人人工智能助手平台 🦞

概述

Clawdbot 是一个创新的开源个人人工智能助手平台，它彻底改变了用户与人工智能的交互方式。与传统的基于云的助手不同，Clawdbot 完全在您的本地硬件上运行，同时无缝集成您日常使用的消息应用程序。

Clawdbot 由 Peter Steinberger 创建，并由活跃的社区维护，它充当了强大的语言模型（Claude、GPT、Gemini）与您日常沟通渠道之间的桥梁，创造了一种真正个性化的人工智能体验，尊重隐私并提供前所未有的控制权。

🚀 核心功能

多平台集成

• 消息平台: WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Microsoft Teams、Google Chat
• 扩展渠道: BlueBubbles、Matrix、Zalo、WebChat
• 移动支持: iOS 和 Android 伴侣应用程序
• 桌面: 具有语音唤醒功能的 macOS 菜单栏应用程序

本地优先架构

• 网关系统: 管理所有连接和操作的单一控制平面
• 自托管: 完全在您的硬件上运行（Mac、PC、Raspberry Pi 或云服务器）
• 注重隐私: 您的数据永远不会离开您的控制范围
• 持久内存: 以 Markdown 文件形式本地存储的长期上下文保留

高级功能

• 语音集成: 使用 ElevenLabs TTS 进行始终在线的语音识别
• 实时画布: 具有 A2UI 的代理驱动的可视化工作区
• 浏览器控制: 自动网页导航和表单填写
• 系统访问: 文件管理、Shell 命令、Git 操作
• 智能家居: 与飞利浦 Hue 等设备集成
• 主动操作: 计划任务、心跳监控、自动化工作流

🏗️ 技术架构

以网关为中心的设计

WhatsApp / Telegram / Discord / iMessage (+ 插件)
                    │
                    ▼
    ┌───────────────────────────────┐
    │         网关               │
    │      (控制平面)          │
    │   ws://127.0.0.1:18789        │
    └──────────────┬────────────────┘
                   │
    ├─ AI 代理 (RPC)
    ├─ CLI (clawdbot 命令)
    ├─ WebChat UI
    ├─ macOS 应用
    └─ iOS / Android 节点

关键组件

1. 网关进程

• 管理所有消息连接的长期运行守护进程
• 用于客户端通信的 WebSocket 控制平面
• 会话路由和隔离
• 实时事件处理

2. 代理系统

• 多代理路由功能
• 基于工作区的操作（~clawd 目录）
• 用于系统访问的工具集成层
• 用于安全执行的沙盒选项

3. 技能框架

• 模块化 TypeScript/JavaScript 扩展
• 社区驱动的技能市场（ClawdHub）
• 通过 AI 生成的技能实现自我改进的能力
• 用于自定义集成的插件架构

4. 安全模型

• 用于未知联系人的 DM 配对系统
• 用于群聊的 Docker 沙盒
• 可配置的权限系统
• 审计日志和安全诊断

🛠️ 安装与设置

快速入门

# 全局安装
npm install -g clawdbot@latest

# 运行入职向导
clawdbot onboard --install-daemon

# 启动网关
clawdbot gateway --port 18789

开发设置

# 克隆仓库
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 安装依赖项
pnpm install
pnpm ui:build
pnpm build

# 运行入职
pnpm clawdbot onboard --install-daemon

系统要求

• 运行时: Node.js ≥22
• 操作系统: macOS、Linux、Windows（通过 WSL2）
• 内存: 建议 2GB+ RAM
• 存储: 建议使用 SSD 以获得最佳性能

🔧 配置

核心配置

配置存储在 ~/.clawdbot/clawdbot.json 中，提供全面的选项：

• 代理设置: 工作区路径、模型偏好、思考级别
• 渠道配置: 特定于平台的设置和访问控制
• 安全: 沙盒模式、允许列表、DM 策略
• 工具: 技能启用和权限管理

多代理设置

# 创建隔离的代理实例
CLAWDBOT_CONFIG_PATH=~/.clawdbot/agent-a.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-agent-a \
clawdbot gateway --port 19001

🎯 用例与应用

个人生产力

• 电子邮件管理和自动回复
• 日历协调和会议安排
• 跨多个平台的任务自动化
• 文档处理和文件组织

开发工作流

• 代码审查和拉取请求管理
• CI/CD 流水线监控
• 存储库维护
• 自动化测试和部署

智能家居集成

• 设备控制和自动化
• 环境监测
• 定时例程
• 语音激活命令

创意项目

• 支持多媒体的内容生成
• 图像和音频处理
• 社交媒体管理
• 创意写作辅助

🌟 社区与生态系统

活跃开发

• GitHub 仓库: 18,000+ 颗星并持续增长
• 发布周期: 新功能频繁更新
• 社区 Discord: 数千活跃用户
• 文档: 全面的指南和教程

插件生态系统

• ClawdHub: 集中式技能存储库
• 社区贡献: 用户生成的技能和插件
• 集成库: 流行服务的预构建连接器
• 开发工具: 用于扩展开发的 SDK 和 CLI 工具

📊 性能与可扩展性

Token 效率

• 智能缓存以降低 API 成本
• 大型对话的自适应分块
• 渐进式回退机制
• 上下文优化策略

资源管理

• 轻量级网关进程
• 高效的 WebSocket 通信
• 针对长期会话的优化内存使用
• 可配置的资源限制

🔒 安全与隐私

隐私优先设计

• 所有数据处理均在本地进行
• 核心功能无云依赖
• 用户控制的数据保留策略
• 透明的日志记录和审计功能

安全功能

• 沙盒执行环境
• 基于权限的工具访问
• 安全凭证管理
• 网络隔离选项

🚧 当前限制与注意事项

技术挑战

• 设置复杂性: 需要技术知识进行初始配置
• API 成本: 依赖付费 LLM 服务以获得最佳性能
• 资源要求: 始终在线的设置需要专用硬件
• 早期阶段: 积极开发，偶尔会有破坏性更改

缓解策略

• 改进的入职向导可降低设置复杂性
• 支持本地模型可减少 API 依赖
• 全面的文档和社区支持
• Docker 容器提供隔离和一致性

🔮 未来路线图

计划的增强功能

• 增强的本地模型支持: 改进与开源 LLM 的集成
• 移动应用扩展: iOS 和 Android 的功能对等
• 可视化界面改进: 高级画布和 A2UI 功能
• 企业功能: 团队协作和管理工具

社区目标

• 更广泛的平台支持: 额外的消息平台集成
• 简化的设置: 一键安装体验
• 性能优化: 降低资源消耗
• 教育资源: 教程和认证计划

🤝 参与其中

对于用户

• 安装指南: 入门文档
• 社区 Discord: 加入讨论并获得支持
• 技能市场: 通过 ClawdHub 探索和贡献技能
• 反馈: 在 GitHub 上报告问题和建议功能

对于开发者

• 贡献: 请参阅 CONTRIBUTING.md 获取开发指南
• 插件开发: 创建自定义技能和集成
• 文档: 帮助改进指南和教程
• 测试: 参与 Beta 测试和质量保证

📚 资源与链接

• 官方网站: clawd.bot
• GitHub 仓库: github.com/clawdbot/clawdbot
• 文档: docs.clawd.bot
• 社区 Discord: 活跃的支持和开发讨论
• NPM 包: npmjs.com/package/clawdbot

---

Clawdbot 代表着个人人工智能助手的未来: 本地控制、无限扩展，并无缝集成到您的日常工作流程中。加入革命，掌控您的人工智能体验！ 🦞