Clawdbot 安装指南:从安装到首次聊天

2026/01/25
Share:

Clawdbot 安装指南

这份全面的 Clawdbot 安装指南将引导你完成让个人 AI 助手运行所需的一切。无论你使用 macOS、Windows 还是 Linux,本教程都涵盖了安装、配置和连接你的第一个聊天平台。

前提条件

在开始 Clawdbot 设置之前,请确保你有:

  1. Node.js 22+ - 从 nodejs.org 下载
  2. AI 提供商 API 密钥 - Anthropic Claude(推荐)或 OpenAI
  3. 支持的操作系统
    • 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

入门过程将引导你完成:

  1. AI 提供商选择 - 选择 Claude、OpenAI 或本地模型
  2. API 密钥配置 - 输入你的 API 凭据
  3. 守护进程安装 - 设置后台服务
  4. 初始配置 - 基本偏好设置

步骤 3:配置你的 AI 提供商

使用 Anthropic Claude(推荐)

  1. console.anthropic.com 获取 API 密钥
  2. 在入门过程中选择 "Anthropic Claude"
  3. 在提示时输入你的 API 密钥

为获得最佳效果,Clawdbot 团队推荐:

  • Anthropic Pro/Max 订阅 以获得更高的速率限制
  • Opus 4.5 模型 以获得最佳性能

使用 OpenAI

  1. platform.openai.com 获取 API 密钥
  2. 在入门过程中选择 "OpenAI"
  3. 输入你的 API 密钥

使用本地模型

为了完全隐私和离线使用:

  1. 安装本地模型提供商(Ollama、LM Studio 等)
  2. 在入门过程中选择 "Local Model"
  3. 配置本地端点

步骤 4:连接聊天平台

Clawdbot 的强大之处在于聊天集成。以下是连接流行平台的方法:

WhatsApp 设置

  1. 运行 clawdbot connect whatsapp
  2. 用手机扫描二维码
  3. WhatsApp Web 将连接到 Clawdbot

Telegram 设置

  1. 通过 @BotFather 创建机器人
  2. 获取你的机器人令牌
  3. 运行 clawdbot connect telegram --token YOUR_TOKEN

Discord 设置

  1. discord.com/developers 创建 Discord 应用
  2. 创建机器人并获取令牌
  3. 运行 clawdbot connect discord --token YOUR_TOKEN

Slack 设置

  1. api.slack.com 创建 Slack 应用
  2. 配置 OAuth 并获取令牌
  3. 运行 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

获取帮助

下一步

现在你的 Clawdbot 设置已完成:

  1. 探索功能 - 问 Clawdbot 它能做什么
  2. 设置自动化 - 为重复任务创建定时任务
  3. 安装技能 - 使用插件扩展功能
  4. 加入社区 - 在 Discord 上分享你的设置

结论

恭喜!你已完成 Clawdbot 安装指南。你的个人 AI 助手现在已准备好帮助你浏览网页、文件管理、自动化等 - 所有这些都通过你喜欢的聊天应用完成。

资源:

Clawdbot AI

Clawdbot AI