安装向导

系统要求

推荐 macOS 或 Linux。Windows 请使用 WSL。环境上至少准备好 Python 3.11、Node.js 20，以及可用的终端环境。源码开发还会用到 pnpm。

一键安装

最省事的方式是直接跑安装脚本：
curl -fsSL https://releases.semibot.ai/install.sh | bash

装好以后，先执行：
semibot init
semibot ui

如果你是从源码开发，再走下面这条：
git clone https://github.com/GoatGit/semibot.git
cd semibot
pnpm install
python3 -m venv runtime/.venv
runtime/.venv/bin/pip install -r runtime/requirements.txt

安装后先做什么

先跑 semibot init，把本地目录、配置和环境文件准备好。大多数情况下直接执行一次就够了，只有在你要改端口、模型或 API Key 时，才需要额外带参数。

semibot init

安装不顺时怎么查

如果启动不起来，先跑 semibot doctor。它会帮你检查目录权限、依赖版本、端口占用、API Key 和服务状态，是最直接的排查入口。

semibot doctor

怎么启动

通常直接运行 semibot ui 就够了，它会把本地入口拉起来。想看状态就用 semibot status；只启动服务可用 semibot up；只管执行服务可用 semibot serve start；整套停掉用 semibot down。

semibot ui
semibot status

环境变量

目录结构

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

FAQ

下一步