安装向导

系统要求

操作系统：macOS 或 Linux（Windows 请使用 WSL）。Python ≥ 3.11。Node.js ≥ 18。架构：x86_64 或 arm64。包管理器：pnpm（自动安装）。

一键安装

推荐方式：从官网安装
curl -fsSL https://releases.semibot.ai/install.sh | bash

安装完成后执行：
semibot init
semibot ui

如果需要从源码安装：
git clone https://github.com/GoatGit/semibot.git
cd semibot
bash scripts/install.sh

安装后初始化

运行 semibot init 初始化本地配置。默认主路径是安装完成后先执行一次 semibot init，再执行 semibot ui。支持参数：--runtime-host（默认 127.0.0.1）、--runtime-port（默认 8765）、--api-port（默认 3001）、--web-port（默认 3000）、--default-model（默认 LLM 模型）、--openai-api-key、--anthropic-api-key、--interactive（交互式引导）。

semibot init

健康检查

运行 semibot doctor 验证环境。检查项：目录结构是否完整且可写、Python/Node.js/pnpm 版本、端口是否可用（runtime/api/web）、API Key 是否配置、服务运行状态。

semibot doctor

启动服务

推荐主路径：semibot ui — 启动所有本地服务并自动打开浏览器。semibot status — 查看服务运行状态。semibot down — 停止所有服务。高级场景可使用 semibot up 单独启动服务。

semibot ui
semibot status

环境变量

目录结构

~/.semibot/
├── config/
│   └── config.yaml
├── data/
├── logs/
├── run/
├── env/
│   └── default.env
└── releases/
    ├── current -> <version>/
    └── <version>/
        └── workspace/