SemibotCLI 使用文档
先看最常用的命令，再按场景往下找详细参数。
大多数情况下，你先记住这几条就够了：semibot init、semibot doctor、semibot ui、semibot status、semibot chat、semibot run。
服务管理
semibot init — 初始化本地目录和配置。
semibot doctor — 做环境检查，排查问题先用它。
semibot up — 启动整套本地服务。
semibot down — 停止整套本地服务。
semibot status — 查看 runtime、API 和 Web 是否正常。
semibot logs [service] — 看日志。
semibot serve start|stop|restart — 单独管理执行服务。
semibot ui — 启动本地入口，支持 --no-open、--no-runtime 等选项。
semibot upgrade — 安装或切换版本。
semibot version — 查看当前 CLI 版本。会话与对话
semibot chat — 开始交互式对话，可指定 agent、session、model 或 system prompt。
semibot run <task> — 跑一次任务，适合单次执行。
semibot sessions list — 列出已有会话。
semibot sessions show <id> — 查看某个会话的时间线。
semibot sessions export <id> --out file.md — 导出会话。
semibot sessions resume <id> — 接着之前的会话继续。配置管理
semibot configure — 交互式配置向导。
semibot configure show — 查看当前完整配置。
semibot configure get <key> — 读取某个配置值（如 llm.default_model）。
semibot configure set <key> <value> — 写入配置值。
semibot configure unset <key> — 删除配置项。Gateway 管理
semibot gateway list — 列出消息入口实例。
semibot gateway show <id> — 查看实例详情。
semibot gateway create --provider telegram/feishu/discord/whatsapp/imessage — 新建实例。
semibot gateway update <id> --patch '{...}' — 更新实例。
semibot gateway delete <id> — 删除实例。
semibot gateway test <id> — 发一条测试消息。
semibot gateway webhook-set --provider telegram --url <url> — 注册 Webhook。
semibot gateway webhook-check — 检查 Webhook 状态。
semibot gateway doctor — 检查入口配置。
semibot gateway migrate-env — 把环境变量迁到本地 SQLite 配置。
semibot gateway batch --action enable/disable/delete — 批量管理实例。技能与工具
semibot skills list — 看有哪些技能可用。
semibot skills install <source> — 安装技能。
semibot skills validate <target> — 校验技能。
semibot skills remove <name> — 删除技能。
semibot tools list — 列出内建工具。
semibot tools run <name> --args '{...}' — 直接执行某个工具。
semibot mcp list — 列出 MCP 服务。
semibot mcp test <server> — 测试 MCP 连接。
semibot mcp call <server> <tool> --args '{...}' — 调用 MCP 工具。事件与规则
semibot events list — 列出事件，可按时间、类型和数量过滤。
semibot events show <id> — 查看事件详情。
semibot events replay <id> — 回放事件。
semibot events publish <type> --payload '{...}' — 发布自定义事件。
semibot rules list — 列出规则。
semibot rules show <id> — 查看规则详情。
semibot rules enable/disable <id> — 启用或停用规则。
semibot rules create --file rule.json — 创建规则。
semibot rules test --event event.json --rules rules.json — 测试规则是否命中。审批管理
semibot approvals list — 列出审批，可按状态过滤。
semibot approvals show <id> — 查看审批详情。
semibot approvals approve <id> --reason '...' — 通过审批。
semibot approvals reject <id> --reason '...' — 拒绝审批。
semibot approvals watch — 实时查看审批变化。记忆管理
semibot memory search <query> — 搜索记忆。
semibot memory write --content '...' — 写入记忆。
semibot memory sessions <id> — 查看某个会话的记忆上下文。
semibot memory consolidate <id> — 整理会话记忆。
semibot memory stats — 查看记忆统计。全局选项
--output json/table/yaml/ndjson — 指定输出格式。
--json — 强制 JSON 输出。
--verbose — 带上 CLI 元数据。
--no-color — 关闭 ANSI 颜色。
--log-level DEBUG/INFO/WARNING/ERROR — 设置日志级别。
--yes — 跳过确认提示。
退出码：0 成功、1 一般错误、2 参数错误。