ComindX
GitHub EN
安装

安装 Comobot：四种方式，按需选择

支持 Mac/Linux、Windows、Docker 与源码安装，已同步最新版安装文档。

comobot — install 
# 官方脚本（自动判断网络，国内自动切镜像）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/musenming/comobot/main/scripts/install.sh)"

# 国内镜像（GitHub 不可达时）
/bin/bash -c "$(curl -fsSL https://dl.comindx.com/scripts/install.sh)"

# 安装完成后启动
comobot gateway
# PowerShell（管理员）
irm https://raw.githubusercontent.com/musenming/comobot/main/scripts/install.ps1 | iex

# 国内镜像
irm https://dl.comindx.com/scripts/install.ps1 | iex

# 安装完成后启动
comobot gateway
curl -fsSL https://github.com/musenming/comobot/releases/latest/download/comobot-docker.zip -o comobot-docker.zip
unzip comobot-docker.zip && cd comobot-docker

# 启动服务（首次会拉取镜像，约 1-2 分钟）
docker compose up -d

# 查看运行状态
docker compose ps
git clone https://github.com/musenming/comobot.git
cd comobot

python3.11 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

pip install --upgrade pip setuptools wheel
pip install -e ".[dev]"

# 构建前端
cd web && npm install && npm run build && cd ..

# 启动
comobot gateway

初始化配置

1. 系统要求

  • Mac / Linux：macOS 12+ 或 Ubuntu 20.04+ / Debian 11+
  • Windows：Windows 10 1903+ / Windows 11（PowerShell 5.1+）
  • Docker 方式：需要本地 Docker Desktop 环境

2. 首次引导

comobot onboard

完成模型与基础参数配置（脚本安装通常会自动触发首次引导）。

3. 启动服务

# 首次初始化
comobot onboard

# 启动服务
comobot gateway

网关启动后可通过本地 UI 与 API 使用 Comobot。

4. Docker 访问

Docker 部署完成后，浏览器访问 http://localhost:18790 完成向导。

数据默认持久化在 Docker Volume comobot-data。

聊天渠道接入

支持 11 个聊天平台，点击展开查看接入指南。

渠道 类型 状态
Telegram IM 可用
Discord IM 可用
WhatsApp IM 可用
飞书 IM 可用
Mochat IM 可用
钉钉 IM 可用
Slack IM 可用
Email IM 可用
QQ IM 可用
微信 IM 可用
企业微信 IM 可用
Matrix IM 可用
Telegram 通过 BotFather 创建 Bot，获取 Token 即可接入。
  1. 在 Telegram 中找到 @BotFather
  2. 发送 /newbot 创建机器人
  3. 将 Bot Token 填入 config.json
  4. 启动 comobot gateway
Discord 创建 Discord Application，启用 Bot 和消息意图。
  1. 访问 Discord Developer Portal
  2. 创建 Application → Bot
  3. 启用 Message Content Intent
  4. 填入 Bot Token，启动网关
WhatsApp 通过 WhatsApp Business API 或 bridge 方式接入。
  1. 安装 bridge 依赖：cd bridge && npm install
  2. 构建 bridge：npm run build
  3. 登录 WhatsApp：comobot channels login
  4. 扫码完成绑定
飞书 在飞书开放平台创建应用，配置事件订阅。
  1. 登录飞书开放平台
  2. 创建企业自建应用
  3. 配置消息事件订阅 URL
  4. 填入 App ID 和 Secret
Mochat Mochat 自托管即时通讯平台接入。
  1. 部署 Mochat 服务端
  2. 创建 Bot 账号
  3. 配置 Webhook URL
  4. 启动 comobot gateway
钉钉 在钉钉开放平台创建企业内部应用。
  1. 登录钉钉开放平台
  2. 创建企业内部机器人
  3. 配置消息回调地址
  4. 填入 AppKey 和 AppSecret
Slack 创建 Slack App，启用 Event Subscriptions。
  1. 访问 api.slack.com/apps
  2. 创建 New App → From Manifest
  3. 启用 Event Subscriptions
  4. 安装到 Workspace，填入 Token
Email 通过 IMAP/SMTP 协议接入邮箱通道。
  1. 配置 IMAP 收信服务器
  2. 配置 SMTP 发信服务器
  3. 填入邮箱账号和授权码
  4. 启动 comobot gateway
QQ 通过 QQ 开放平台创建机器人应用。
  1. 登录 QQ 开放平台
  2. 创建机器人应用
  3. 配置沙箱环境测试
  4. 获取 AppID 和 Token
微信 接入微信机器人。
  1. 发消息给 comobot：配置微信
  2. 获取二维码，并扫码
  3. 回复已完成
  4. 等待重启 comobot gateway 并验证收发消息
企业微信 在企业微信管理后台创建自建应用。
  1. 登录企业微信管理后台
  2. 创建自建应用
  3. 配置接收消息 API
  4. 填入 CorpID 和 Secret
Matrix 接入 Matrix 协议，支持 Element 等客户端。
  1. 安装 Matrix 支持：pip install -e ".[matrix]"
  2. 注册 Matrix 账号
  3. 获取 Access Token
  4. 配置 Homeserver URL