🚀 一键部署你的私人 AI 助手 ClawdBot，支持多平台多模型配置
主流服务商:
- Anthropic Claude - claude-sonnet-4-5 / claude-opus-4-5 / claude-haiku-4-5 (支持自定义 API 地址)
- OpenAI GPT - gpt-4o / gpt-4o-mini / gpt-4-turbo (支持自定义 API 地址，需支持 v1/responses)
- Google Gemini - gemini-2.0-flash / gemini-1.5-pro / gemini-1.5-flash
多模型网关:
- OpenRouter - 多模型网关，一个 Key 用遍所有模型 (claude-sonnet-4 / gpt-4o / gemini-pro-1.5)
快速推理:
- Groq - 超快推理，llama-3.3-70b-versatile / llama-3.1-8b-instant / mixtral-8x7b
- Mistral AI - mistral-large-latest / mistral-small-latest / codestral-latest
本地部署:
- Ollama - 本地部署，无需 API Key (llama3 / llama3:70b / mistral)
💡 自定义 API 地址: Anthropic Claude 和 OpenAI GPT 都支持自定义 API 地址，可接入 OneAPI/NewAPI/API 代理等服务。配置时先输入自定义地址，再输入 API Key。
⚠️ OpenAI 中转要求: 自定义 OpenAI API 地址必须支持v1/responses路径（OpenAI Responses API），不仅仅是传统的v1/chat/completions。请确认您的中转服务已支持此接口。
- Telegram Bot
- Discord Bot
- Slack
- 微信 (WeChat)
- iMessage (仅 macOS)
- 飞书 (Feishu)
- API 连接测试
- 渠道连接验证
- ClawdBot 诊断工具
- 持久记忆 - 跨对话、跨平台的长期记忆
- 主动推送 - 定时提醒、晨报、告警通知
- 技能系统 - 通过 Markdown 文件定义自定义能力
- 远程控制 - 可执行系统命令、读写文件、浏览网络
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS 12+ / Ubuntu 20.04+ / Debian 11+ / CentOS 8+ |
| Node.js | v22 或更高版本 |
| 内存 | 最低 2GB，推荐 4GB+ |
| 磁盘空间 | 最低 1GB |
# 下载并运行安装脚本
curl -fsSL https://raw.githubusercontent.com/miaoxworld/ClawdBotInstaller/main/install.sh | bash安装脚本会自动：
- 检测系统环境并安装依赖
- 安装 ClawdBot
- 引导完成核心配置（AI模型、身份信息）
- 测试 API 连接
- 自动启动 ClawdBot 服务
- 可选打开配置菜单进行详细配置（渠道等）
# 1. 克隆仓库
git clone https://github.com/miaoxworld/ClawdBotInstaller.git
cd ClawdBotInstaller
# 2. 添加执行权限
chmod +x install.sh config-menu.sh
# 3. 运行安装脚本
./install.sh安装完成后脚本会：
- 自动询问是否启动服务（推荐选择 Y）
- 后台启动 ClawdBot Gateway
- 可选打开配置菜单进行渠道配置
如果需要后续管理：
# 手动启动服务
source ~/.clawdbot/env && clawdbot gateway
# 后台启动服务
clawdbot gateway start
# 运行配置菜单进行详细配置
bash ~/.clawdbot/config-menu.sh
# 或从 GitHub 下载运行
curl -fsSL https://raw.githubusercontent.com/miaoxworld/ClawdBotInstaller/main/config-menu.sh | bash运行配置菜单后选择 [2] AI 模型配置，可选择多种 AI 提供商：
- 在配置菜单中选择 Anthropic Claude
- 先输入自定义 API 地址（留空使用官方 API）
- 输入 API Key（官方 Key 从 Anthropic Console 获取）
- 选择模型（推荐 claude-sonnet-4-5-20250929）
💡 支持 OneAPI/NewAPI 等第三方代理服务，只需填入对应的 API 地址和 Key
- 在配置菜单中选择 OpenAI GPT
- 先输入自定义 API 地址（留空使用官方 API）
- 输入 API Key（官方 Key 从 OpenAI Platform 获取）
- 选择模型
⚠️ 中转服务要求: 如使用自定义 API 地址，中转服务必须支持 OpenAI 的 Responses API (v1/responses路径)，而非仅支持传统的 Chat Completions API (v1/chat/completions)。部分老旧或功能不全的中转服务可能不支持此接口，请提前确认。
# 1. 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# 2. 下载模型
ollama pull llama3
# 3. 在配置菜单中选择 Ollama
# 输入服务地址：http://localhost:11434- 访问 Groq Console 获取 API Key
- 在配置菜单中选择 Groq
- 输入 API Key
- 选择模型（推荐 llama-3.3-70b-versatile）
- 访问 Google AI Studio 获取 API Key
- 在配置菜单中选择 Google Gemini
- 输入 API Key
- 选择模型（推荐 gemini-2.0-flash）
- 访问 OpenRouter 获取 API Key
- 在配置菜单中选择 OpenRouter
- 输入 API Key
- 选择模型（推荐 anthropic/claude-sonnet-4）
- 访问 Mistral Console 获取 API Key
- 在配置菜单中选择 Mistral AI
- 输入 API Key
- 选择模型（推荐 mistral-large-latest）
- 在 Telegram 中搜索
@BotFather - 发送
/newbot创建新机器人 - 设置机器人名称和用户名
- 复制获得的 Bot Token
- 搜索
@userinfobot获取你的 User ID - 在配置菜单中选择 Telegram，输入以上信息
- 访问 Discord Developer Portal
- 点击 "New Application" 创建应用
- 进入 "Bot" 页面，点击 "Add Bot"
- 复制 Bot Token
- 在 "OAuth2" → "URL Generator" 中生成邀请链接
- 邀请机器人到你的服务器
- 获取目标频道的 Channel ID（右键频道 → 复制 ID）
- 在配置菜单中输入以上信息
💡 无需公网服务器：ClawdBot 使用飞书的 WebSocket 长连接模式接收事件，无需配置 Webhook 地址。
- 访问 飞书开放平台
- 创建企业自建应用（个人账号即可，无需企业认证）
- 添加机器人能力：
- 进入路径：开发者后台 → 应用详情 → 添加应用能力
- 确认：确保"机器人"开关是打开状态
- 获取 App ID 和 App Secret
- 在"权限管理"中添加权限：
im:message(收发消息)im:message:send_as_bot(发送消息)im:chat:readonly(读取会话信息)
- 发布应用：版本管理与发布 → 创建版本 → 发布
- 在配置菜单中配置飞书：输入 App ID 和 App Secret，启动 ClawdBot 服务
- 配置"事件订阅"（使用长连接）：
- 进入：事件与回调 → 选择「使用长连接接收事件」
- 添加事件：
im.message.receive_v1（接收消息） - 无需填写 Webhook 地址
⚠️ 注意：需要 ClawdBot 服务已启动，才能保存长连接设置
- 添加机器人到群组：群设置 → 群机器人 → 添加机器人
# 启动服务（后台守护进程）
clawdbot gateway start
# 停止服务
clawdbot gateway stop
# 重启服务
clawdbot gateway restart
# 查看服务状态
clawdbot gateway status
# 前台运行（用于调试）
clawdbot gateway
# 查看日志
clawdbot logs
# 实时日志
clawdbot logs --follow# 打开配置文件
clawdbot config
# 运行配置向导
clawdbot onboard
# 诊断配置问题
clawdbot doctor
# 健康检查
clawdbot health# 导出对话历史
clawdbot export --format json
# 清理记忆
clawdbot memory clear
# 备份数据
clawdbot backupClawdBot 使用以下配置方式：
- 环境变量:
~/.clawdbot/env- 存储 API Key 和 Base URL - ClawdBot 配置:
~/.clawdbot/clawdbot.json- ClawdBot 内部配置（自动管理） - 命令行工具:
clawdbot config set/clawdbot models set等
💡 注意：配置主要通过安装向导或
config-menu.sh完成，无需手动编辑配置文件
~/.clawdbot/env 文件内容：
# ClawdBot 环境变量配置
export ANTHROPIC_API_KEY=sk-ant-xxxxx
export ANTHROPIC_BASE_URL=https://your-api-proxy.com # 可选，自定义 API 地址
# 或者 OpenAI
export OPENAI_API_KEY=sk-xxxxx
export OPENAI_BASE_URL=https://your-api-proxy.com/v1 # 可选当使用自定义 API 地址时，安装脚本会自动在 ~/.clawdbot/clawdbot.json 中配置自定义 Provider：
{
"models": {
"providers": {
"anthropic-custom": {
"baseUrl": "https://your-api-proxy.com",
"apiKey": "your-api-key",
"models": [
{
"id": "claude-sonnet-4-5-20250929",
"name": "claude-sonnet-4-5-20250929",
"api": "anthropic-messages",
"input": ["text"],
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}~/.clawdbot/
├── clawdbot.json # ClawdBot 核心配置
├── env # 环境变量 (API Key 等)
├── backups/ # 配置备份
└── logs/ # 日志文件 (由 ClawdBot 管理)
⚠️ 重要警告：ClawdBot 需要完全的计算机权限，请务必注意安全！
- 不要在主工作电脑上部署 - 建议使用专用服务器或虚拟机
- 使用 AWS/GCP/Azure 免费实例 - 隔离环境更安全
- Docker 部署 - 提供额外的隔离层
-
禁用危险功能（默认已禁用）
security: enable_shell_commands: false enable_file_access: false
-
启用沙箱模式
security: sandbox_mode: true
-
限制允许的用户
channels: telegram: allowed_users: - "only-your-user-id"
- 定期轮换 API Key
- 不要在公开仓库中提交配置文件
- 使用环境变量存储敏感信息
# 使用环境变量
export ANTHROPIC_API_KEY="sk-ant-xxx"
export TELEGRAM_BOT_TOKEN="xxx"# macOS
brew install node@22
brew link --overwrite node@22
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs- 检查配置文件是否正确
- 运行诊断命令：
clawdbot doctor - 查看日志：
clawdbot logs
- 确认 Bot Token 正确
- 确认 User ID 在 allowed_users 列表中
- 检查网络连接（可能需要代理）
# 使用 npm 更新
npm update -g clawdbot
# 或使用配置菜单
./config-menu.sh
# 选择 [7] 高级设置 → [7] 更新 ClawdBot# 手动备份
cp -r ~/.clawdbot ~/clawdbot_backup_$(date +%Y%m%d)
# 使用命令备份
clawdbot backup# 停止服务
clawdbot gateway stop
# 卸载程序
npm uninstall -g clawdbot
# 删除配置（可选）
rm -rf ~/.clawdbot- 🎉 首次发布
- ✨ 支持一键安装部署
- ✨ 交互式配置菜单
- ✨ 多模型支持 (Claude/GPT/Ollama)
- ✨ 多渠道支持 (Telegram/Discord/WhatsApp)
- ✨ 技能系统
- ✨ 安全配置
本项目基于 MIT 许可证开源。
Made with ❤️ by miaoxworld