🔗 https://github.com/miaoxworld/ClawdBotInstaller

📖 目录

✨ 功能特性

🤖 多模型支持

主流服务商:

  • Anthropic Claude – Claude Opus 4 / Sonnet 4 / Haiku (支持自定义 API 地址)

  • OpenAI GPT – GPT-4o / GPT-4 Turbo / o1 (支持自定义 API 地址)

  • Google Gemini – Gemini 2.0 Flash / 1.5 Pro

  • xAI Grok – Grok 4 / Grok 3 / Grok 2 Vision (Elon Musk 的 AI)

多模型网关:

  • OpenRouter – 多模型网关，一个 Key 用遍所有模型

  • OpenCode – 免费多模型 API，支持 Claude/GPT/Gemini/GLM

快速推理:

  • Groq – 超快推理，Llama 3.3 / Mixtral

  • Mistral AI – Mistral Large / Codestral

本地/企业:

  • Ollama – 本地部署，无需 API Key

  • Azure OpenAI – 企业级 Azure 部署

国产模型:

  • 智谱 GLM (Zai) – GLM-4.7 / GLM-4.6 (中国领先 AI)

  • MiniMax – MiniMax-M2 系列 (支持国内/国际版)

实验性:

  • Google Gemini CLI – Gemini 3 预览版

  • Google Antigravity – Google 实验性多模型 API

💡 自定义 API 地址: Anthropic Claude 和 OpenAI GPT 都支持自定义 API 地址，可接入 OneAPI/NewAPI/API 代理等服务。配置时先输入自定义地址，再输入 API Key。

📱 多渠道接入

  • Telegram Bot

  • Discord Bot

  • WhatsApp

  • 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

安装脚本会自动：

  1. 检测系统环境并安装依赖

  2. 安装 ClawdBot

  3. 引导完成核心配置（AI模型、身份信息）

  4. 测试 API 连接

  5. 自动启动 ClawdBot 服务

  6. 可选打开配置菜单进行详细配置（渠道等）

方式二：手动安装

# 1. 克隆仓库
git clone https://github.com/miaoxworld/ClawdBotInstaller.git
cd ClawdBotInstaller

# 2. 添加执行权限
chmod +x install.sh config-menu.sh

# 3. 运行安装脚本
./install.sh

安装完成后

安装完成后脚本会：

  1. 自动询问是否启动服务（推荐选择 Y）

  2. 后台启动 ClawdBot Gateway

  3. 可选打开配置菜单进行渠道配置

如果需要后续管理：

# 手动启动服务
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

⚙ 详细配置

配置 AI 模型

运行配置菜单后选择 [2] AI 模型配置，可选择多种 AI 提供商：

Anthropic Claude 配置

  1. 在配置菜单中选择 Anthropic Claude

  2. 先输入自定义 API 地址（留空使用官方 API）

  3. 输入 API Key（官方 Key 从 Anthropic Console 获取）

  4. 选择模型（推荐 Sonnet 4）

💡 支持 OneAPI/NewAPI 等第三方代理服务，只需填入对应的 API 地址和 Key

OpenAI GPT 配置

  1. 在配置菜单中选择 OpenAI GPT

  2. 先输入自定义 API 地址（留空使用官方 API）

  3. 输入 API Key（官方 Key 从 OpenAI Platform 获取）

  4. 选择模型

Ollama 本地模型

# 1. 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 2. 下载模型
ollama pull llama3

# 3. 在配置菜单中选择 Ollama
# 输入服务地址：http://localhost:11434

Groq (超快推理)

  1. 访问 Groq Console 获取 API Key

  2. 在配置菜单中选择 Groq

  3. 输入 API Key

  4. 选择模型（推荐 llama-3.3-70b-versatile）

Google Gemini

  1. 访问 Google AI Studio 获取 API Key

  2. 在配置菜单中选择 Google Gemini

  3. 输入 API Key

  4. 选择模型（推荐 gemini-2.0-flash）

