5 分钟掌握 Clawdbot：打造专属 AI 助手的完整新手指南

想要一个能在所有聊天软件中使用的私人 AI 助手,还能记住你说过的话、主动给你发消息提醒吗? Clawdbot 正是这样一个革命性的开源项目,它让 Claude AI 真正成为你的专属助手。

核心价值: 读完本文,你将掌握 Clawdbot 的核心概念、安装配置方法,以及如何通过 API 接入让它在 Discord、Telegram、WhatsApp 等 8+ 平台上为你服务。

Clawdbot 是什么?一句话解读

Clawdbot 是由 Peter Steinberger (PSPDFKit 创始人) 开发的开源个人 AI 助手项目。与传统网页版 ChatGPT 或 Claude 不同,Clawdbot 直接运行在你常用的聊天软件里——你在 WhatsApp 发消息,它在 WhatsApp 回复;你在 Discord 提问,它在 Discord 解答。

特性	Clawdbot	传统 AI 聊天
使用方式	在常用聊天软件内使用	需要打开专门网页
对话记忆	跨平台持久记忆	每次对话独立
主动推送	支持定时提醒和主动通知	只能被动响应
数据存储	本地 Markdown 文件	存储在云端
定制能力	完全可编程 Skills 系统	有限的自定义选项

🎯 关键理解: Clawdbot 不是一个 AI 模型,而是一个「AI 网关」——它负责连接你的聊天软件和 AI 大模型 API,让 AI 能力无缝融入日常沟通工具。

Clawdbot 核心架构:3 层设计

理解 Clawdbot 的架构有助于后续配置和排错。它采用清晰的三层设计:

第一层: Gateway 网关

Gateway 是 Clawdbot 的核心控制平面,默认监听 localhost:18789:

管理所有消息会话
路由不同渠道的消息
处理工具调用和 Skills 执行
维护对话历史和记忆系统

第二层: Channels 渠道

Channels 负责连接各种聊天平台:

渠道类型	支持平台	连接方式
即时通讯	WhatsApp, Telegram, Signal	Bot API / Web 协议
协作平台	Discord, Slack, Teams	Bot API
苹果生态	iMessage, macOS	imsg CLI / 原生集成
开放协议	Matrix, WebChat	标准协议对接
区域应用	Zalo, BlueBubbles	社区插件

第三层: LLM 大模型

Clawdbot 支持多种 AI 模型后端:

模型提供商	认证方式	适用场景
Anthropic Claude	API Key / OAuth	推荐首选,Clawdbot 原生优化
OpenAI GPT	API Key / OAuth	通用场景
第三方 API 代理	API Key	成本优化、访问便利

🎯 技术建议: 对于 Claude 模型的调用,我们建议通过 API易 apiyi.com 平台获取 API Key。该平台支持 Claude 4 全系列模型,提供统一的 OpenAI 兼容接口,价格更优惠且无需海外支付。

Clawdbot 4 大核心优势详解

优势一: 全渠道无缝接入

Clawdbot 的「全渠道」理念意味着:

同一个助手,多个入口: 你在手机上用 WhatsApp 问的问题,在电脑上用 Discord 继续追问
上下文自动同步: 无论从哪个渠道对话,助手都记得之前的交流内容
消息智能路由: 可配置特定类型消息走特定渠道

优势二: 持久记忆系统

传统 AI 聊天每次对话都是「失忆」状态,而 Clawdbot:

将记忆存储为 Markdown 文件,类似 Obsidian 笔记
支持语义检索,能关联你之前提过的信息
完全本地存储,数据不上传云端

~/clawd/
├── memories/           # 对话记忆
│   ├── 2026-01-26.md  # 按日期组织
│   └── topics/        # 按主题分类
├── skills/            # 自定义技能
└── config.yaml        # 配置文件

优势三: 主动推送能力

这是 Clawdbot 区别于其他 AI 助手的杀手级功能:

