ComindX | 使用

全局选项

comobot --version, -v

显示当前版本号

comobot --help

显示帮助信息

命令一览

命令	说明
`comobot onboard`	初始化配置与工作区
`comobot agent`	与 Agent 交互对话
`comobot gateway`	启动网关（API + Web + 渠道）
`comobot gateway restart`	重启网关（后台）
`comobot channels status`	查看渠道状态
`comobot channels login`	通过扫码连接渠道设备
`comobot status`	查看运行状态
`comobot update`	自动更新到最新版本
`comobot uninstall`	卸载 comobot
`comobot stats`	查看 GitHub Release 下载统计
`comobot provider login`	OAuth 登录 LLM 提供商

命令详情

comobot onboard

初始化 comobot 配置文件和工作区。

comobot onboard

创建 ~/.comobot/config.json（如已存在，可选覆盖或保留刷新）
创建 ~/.comobot/workspace/ 工作区并同步模板
初始化完成后提示配置 API Key

comobot agent

与 Agent 进行交互对话，支持单次消息或交互式会话。

comobot agent                        # 进入交互式对话
comobot agent -m "Hello!"           # 发送单条消息
comobot agent -s "my-session"       # 指定会话 ID
comobot agent --no-markdown         # 禁用 Markdown 渲染
comobot agent --logs                # 显示运行时日志

选项	说明
`-m, --message`	发送单条消息（非交互模式）
`-s, --session`	会话 ID（默认 `cli:direct`）
`--markdown / --no-markdown`	是否渲染 Markdown（默认开启）
`--logs / --no-logs`	是否显示运行时日志

comobot gateway

启动 comobot 网关，包含 FastAPI 服务、Web 控制台和渠道连接。

comobot gateway                     # 默认端口 18790
comobot gateway -p 8080             # 自定义端口
comobot gateway -v                  # 详细日志输出

选项	说明
`-p, --port`	网关端口（默认 `18790`）
`-v, --verbose`	详细日志输出

启动后自动打开 Web 控制台 http://localhost:<port>。

comobot gateway restart

重启网关进程（停止旧进程，后台启动新进程）。

comobot gateway restart
comobot gateway restart -p 8080 -v

comobot channels status

查看所有渠道的启用状态和配置信息。

comobot channels status

显示 WhatsApp、Discord、Feishu、Telegram、Slack、DingTalk、QQ、WeChat、Matrix、Email 等渠道的状态。

comobot channels login

通过扫码连接渠道设备。

comobot channels login              # 默认 WhatsApp
comobot channels login whatsapp
comobot channels login wechat

comobot status

查看 comobot 的配置和运行状态。

comobot status

配置文件路径及是否存在
工作区路径及是否存在
当前模型
各 LLM 提供商的 API Key 配置状态

comobot update

自动检测安装方式并更新到最新版本。

comobot update                      # 交互式确认
comobot update -y                   # 跳过确认直接更新

选项	说明
`-y, --yes`	跳过确认提示

自动检测安装方式：

安装方式	检测条件	更新方式
Docker	检测 `/.dockerenv` 或 cgroup	`docker pull`
Binary	PyInstaller 运行时或 `~/.comobot/bin/`	从 GitHub Releases 下载
pip	以上均不满足	`pip install --upgrade`

支持平台：macOS (arm64/x64)、Linux (arm64/x64)、Windows (x64)。

comobot uninstall

卸载 comobot。

comobot uninstall                   # 仅移除二进制和 PATH
comobot uninstall --all             # 同时移除所有数据
comobot uninstall -y                # 跳过确认

选项	说明
`--all`	同时删除 `~/.comobot/` 下所有数据
`-y, --yes`	跳过确认提示

comobot stats

查看 GitHub Release 的下载统计。

comobot stats

comobot provider login

通过 OAuth 登录 LLM 提供商。

comobot provider login openai-codex
comobot provider login github-copilot

支持的 OAuth 提供商：

openai-codex — OpenAI Codex（通过 oauth-cli-kit）
github-copilot — GitHub Copilot（设备授权流程）