Clawdbot 是一个开源的个人 AI 助手框架，能让你在自己的电脑或服务器上运行一个真正“属于自己”的智能代理。它不像 ChatGPT 那样依赖云端，而是把大模型、工具调用、长期记忆和多平台聊天通道全部整合成本地可控的系统。你可以通过 Telegram、WhatsApp、Discord 等日常聊天软件，直接发消息指挥它执行系统命令、操作浏览器、读写文件、管理日程，甚至设置定时任务主动提醒。
很多人第一次接触 Clawdbot 时都会问：它到底怎么用？安装难不难？核心玩法是什么？本文将从零开始，手把手带你跑通整个流程，把安装、配置、启动到日常使用的核心方式一次讲明白，让你快速上手并发挥它的最大价值。
文章导航
一、Clawdbot 是什么？为什么越来越多人用它
Clawdbot 本质上是一个“个人 AI 操作系统”。它把大语言模型（LLM）与本地系统深度结合，让 AI 不仅能聊天，还能真正“干活”：
- 本地运行，隐私可控：所有数据和上下文都留在你的设备上，不上传云端。
- 多渠道交互：支持 Telegram、WhatsApp、Discord、Slack、Signal、iMessage 等，几乎所有主流聊天工具都能当作遥控器。
- 强大工具调用：能执行 shell 命令、读写文件、控制 Chrome 浏览器、截屏、发通知、定时任务等。
- 永久记忆：对话历史、偏好、自定义技能都以 Markdown 文件形式持久化保存，重启后依然记得。
- 开源免费：MIT 协议，代码完全公开，社区活跃。
相比传统云端助手，Clawdbot 的最大优势在于“所有权”和“可编程性”。它不是一个黑盒产品，而是你可以深度定制的工作流中枢。
二、Clawdbot 与常见 AI 助手的对比
| 维度 | Clawdbot | ChatGPT/ Claude 云端版 | GitHub Copilot | AutoGPT 类开源智能体 |
| 部署方式 | 本地自托管 / 云服务器 | 云端托管 | IDE 集成， 云端托管 | 自托管， 但配置复杂 |
| 数据隐私 | 完全本地可控 | 受平台服务条款约束 | 受平台约束 | 取决于部署 |
| 交互入口 | 多聊天平台 + CLI | Web/App | IDE 内 | Web/CLI |
| 工具能力 | 系统命令、文件、浏览器、定时任务 | 有限插件 | 主要代码相关 | 依赖自定义工具链 |
| 扩展性 | Skills 系统 + 自定义脚本 | 平台插件 | IDE 插件 | 代码级扩展 |
| 长期记忆 | 原生持久化 Markdown | 会话结束即丢失 | 无 | 部分支持 |
| 适合场景 | 个人自动化、 长期助手 | 通用问答、内容生成 | 代码补全 | 实验性任务编排 |
从表中可以看到，Clawdbot 在隐私、可控性和工具深度上具有明显优势，尤其适合需要长期陪伴和系统级操作的用户。
三、Clawdbot 核心架构：四个关键概念
理解 Clawdbot 的使用方式，先要搞清楚它的四个核心组件：
- Gateway（网关）
整个系统的控制中心，负责消息路由、会话管理、工具调度。它是一个常驻后台的 WebSocket 服务（默认端口 18789）。 - Agent（代理）
每个独立的 AI 会话就是一个 Agent。你可以创建多个 Agent，用于不同场景（如工作代理、代码代理、研究代理），互不干扰。 - Channels（通道）
把聊天软件接入系统。你在 Telegram 发消息 → Gateway 收到 → 转发给对应 Agent → Agent 处理后回复到 Telegram，整个过程无缝。 - Skills（技能）
可复用的工具包。内置大量技能（如浏览器控制、邮件监听、定时任务），也可以自己写或让 AI 自动生成。
这四个部分协同工作，让 Clawdbot 成为一个真正的“主动智能体”。
四、从零开始：Clawdbot 安装与快速配置
1. 环境准备
- 一台可 24 小时运行的设备：推荐云服务器，也可以在 Mac/PC 上运行
- Node.js ≥ 22：安装脚本会自动处理
- AI 模型 API Key：推荐 Claude，也支持 OpenAI、国产模型、本地 Ollama
- 聊天账号：推荐 Telegram，最简单
2. 一键安装（推荐方式）
Mac/Linux 用户：
curl -fsSL https://clawd.bot/install.sh | bash
Windows 用户（PowerShell）：
iwr -useb https://clawd.bot/install.ps1 | iex
安装过程会自动配置环境，耐心等待完成。
3. 快速配置向导（最重要一步）
安装完成后，运行：
clawdbot onboard --install-daemon
向导会引导你完成以下配置：
- 确认安全风险（选择 Yes 继续）
- 选择并配置 AI 模型（输入 API Key）
- 接入聊天通道（推荐先选 Telegram）
- 自动安装常用 Skills 和 Hooks
- 完成后再启动后台服务
整个过程交互式操作，通常 5-10 分钟即可完成。
4. 手动配置（进阶用户）
如果需要更精细控制，可编辑主配置文件：
nano ~/.clawdbot/clawdbot.json
常见配置片段示例：
Claude 官方配置：
{
"models": {
"providers": {
"anthropic": {
"apiKey": "你的 Anthropic API Key"
}
}
},
"channels": {
"telegram": {
"enabled": true,
"botToken": "你的 Telegram Bot Token",
"profiles": ["default"]
}
},
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-opus-4-5-20251101"
}
}
}
}
第三方/国产模型配置（需注意 api 字段）：
{
"models": {
"providers": {
"minimax": {
"baseUrl": "https://api.minimax.cn",
"apiKey": "你的 Key",
"api": "anthropic-messages"
}
}
}
}
修改配置后记得清理缓存并重启：
rm -rf ~/.clawdbot/agents/main/agent/sessions/*
systemctl --user restart clawdbot-gateway.service
5. 启动服务与账号配对
配置完成后，启动网关服务：
systemctl --user start clawdbot-gateway.service
systemctl --user status clawdbot-gateway.service # 检查状态
看到 Active: active (running) 即成功。
Telegram 配对示例：
1. 在 Telegram 中找到你的机器人，发送任意消息。
2. 机器人会回复一个配对码（如 ABC123）。
3. 在服务器执行：
clawdbot pairing approve telegram ABC123
再次发消息测试，连通即成功。
五、Clawdbot 核心使用方式：日常怎么和它互动
5.1 基础对话与系统操作
在 Telegram（或其他已接入平台）直接发消息即可：
- “你好，介绍一下你自己”
- “帮我查看桌面有哪些文件”
- “在桌面创建一个叫 test 的文件夹”
- “截个当前屏幕发给我”
5.2 信息搜索与总结
- “搜索最近的 AI 新闻，总结 3 条最重要的”
- “帮我研究一下某公司最新财报”
5.3 浏览器自动化
- “打开 GitHub，登录我的账号，查看未读通知”
- “去淘宝搜索 iPhone 16，截图前三款商品价格”
5.4 定时任务与主动提醒
- “每天早上 8 点给我发今日天气和日程”
- “每周五下午 5 点总结本周工作，列出下周重点”
5.5 代码与开发辅助
- “写一个 Python 脚本爬取豆瓣电影 Top 250”
- “帮我修复项目里 auth.test.js 的测试失败”
5.6 多代理协同（进阶）
你可以创建多个专用代理：
- 代码代理：专门处理编程任务
- 研究代理：接入 Grok API 做实时信息检索
- 数据分析代理：使用大上下文模型处理长文档
在对话中直接说：“创建一个专门写代码的代理，用 Claude 模型”，Clawdbot 会自动帮你配置。
六、常用 Skills 推荐与扩展
Clawdbot 自带大量实用 Skills，推荐优先启用：
| Skills 名称 | 功能描述 | 典型指令示例 |
| browser | 完整 Chrome 控制 | “登录我的银行账户查看余额” |
| canvas | 动态可视化画布 | “画一个本周工作进度甘特图” |
| cron | 定时任务调度 | “每天 6 点检查电费” |
| gmail | 邮件监听与处理 | “总结今天收到的所有重要邮件” |
| exa / perplexity | 高质量网络搜索 | “深度研究量子计算最新进展” |
| nodes | 设备级操作（截屏、相机、通知） | “截取当前屏幕并发给我” |
想添加新技能？直接对 Clawdbot 说：“我想要一个每天检查服务器负载的技能”，它会引导你完成配置，甚至自动生成。
七、常见问题与故障排除
| 问题现象 | 解决方法 |
| 服务不断重启 | 1. 启用 linger：loginctl enable-linger root2. 清理会话缓存 3. 重启服务 |
| 配置修改后不生效 | 清理 sessions 缓存 + 重启 gateway |
| 第三方模型报错 | 确认 api 字段为 "anthropic-messages"，baseUrl 不带 /v1 |
| Telegram 收不到消息 | 检查 botToken 是否正确，是否完成配对 |
| 工具调用失败 | 检查对应二进制是否安装 （如 Chrome 用于 browser skill） |
查看日志：
journalctl --user -u clawdbot-gateway.service -f
八、安全注意事项
Clawdbot 拥有系统级权限，使用时请注意：
- 首次安装建议在非重要数据机器上测试
- 严格执行 DM 配对策略，避免陌生人控制
- 敏感操作前开启沙盒模式：非主会话在 Docker 中运行
- 定期备份
~/.clawdbot和~/clawd目录 - 不要轻易授权高危工具（如 root 权限命令）
运行 clawdbot doctor 可自动检查配置风险。
九、适合 Clawdbot 的高频场景
- 日常效率：邮件/日程自动摘要 + 主动提醒
- 系统运维：批量执行脚本、监控服务器状态
- 知识管理：结合本地文件构建个人知识库
- 开发辅助：代码审查、自动化测试、文档生成
- 自动化研究：浏览器抓取 + 信息总结 + 定时报告
当你把 Clawdbot 用熟了，它就不再是一个“聊天机器人”，而是一个真正懂你、能主动帮你的数字伙伴。
最后：快速上手建议
- 先在本地电脑跑通 onboard 向导，用 Telegram 测试基础功能。
- 确认稳定后，部署到云服务器实现 24/7 在线。
- 从简单任务开始，逐步添加 Skills 和定时任务。
- 加入社区（GitHub Discussions、Discord）获取最新玩法。
Clawdbot 的魅力在于“长期主义”——你投入越多时间配置和教它，它就越聪明、越贴心。
立即开始你的第一步吧，未来已来，你的专属 AI 助手正在等待唤醒。
延展阅读：