主动推送场景	示例
晨间简报	每天早 8 点推送日程和天气
任务提醒	在你提过的截止日期前提醒
监控告警	监控的网站异常时主动通知
定时执行	定期运行脚本并汇报结果

优势四: Skills 技能系统

Skills 是 Clawdbot 的「外挂」系统,通过 Markdown 或 TypeScript 文件定义:

# skill: web-search
使用 Brave Search API 搜索网络内容

## 触发条件
当用户询问需要实时信息的问题时

## 执行步骤
1. 调用 Brave Search API
2. 解析搜索结果
3. 生成摘要回复

社区已贡献 100+ 现成 Skills,涵盖:

网页浏览和截图
文件读写操作
日程管理集成
代码执行环境
智能家居控制

Clawdbot 安装配置:3 步快速上手

环境要求

项目	要求
Node.js	≥ 22.x
操作系统	macOS / Linux / Windows (WSL2)
内存	≥ 2GB 可用
AI API	Claude 或 OpenAI API Key

第一步: 全局安装

# 使用 npm 安装 (推荐)
npm install -g clawdbot@latest

# 或使用 pnpm
pnpm add -g clawdbot@latest

第二步: 运行配置向导

# 启动交互式配置向导
clawdbot onboard --install-daemon

向导会引导你完成:

AI 模型配置 – 输入 Claude 或 OpenAI API Key
工作目录设置 – 默认 ~/clawd
渠道启用 – 选择要连接的聊天平台
守护进程安装 – 让 Gateway 后台持续运行

🚀 快速开始: 如果你还没有 Claude API Key,推荐使用 API易 apiyi.com 平台快速获取。该平台提供开箱即用的 API 接口,注册即送免费测试额度,5 分钟即可完成配置。

第三步: 验证安装

# 检查服务状态
clawdbot status

# 深度健康检查
clawdbot health

# 诊断配置问题
clawdbot doctor

预期输出:

Gateway: ✓ Running on localhost:18789
Channels: ✓ Discord, Telegram connected
LLM: ✓ Claude API configured
Memory: ✓ 42 memories indexed

Clawdbot Discord 集成配置指南

Discord 是 Clawdbot 最常用的渠道之一,配置步骤如下:

步骤 1: 创建 Discord Bot

访问 Discord Developer Portal: discord.com/developers/applications
点击「New Application」创建应用
进入「Bot」页面,点击「Add Bot」
记录 Bot Token (点击 Reset Token 生成)

步骤 2: 配置 Bot 权限

在「OAuth2 → URL Generator」中勾选:

权限类别	具体权限
Scopes	bot, applications.commands
Bot Permissions	Send Messages, Read Message History, Embed Links

步骤 3: 邀请 Bot 到服务器

使用生成的 OAuth2 URL 邀请 Bot 到你的 Discord 服务器。

步骤 4: 配置 Clawdbot

# 交互式配置 Discord 渠道
clawdbot configure --section channels.discord

输入 Bot Token 后,Clawdbot 会自动完成连接。

步骤 5: 测试对话

在 Discord 服务器中 @你的 Bot 或私信它:

@ClawdBot 你好,介绍一下你自己

Bot 会使用 Claude API 生成回复并发送到 Discord。

Clawdbot API 配置详解

Clawdbot 的智能来自底层的 AI 大模型,正确配置 API 至关重要。

官方 Anthropic API

# ~/clawd/config.yaml
llm:
  provider: anthropic
  model: claude-sonnet-4-20250514
  apiKey: sk-ant-xxxxx

优点:

直连官方,延迟最低
支持最新模型

局限:

需要海外信用卡支付
部分地区访问受限

第三方 API 代理 (推荐)

# ~/clawd/config.yaml
llm:
  provider: openai-compatible
  model: claude-sonnet-4-20250514
  apiKey: sk-xxxxx
  baseUrl: https://api.apiyi.com/v1  # 使用 API易 统一接口

💰 成本优化: 对于国内用户,使用 API易 apiyi.com 作为 API 代理是更优选择。该平台提供 OpenAI 兼容格式接口,支持 Claude 全系列模型,价格比官方更优惠,且支持支付宝/微信付款,无需海外支付渠道。

OAuth 订阅认证

如果你已有 Claude Pro/Max 订阅:

clawdbot configure --section llm.oauth

优点是使用现有订阅额度,无需额外 API 费用。

Clawdbot 常用 Skills 配置

网页搜索 Skill

# 配置 Brave Search API
clawdbot configure --section web

# 输入你的 Brave Search API Key

配置后 Clawdbot 可以搜索实时网络信息回答问题。

文件操作 Skill

Clawdbot 内置文件读写能力:

我: 帮我读取 ~/Documents/notes.md 的内容
Bot: 正在读取文件... [文件内容]

我: 在文件末尾添加一行 "今日待办: 完成报告"
Bot: 已添加内容到文件

浏览器 Skill

我: 帮我访问 example.com 并截图
Bot: [启动浏览器] → [加载页面] → [生成截图] → [返回图片]

自定义 Skill

在 ~/clawd/skills/ 目录创建 Markdown 文件即可:

# skill: daily-report
每日工作汇报生成器

## 描述
根据今日对话记录生成工作日报

## 触发词
生成日报, 今日总结

## 执行逻辑
1. 读取今日所有对话记忆
2. 提取工作相关内容
3. 生成结构化日报

Clawdbot 成本估算与对比

费用项目	月费用	说明
VPS 服务器	¥35-70	可选,本地运行免费
Claude API	¥70-140	取决于使用量
Claude Pro 订阅	¥140	用 OAuth 认证可省 API 费
Claude Max 订阅	¥1400	重度使用者,Opus 无限制

成本优化建议

本地运行: 用家里的电脑或 Mac mini 运行,省去 VPS 费用
API 代理: 通过 API易 apiyi.com 调用 Claude API,价格更优惠
模型选择: 日常对话用 claude-haiku,复杂任务再切换 claude-sonnet
记忆管理: 定期清理无用记忆,减少 Token 消耗

Clawdbot 与其他方案对比

对比维度	Clawdbot	ChatGPT App	Claude App	自建 Bot
多平台支持	⭐⭐⭐⭐⭐ 8+ 平台	⭐⭐ 仅 App	⭐⭐ 仅 App	⭐⭐⭐ 需要逐个开发
对话记忆	⭐⭐⭐⭐⭐ 持久本地存储	⭐⭐⭐ 云端有限	⭐⭐⭐ 云端有限	⭐⭐ 需自行实现
主动推送	⭐⭐⭐⭐⭐ 完整支持	❌ 不支持	❌ 不支持	⭐⭐⭐ 需自行实现
隐私保护	⭐⭐⭐⭐⭐ 本地存储	⭐⭐ 云端存储	⭐⭐ 云端存储	⭐⭐⭐⭐ 取决于实现
定制能力	⭐⭐⭐⭐⭐ Skills 系统	⭐⭐ GPTs 有限	⭐⭐ Projects	⭐⭐⭐⭐⭐ 完全自定义
上手难度	⭐⭐⭐ 需要技术基础	⭐⭐⭐⭐⭐ 开箱即用	⭐⭐⭐⭐⭐ 开箱即用	⭐ 需要大量开发

💡 选择建议: Clawdbot 适合有一定技术背景、追求隐私和深度定制的用户。如果你只需要简单的 AI 对话,官方 App 已经足够;如果你想让 AI 真正融入日常工作流,Clawdbot 值得投入时间学习。

常见问题 FAQ

Q1: Clawdbot 需要 VPS 服务器吗?

不是必需的。Clawdbot 可以在你的个人电脑上运行,只要电脑开机就能使用。但如果你希望 24 小时在线,建议使用:

家里的常开电脑 (Mac mini 等)
云服务器 (VPS,每月 ¥35-70)
本地 NAS 设备

Q2: 没有海外信用卡怎么获取 Claude API?

可以通过 API易 apiyi.com 平台获取 Claude API 访问。该平台支持支付宝、微信付款,提供与官方一致的 API 接口,且价格更优惠。注册后即可获取 API Key,配置到 Clawdbot 即可使用。

Q3: Clawdbot 支持中文吗?

完全支持。Clawdbot 本身只是一个网关,AI 能力来自底层模型 (Claude/GPT)。这些模型都对中文有很好的支持,你可以用中文与 Clawdbot 进行所有交互。

Q4: 如何保证对话隐私?

Clawdbot 采用「本地优先」设计:

对话记忆存储在你自己的设备上 (Markdown 文件)
Gateway 运行在 localhost,不暴露公网
可通过 SSH 隧道或 Tailscale 安全访问
只有 AI 模型调用需要联网 (API 请求)

Q5: 遇到问题去哪里求助?

Clawdbot 有活跃的社区:

Discord 服务器: 加入后可直接与两个 Clawdbot 实例对话,还能提问
GitHub Issues: github.com/clawdbot/clawdbot
官方文档: docs.clawd.bot

Bug 反馈通常能很快得到响应,有时作者会在聊天中实时修复。

Q6: Windows 用户如何安装?

Windows 用户强烈建议使用 WSL2:

安装 WSL2 (推荐 Ubuntu 发行版)
在 WSL2 中安装 Node.js 22+
按 Linux 步骤安装 Clawdbot

原生 Windows 支持尚不完善,可能遇到各种问题。

Clawdbot 进阶玩法

1. 多 Agent 协作

Clawdbot 支持创建多个会话 (Session),它们可以相互通信:

Session A (研究助手): 调研市场数据
Session B (写作助手): 接收 A 的数据,生成报告
Session C (审核助手): 检查 B 的报告,提出修改建议

2. 自动化工作流

结合 Cron 定时任务:

每日早 8 点: 汇总邮箱重要邮件
每周一 9 点: 生成上周工作总结
每月 1 日: 统计本月 API 使用量

3. 智能家居集成

通过 Home Assistant 或 MQTT 连接智能设备:

我: 把客厅灯调暗一点
Bot: [调用 Home Assistant API] 已将客厅灯亮度调至 50%

4. 代码开发辅助

Clawdbot 可以:

读取代码文件并解释
执行 shell 命令
浏览 GitHub 仓库
生成代码并保存到文件

总结与下一步

Clawdbot 代表了个人 AI 助手的新范式:

核心价值	说明
无处不在	在你常用的聊天软件中使用 AI
永不遗忘	持久化记忆,真正了解你
主动服务	不再被动等待,主动推送提醒
完全可控	开源自托管,数据永远属于你
无限扩展	Skills 系统让能力无上限

下一步行动:

安装 Clawdbot: npm install -g clawdbot@latest
获取 Claude API: 推荐通过 API易 apiyi.com 快速获取
运行配置向导: clawdbot onboard --install-daemon
连接你的第一个渠道 (推荐从 Discord 开始)
加入 Clawdbot Discord 社区交流经验

参考资料

Clawdbot 官网: 产品介绍和快速开始
- 链接: clawd.bot
Clawdbot 官方文档: 完整配置指南
- 链接: docs.clawd.bot
GitHub 仓库: 开源代码和 Issues
- 链接: github.com/clawdbot/clawdbot
MacStories 深度评测: 使用体验分享
- 链接: macstories.net/stories/clawdbot-showed-me-what-the-future-of-personal-ai-assistants-looks-like/
Peter Steinberger 个人站: 作者博客
- 链接: steipete.me

📝 作者: APIYI Team
🔗 技术交流: 访问 apiyi.com 获取更多 AI API 使用技巧
📅 更新日期: 2026年1月