Clawdbot 安装指南
这份全面的 Clawdbot 安装指南将引导你完成让个人 AI 助手运行所需的一切。无论你使用 macOS、Windows 还是 Linux,本教程都涵盖了安装、配置和连接你的第一个聊天平台。
前提条件
在开始 Clawdbot 设置之前,请确保你有:
- Node.js 22+ - 从 nodejs.org 下载
- AI 提供商 API 密钥 - Anthropic Claude(推荐)或 OpenAI
- 支持的操作系统:
- macOS 13 (Ventura) 或更高版本
- Windows 10/11 配合 WSL2
- Linux(Ubuntu、Debian、Fedora、Arch)
步骤 1:安装 Clawdbot
快速安装(所有平台)
安装 Clawdbot 最快的方式是使用一行安装命令:
curl -fsSL https://clawd.bot/install.sh | bash此脚本自动:
- 检测你的操作系统
- 安装所需依赖
- 全局设置 Clawdbot
NPM 安装
如果你更喜欢 npm:
npm i -g clawdbot验证安装
检查 Clawdbot 是否正确安装:
clawdbot --version步骤 2:运行入门向导
启动交互式设置向导:
clawdbot onboard --install-daemon入门过程将引导你完成:
- AI 提供商选择 - 选择 Claude、OpenAI 或本地模型
- API 密钥配置 - 输入你的 API 凭据
- 守护进程安装 - 设置后台服务
- 初始配置 - 基本偏好设置
步骤 3:配置你的 AI 提供商
使用 Anthropic Claude(推荐)
- 从 console.anthropic.com 获取 API 密钥
- 在入门过程中选择 "Anthropic Claude"
- 在提示时输入你的 API 密钥
为获得最佳效果,Clawdbot 团队推荐:
- Anthropic Pro/Max 订阅 以获得更高的速率限制
- Opus 4.5 模型 以获得最佳性能
使用 OpenAI
- 从 platform.openai.com 获取 API 密钥
- 在入门过程中选择 "OpenAI"
- 输入你的 API 密钥
使用本地模型
为了完全隐私和离线使用:
- 安装本地模型提供商(Ollama、LM Studio 等)
- 在入门过程中选择 "Local Model"
- 配置本地端点
步骤 4:连接聊天平台
Clawdbot 的强大之处在于聊天集成。以下是连接流行平台的方法:
WhatsApp 设置
- 运行
clawdbot connect whatsapp - 用手机扫描二维码
- WhatsApp Web 将连接到 Clawdbot
Telegram 设置
- 通过 @BotFather 创建机器人
- 获取你的机器人令牌
- 运行
clawdbot connect telegram --token YOUR_TOKEN
Discord 设置
- 在 discord.com/developers 创建 Discord 应用
- 创建机器人并获取令牌
- 运行
clawdbot connect discord --token YOUR_TOKEN
Slack 设置
- 在 api.slack.com 创建 Slack 应用
- 配置 OAuth 并获取令牌
- 运行
clawdbot connect slack --token YOUR_TOKEN
步骤 5:测试你的设置
发送测试消息以验证一切正常:
通过终端
clawdbot chat "你好,你能做什么?"通过聊天应用
向你连接的聊天平台发送消息。Clawdbot 应该在几秒钟内响应。
步骤 6:配置技能(可选)
使用社区技能扩展 Clawdbot:
# 浏览可用技能
clawdbot skills list
# 安装技能
clawdbot skills install <skill-name>流行的技能包括:
- Home Assistant - 智能家居控制
- GitHub - 仓库管理
- Calendar - 日程管理
- Spotify - 音乐控制
故障排除
常见问题
安装后 "Command not found"
- 重启你的终端
- 检查 npm 全局 bin 是否在你的 PATH 中
API 连接错误
- 验证你的 API 密钥是否正确
- 检查你的互联网连接
- 确保你有 API 额度
聊天平台无法连接
- 验证令牌是否正确
- 检查平台特定要求
- 查看日志:
clawdbot logs
获取帮助
- Discord:discord.gg/clawd
- GitHub Issues:github.com/clawdbot/clawdbot/issues
- 文档:docs.clawd.bot
下一步
现在你的 Clawdbot 设置已完成:
- 探索功能 - 问 Clawdbot 它能做什么
- 设置自动化 - 为重复任务创建定时任务
- 安装技能 - 使用插件扩展功能
- 加入社区 - 在 Discord 上分享你的设置
结论
恭喜!你已完成 Clawdbot 安装指南。你的个人 AI 助手现在已准备好帮助你浏览网页、文件管理、自动化等 - 所有这些都通过你喜欢的聊天应用完成。
资源:

