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 触发本地脚本、访问文件系统、抓取网页内容，并根据需要生成报告或执行自动化任务。

智能技能扩展开发与复用

用户可浏览并安装公共技能，也可开发自定义技能来扩展功能，以满足特定工作流程（如邮件自动分发、日志处理等）。

使用指南

安装与部署

1. 使用官方一键脚本安装：

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

   该安装程序可检测操作系统并设置 Node.js 环境。

2. 或者通过包管理器安装：

    

   npm install -g clawdbot

   也支持从源码构建。

初始设置

运行 Clawdbot GUI 或 CLI 启动向导命令进行初始化配置，并为消息平台添加 tokens 或授权凭证。

连接消息平台

根据平台文档配置 Bot Token 或 QR 登录流程（如 WhatsApp Web 扫码）。 然后启动网关服务以监听消息。

安装插件技能

使用 ClawdHub CLI 安装或更新技能，例如：

clawdhub search "calendar" clawdhub install calendar

技能将被加入工作空间供代理执行。

常见问题（FAQ）

Q1: Clawdbot 是开源吗？
A1: 是，Clawdbot 是一个开源项目，代码和文档可从官方站点及 GitHub 获取，部署许可通常为 MIT 类开源许可证。

Q2: Clawdbot 数据是否上传云端？
A2: 通常运行模式是本地优先，默认数据不会自动上传到云端，用户可以自定义行为。

Q3: 支持哪些平台？
A3: 当前集成包括 WhatsApp、Telegram、Discord、Signal 和 iMessage 等通信渠道。

Q4: Clawdbot 是否支持插件？
A4: 是，支持通过 ClawdHub 安装社区技能插件或自定义技能。

Q5: 如何执行系统命令？
A5: 在配置允许下，Clawdbot 可以执行本地命令和访问文件系统，脚本执行等操作。

术语定义

自托管 AI 助手
指运行在用户本地或私有服务器上、非托管云服务的 AI 代理系统。

技能（Skill）
表示扩展 Clawdbot 功能的独立模块，可通过 ClawdHub 安装。