// 01 Clawdbot 是什么
平台总体概述
核心定义
Clawdbot 是一种本地优先的 AI 助手系统，通常运行在 macOS、Windows 或 Linux 等主流操作系统上，可通过命令行或服务守护进程启动，并将消息平台作为前端通道进行交互响应。
发展背景
随着开源 AI 代理工具的兴起，Clawdbot 强调 本地数据控制、自托管隐私 与 系统级自动化执行能力，与仅作为聊天界面的模型集成器（如标准 ChatGPT 界面）相比可实现更深度的操作与集成。
核心功能结构
多平台消息通道集成
Clawdbot 支持将 AI 助手桥接到主流通信渠道，包括：
WhatsApp（通过 WhatsApp Web / Baileys 协议）
Telegram（Bot API / grammY）
Discord（Bot API / discord.js）
iMessage（本地 iMessage CLI 仅限 macOS）
此外可通过插件支持 Mattermost 等更多平台。
持久化上下文与记忆
Clawdbot 通常将对话和相关上下文持久存储在本地 Markdown 文件或会话日志中，使 AI 助手能够 记住用户偏好和历史交互，从而实现连续性对话与状态保留。
系统级自动化执行
Clawdbot 能够连接本地环境并执行操作，例如：
浏览器导航与网页数据提取
系统命令执行（Shell 脚本）
文件系统读写
自动化工作流安排
这些执行能力通常由可选的插件或技能触发。
技能与插件扩展
Clawdbot 支持名为 ClawdHub 的公共技能注册库，可通过命令行（CLI）安装、更新或发布技能，技能本质上是一套增加功能的文件夹集合（含 SKILL.md 等定义文件）。 用户可利用向量搜索查找技能并安装至工作空间。
技术组件详解
Gateway 与运行架构
Clawdbot 的核心架构包括一个 消息通道网关，该网关将外部平台消息转发至内部代理会话引擎，然后由后端模型或本地推理系统生成响应并发送回去。 前端消息通道（Telegram、WhatsApp 等）与辅助服务（Web UI、本地 Dashboard）协同工作。
配置与管理
默认配置文件通常存放在本地 ~/.clawdbot/clawdbot.json 路径下，用户可以通过该 JSON 文件设置消息平台 allowlist、群聊行为、代理 workspace 路径及其他服务参数。
安装与更新机制
Clawdbot 提供官方安装脚本，并可通过 npm 或 pnpm 进行全局安装；更新时可以重运行安装器或使用内置升级命令。
应用场景
个人生产力与助理
Clawdbot 可用作个人日常 AI 助手，通过集成消息平台实现快速查询、提醒设定、日程整理、邮件总结等任务。 一般认为本地存储与运行使数据隐私性更高。
通信平台自动化
通过 Telegram、WhatsApp、Discord 等渠道，Clawdbot 可以监控并响应群组或私人消息，自动执行相关指令和工作流。
系统任务自动化
开发者和高级用户可使用 Clawdbot 触发本地脚本、访问文件系统、抓取网页内容，并根据需要生成报告或执行自动化任务。
智能技能扩展开发与复用
用户可浏览并安装公共技能，也可开发自定义技能来扩展功能，以满足特定工作流程（如邮件自动分发、日志处理等）。
使用指南
安装与部署
使用官方一键脚本安装：
该安装程序可检测操作系统并设置 Node.js 环境。
或者通过包管理器安装：
也支持从源码构建。
初始设置
运行 Clawdbot GUI 或 CLI 启动向导命令进行初始化配置，并为消息平台添加 tokens 或授权凭证。
连接消息平台
根据平台文档配置 Bot Token 或 QR 登录流程（如 WhatsApp Web 扫码）。 然后启动网关服务以监听消息。
安装插件技能
使用 ClawdHub CLI 安装或更新技能，例如：
技能将被加入工作空间供代理执行。
