Windows安装Octop实战：PowerShell一键安装自托管AI助手的完整指南
【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop
Octop是一个开源、自托管的 AI 助手，支持多用户、多 Agent 协作，拥有 Web 控制台、CLI、IM 通道和定时任务等能力。在 Windows 上安装它非常简单：无需预装 Python，一条 PowerShell 命令即可完成下载、环境创建和命令注册。本文带你走完安装、启动、登录控制台的全流程。
📋 安装前准备：3 项检查
| 检查项 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10/11 | amd64 与 ARM64 均支持 |
| Python | ❌ 不需要 | 脚本通过 uv 自动在~/.octop/下创建隔离的 Python 3.12 虚拟环境 |
| 网络 | 可访问外网 | 用于下载安装脚本与依赖 |
安装脚本源码见 install.ps1，官方中文说明见 README_CN.md。
🚀 PowerShell 一键安装命令
以普通用户打开 PowerShell（开始菜单搜索PowerShell回车即可），执行：
irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex脚本自动完成了这 6 件事
- 检测并安装 uv—— 若系统已有
uv则直接复用； - 创建隔离虚拟环境—— 在
C:\Users\<你>\.octop\venv安装 Python 3.12，不污染系统 Python； - 从 PyPI 安装 octop 包并自动处理依赖；
- 生成命令包装器—— 创建
~/.octop/bin/octop.ps1和octop.cmd； - 写入用户 PATH—— 自动把
~/.octop\bin加入用户环境变量； - 自检验证—— 导入核心模块，确认安装成功。
💡 若系统 PowerShell 执行策略为
Restricted，脚本会自动为你切换为RemoteSigned（仅限当前用户），无需手动干预。
🔁 其他安装方式
方式二：cmd 批处理（不习惯 PowerShell 时）：
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.bat -o install.bat install.bat方式三：本地脚本（已克隆仓库时），在仓库根目录执行：
powershell -ExecutionPolicy Bypass -File scripts/install.ps1| 常用参数 | 作用 | 示例 |
|---|---|---|
-Version | 指定版本 | -Version 0.9.33 |
-FromSource | 从源码安装 | 配合-SourceDir <目录>可指定本地源码 |
-Extras | 附加组件 | -Extras browser安装 Playwright Chromium（远程浏览器自动化） |
完整选项见 scripts/README.md。
✅ 验证安装是否成功
重新打开一个新终端（PATH 需要新会话才生效），运行：
octop --version能看到版本号即安装成功。若提示octop 不是内部或外部命令，说明 PATH 尚未生效，关闭当前窗口重开即可。
🖥️ 初始化并启动 Web 控制台
# 1. 初始化数据库与管理员账号（交互式设置密码） octop init # 2. 前台运行（API + Web 控制台） octop run # 3. 或注册为 Windows 系统服务，开机自启 octop service start随后打开浏览器访问http://127.0.0.1:8088，用刚才设置的管理员账号登录，即可看到 Web 控制台：
登录后可先在「设置 → 模型」中配置你的大模型供应商与 API Key：
配置完成后即可与 Agent 对话，多 Agent、知识库、IM 通道与定时任务均可在控制台管理：
❓ 常见问题速查
Q：想装远程浏览器自动化能力？安装时加参数即可（若系统已装有 Chrome，脚本会直接复用，跳过 Chromium 下载）：
irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex # 先安装 # 然后补装浏览器组件： ~\.octop\venv\Scripts\python.exe -m playwright install chromiumQ：想升级到最新版？
octop updateQ：数据存在哪里？全部位于~/.octop/：虚拟环境在venv/，命令包装器在bin/，默认数据库为octop.db（SQLite，可选 PostgreSQL）。备份该目录即可完整迁移。
📎 相关资源
- 安装脚本：scripts/install.ps1、scripts/install.bat
- 安装选项详解：scripts/README.md
- 完整用户指南：docs/user-guide.md
- 架构说明：docs/architecture.md
按以上步骤操作，5 分钟内你就能在 Windows 上拥有一个数据完全留在本地的自托管 AI 助手 🐙
【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