配置 Telegram 机器人

  1. 在 Telegram 中搜索 @BotFather

  2. 发送 /newbot 创建新机器人

  3. 设置机器人名称和用户名

  4. 复制获得的 Bot Token

  5. 搜索 @userinfobot 获取你的 User ID

  6. 在配置菜单中选择 Telegram，输入以上信息

配置 Discord 机器人

  1. 访问 Discord Developer Portal

  2. 点击 “New Application” 创建应用

  3. 进入 “Bot” 页面，点击 “Add Bot”

  4. 复制 Bot Token

  5. 在 “OAuth2” → “URL Generator” 中生成邀请链接

  6. 邀请机器人到你的服务器

  7. 获取目标频道的 Channel ID（右键频道 → 复制 ID）

  8. 在配置菜单中输入以上信息

配置飞书机器人

  1. 访问 飞书开放平台

  2. 创建企业自建应用，选择”机器人”能力

  3. 获取 App ID 和 App Secret

  4. 在”权限管理”中添加权限：

    • im:message.receive_v1 (接收消息)

    • im:message:send_as_bot (发送消息)

    • im:chat:readonly (读取会话信息)

  5. 配置”事件订阅”：

    • 请求地址：https://你的服务器:18789/channels/feishu/webhook

    • 添加事件：im.message.receive_v1

  6. 发布应用并添加到群组

  7. 在配置菜单中选择飞书，输入以上信息

📝 常用命令

服务管理

# 启动服务（后台守护进程）
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 backup

📋 配置说明

ClawdBot 使用以下配置方式：

  • 环境变量: ~/.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  # 可选

自定义 Provider 配置

当使用自定义 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 需要完全的计算机权限，请务必注意安全！

部署建议

  1. 不要在主工作电脑上部署 – 建议使用专用服务器或虚拟机

  2. 使用 AWS/GCP/Azure 免费实例 – 隔离环境更安全

  3. Docker 部署 – 提供额外的隔离层

权限控制

  1. 禁用危险功能（默认已禁用）

    security:
  enable_shell_commands: false
  enable_file_access: false

  2. 启用沙箱模式

    security:
  sandbox_mode: true

  3. 限制允许的用户

    channels:
  telegram:
    allowed_users:
      - "only-your-user-id"

API Key 安全

  • 定期轮换 API Key

  • 不要在公开仓库中提交配置文件

  • 使用环境变量存储敏感信息

# 使用环境变量
export ANTHROPIC_API_KEY="sk-ant-xxx"
export TELEGRAM_BOT_TOKEN="xxx"

❓ 常见问题

Q: 安装时提示 Node.js 版本过低？

# 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

Q: 启动后无法连接？

  1. 检查配置文件是否正确

  2. 运行诊断命令：clawdbot doctor

  3. 查看日志：clawdbot logs

Q: Telegram 机器人没有响应？

  1. 确认 Bot Token 正确

  2. 确认 User ID 在 allowed_users 列表中

  3. 检查网络连接（可能需要代理）

Q: 如何更新到最新版本？

# 使用 npm 更新
npm update -g clawdbot

# 或使用配置菜单
./config-menu.sh
# 选择 [7] 高级设置 → [7] 更新 ClawdBot

Q: 如何备份数据？

# 手动备份
cp -r ~/.clawdbot ~/clawdbot_backup_$(date +%Y%m%d)

# 使用命令备份
clawdbot backup

Q: 如何完全卸载？

# 停止服务
clawdbot gateway stop

# 卸载程序
npm uninstall -g clawdbot

# 删除配置（可选）
rm -rf ~/.clawdbot

📜 更新日志

v1.0.0 (2026-01-29)

  • 🎉 首次发布

  • ✨ 支持一键安装部署

  • ✨ 交互式配置菜单

  • ✨ 多模型支持 (Claude/GPT/Ollama)

  • ✨ 多渠道支持 (Telegram/Discord/WhatsApp)

  • ✨ 技能系统

  • ✨ 安全配置

​ 

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。