文档技能社区更新日志教程 GitHub开始使用
快速入门

5 分钟启动你的 ClawBot

从零开始,一步步搭建属于你自己的 24/7 AI 助手。

环境准备

在开始之前,请确保你的系统已经安装以下工具:

Docker

版本 24.0 或更高

Node.js

版本 20 LTS 或更高

Git

任意最新版本

API 密钥

Claude / OpenAI API Key

安装 ClawBot

通过 Git 克隆仓库并安装依赖:

# 克隆仓库
git clone https://github.com/clawbot/clawbot.git
cd clawbot

# 安装依赖
npm install

# 或者使用 Docker(推荐)
docker pull clawbot/clawbot:latest

配置文件

复制示例配置并根据你的需求修改:

cp .env.example .env

# 编辑 .env 文件,填入以下关键配置:
# ANTHROPIC_API_KEY=sk-ant-xxxx     # Claude API 密钥
# TELEGRAM_BOT_TOKEN=xxxx           # Telegram 机器人令牌
# WECHAT_APP_ID=xxxx                # 微信公众号 AppID
# PERSONA_NAME=小蟹                  # 你的 AI 助手名称
# PERSONA_PROMPT=你是一个友善的助手    # AI 人格提示词
提示:建议先只配置一个通讯平台(如 Telegram),成功运行后再逐步添加其他平台。

启动运行

一键启动 ClawBot:

# 使用 Docker Compose 启动(推荐)
docker compose up -d

# 查看日志
docker compose logs -f clawbot

# 或直接使用 Node.js 启动
npm run start

启动成功后你会看到:

🦀 ClawBot v2.0 启动成功!
✅ 已连接到 Claude API
✅ Telegram 机器人已上线
✅ 记忆系统已初始化
✅ 技能加载完成 (12 个技能)
🔗 管理面板: http://localhost:3000

连接通讯平台

ClawBot 支持多种通讯平台,以下是各平台的配置方式:

Telegram

通过 @BotFather 创建机器人,获取 Token 填入配置文件即可。

微信

使用微信公众号接口或 WeChatFerry 方案对接个人微信号。

Discord

在 Discord 开发者门户创建应用,配置 Bot Token。

WhatsApp

通过 WhatsApp Business API 或 Baileys 库连接。

第一次对话

一切就绪!现在打开你配置的通讯平台,向 ClawBot 发送第一条消息:

你好,你能做什么?

🦀 小蟹

你好!我是你的 AI 助手小蟹 🦀 我可以帮你做很多事情:
📧 管理邮件和收件箱
📅 安排日程和提醒
💻 编写和审查代码
🏠 控制智能家居设备
✈️ 查询航班并自动值机

你想先试试哪个?或者直接告诉我你需要什么帮助!

恭喜!你已经成功启动了 ClawBot。接下来可以阅读 技能开发指南 学习如何扩展功能,或浏览 示例项目 获取灵感。