🔗 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 文件定义自定义能力

• 远程控制 - 可执行系统命令、读写文件、浏览网络

# 下载并运行安装脚本
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

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

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

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

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

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

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

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

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

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

4. 选择模型

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

# 2. 下载模型
ollama pull llama3

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

1. 访问 Groq Console 获取 API Key

2. 在配置菜单中选择 Groq

3. 输入 API Key

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

1. 访问 Google AI Studio 获取 API Key

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

3. 输入 API Key

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

1. 在 Telegram 中搜索 @BotFather

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

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

4. 复制获得的 Bot Token

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

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

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  # 可选

当使用自定义 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

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

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

# 使用环境变量
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

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

2. 运行诊断命令：clawdbot doctor

3. 查看日志：clawdbot logs

1. 确认 Bot Token 正确

2. 确认 User ID 在 allowed_users 列表中

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

# 使用 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)

• ✨ 技能系统

• ✨ 安全配置

🔗 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 文件定义自定义能力

• 远程控制 - 可执行系统命令、读写文件、浏览网络

# 下载并运行安装脚本
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

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

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

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

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

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

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

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

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

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

4. 选择模型

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

# 2. 下载模型
ollama pull llama3

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

1. 访问 Groq Console 获取 API Key

2. 在配置菜单中选择 Groq

3. 输入 API Key

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

1. 访问 Google AI Studio 获取 API Key

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

3. 输入 API Key

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

1. 在 Telegram 中搜索 @BotFather

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

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

4. 复制获得的 Bot Token

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

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

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  # 可选

当使用自定义 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

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

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

# 使用环境变量
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

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

2. 运行诊断命令：clawdbot doctor

3. 查看日志：clawdbot logs

1. 确认 Bot Token 正确

2. 确认 User ID 在 allowed_users 列表中

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

# 使用 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)

• ✨ 技能系统

• ✨ 安全配置