# intellect-agent **Repository Path**: ontoweb/intellect-agent ## Basic Information - **Project Name**: intellect-agent - **Description**: INTELLECT Agent Loop 社区版 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-20 - **Last Updated**: 2026-10-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Intellect Agent (社区版)

Documentation Discord License: MIT Built by ONTOWEB English

**由 [ONTOWEB](https://ontoweb.cn) 构建的自进化 AI 代理。** 它是一个基于PYTHON与RUST的面向个人和小团队使用的多智能调度引擎，同时集成了第三方优秀的Web界面工具。 --- ## 快速安装 > **GitHub 用户**：使用每条下的第一个命令。**Gitee（国内）用户**：使用第二个命令。脚本完全相同，仅下载源不同。 ### Linux, macOS, WSL2 ```bash # GitHub curl -fsSL https://raw.githubusercontent.com/ontoweb-cn/intellect-agent/main/scripts/install.sh | bash # Gitee（国内） curl -fsSL https://raw.giteeusercontent.com/ontoweb/intellect-agent/raw/main/scripts/install.sh | bash ``` > 安装程序创建虚拟环境、安装 Python 依赖，并编译 Rust 扩展（`intellect_community_core`）。 ### Windows（原生 PowerShell） ```powershell # GitHub iex (irm https://raw.githubusercontent.com/ontoweb-cn/intellect-agent/main/scripts/install.ps1) # Gitee（国内） iex (irm https://raw.giteeusercontent.com/ontoweb/intellect-agent/raw/main/scripts/install.ps1) ``` 安装程序自动处理：uv、Python 3.12、Node.js、ripgrep、ffmpeg 和便携式 Git Bash。 > **Windows Rust 扩展：** 安装程序优先从 Gitee Releases 下载预编译 wheel，失败则通过 `maturin` 本地编译。 ### Docker ```bash # Docker Hub docker pull ontoweb/intellect-agent:latest docker run -v intellect-data:/opt/data ontoweb/intellect-agent:latest # 阿里云容器镜像（国内加速） docker pull crpi-okdl7kgk1p2exqcm.cn-hangzhou.personal.cr.aliyuncs.com/ontoweb/intellect-agent:latest ``` ### Homebrew（macOS） ```bash brew install intellect-agent ``` ### pip（Python 包） ```bash # PyPI pip install intellect-agent # 清华镜像（国内） pip install intellect-agent -i https://pypi.tuna.tsinghua.edu.cn/simple/ # Gitee Release wheel（国内，手动指定版本） pip install https://gitee.com/ontoweb/intellect-agent/releases/download/v0.6.6/intellect_agent-0.6.6-py3-none-any.whl ``` 安装后： ```bash source ~/.bashrc # 重新加载 shell（或: source ~/.zshrc） intellect # 开始对话！ ``` --- ## 国内用户加速指南 国内用户可通过以下方式加速安装与依赖下载： | 资源 | 国内推荐 | 备注 | |------|----------|------| | 安装脚本 | Gitee raw（见上方快速安装第二条命令） | 已有 | | 源码 clone | `gitee.com/ontoweb/intellect-agent` | 已有 | | pip / uv | `UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/` | 清华 `https://pypi.tuna.tsinghua.edu.cn/simple/` 也可用 | | Docker | 阿里云容器镜像（见上方 Docker 节） | 已有 | | Rust wheel | Gitee Releases | 安装器已自动尝试 | | npm（仅开发环境） | `registry.npmmirror.com` | 仅 `git clone` 后开发时使用 | **国内加速安装示例**（设置 PyPI 镜像后运行 Gitee 脚本）： ```bash export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ curl -fsSL https://raw.giteeusercontent.com/ontoweb/intellect-agent/raw/main/scripts/install.sh | bash ``` ```powershell $env:UV_INDEX_URL = "https://mirrors.aliyun.com/pypi/simple/" iex (irm https://raw.giteeusercontent.com/ontoweb/intellect-agent/raw/main/scripts/install.ps1) ``` --- ## 快速入门 ```bash intellect # 交互式 CLI — 开始对话 intellect model # 选择 LLM 提供商和模型 intellect tools # 配置启用的工具 intellect config set # 设置单个配置项 intellect gateway # 启动消息网关（Telegram、Discord 等） intellect setup # 运行完整设置向导（一次性配置所有内容） intellect claw migrate # 从 OpenClaw 迁移（如果来自 OpenClaw） intellect update # 更新到最新版本 intellect doctor # 诊断问题 ``` 📖 **[完整文档 →](https://intellect.ontoweb.cn/docs/)** --- ## 更新 | 安装方式 | 命令 | 说明 | |---------|------|------| | Git clone | `intellect update` | 拉取最新源码 + 重建 Rust 扩展 | | pip/uv | `intellect update` | 升级 Python 包 + Rust wheel | | Docker | `docker pull` | 拉取最新镜像 | | Homebrew | `brew upgrade intellect-agent` | 由 Homebrew 管理 | `intellect update` 自动保持 Rust 扩展同步： - **Git 安装**：每次 pull 后通过 `maturin develop --release` 重建 - **pip 安装**：升级主包时同步升级 `intellect_community_core` wheel --- ## CLI 与消息平台 快速对照 Intellect 有两种入口：用 `intellect` 启动终端 UI，或运行网关从 Telegram、Discord、Slack、WhatsApp、Signal 或 Email 与之对话。进入对话后，许多斜杠命令在两种界面中通用。 | 操作 | CLI | 消息平台 | |------|-----|----------| | 开始对话 | `intellect` | 运行 `intellect gateway setup` + `intellect gateway start`，然后给机器人发消息 | | 开始新对话 | `/new` 或 `/reset` | `/new` 或 `/reset` | | 更换模型 | `/model [provider:model]` | `/model [provider:model]` | | 设置人格 | `/personality [name]` | `/personality [name]` | | 重试或撤销上一轮 | `/retry`、`/undo` | `/retry`、`/undo` | | 压缩上下文 / 查看用量 | `/compress`、`/usage`、`/insights [--days N]` | `/compress`、`/usage`、`/insights [days]` | | 浏览技能 | `/skills` 或 `/` | `/skills` 或 `/` | | 中断当前工作 | `Ctrl+C` 或发送新消息 | `/stop` 或发送新消息 | | 平台特定状态 | `/platforms` | `/status`、`/sethome` | 完整命令列表请参阅 [CLI 指南](https://intellect.ontoweb.cn/docs/user-guide/cli) 和 [消息网关指南](https://intellect.ontoweb.cn/docs/user-guide/messaging)。 --- ## 文档 所有文档位于 **[intellect.ontoweb.cn/docs](https://intellect.ontoweb.cn/docs/)**： | 章节 | 内容 | |------|------| | [快速开始](https://intellect.ontoweb.cn/docs/getting-started/quickstart) | 安装 → 设置 → 2 分钟内开始首次对话 | | [CLI 使用](https://intellect.ontoweb.cn/docs/user-guide/cli) | 命令、快捷键、人格、会话 | | [配置](https://intellect.ontoweb.cn/docs/user-guide/configuration) | 配置文件、提供商、模型、所有选项 | | [消息网关](https://intellect.ontoweb.cn/docs/user-guide/messaging) | Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant | | [安全](https://intellect.ontoweb.cn/docs/user-guide/security) | 命令审批、DM 配对、容器隔离 | | [工具与工具集](https://intellect.ontoweb.cn/docs/user-guide/features/tools) | 40+ 工具、工具集系统、终端后端 | | [技能系统](https://intellect.ontoweb.cn/docs/user-guide/features/skills) | 过程记忆、技能中心、创建技能 | | [记忆](https://intellect.ontoweb.cn/docs/user-guide/features/memory) | 持久记忆、用户画像、最佳实践 | | [MCP 集成](https://intellect.ontoweb.cn/docs/user-guide/features/mcp) | 连接任意 MCP 服务器扩展能力 | | [定时调度](https://intellect.ontoweb.cn/docs/user-guide/features/cron) | 定时任务与平台投递 | | [上下文文件](https://intellect.ontoweb.cn/docs/user-guide/features/context-files) | 影响每次对话的项目上下文 | | [架构](https://intellect.ontoweb.cn/docs/developer-guide/architecture) | 项目结构、代理循环、关键类 | | [贡献](https://intellect.ontoweb.cn/docs/developer-guide/contributing) | 开发设置、PR 流程、代码风格 | | [CLI 参考](https://intellect.ontoweb.cn/docs/reference/cli-commands) | 所有命令和标志 | | [环境变量](https://intellect.ontoweb.cn/docs/reference/environment-variables) | 完整环境变量参考 | --- ## 贡献 欢迎贡献！请参阅 [贡献指南](https://intellect.ontoweb.cn/docs/developer-guide/contributing) 了解开发设置、代码风格和 PR 流程。 贡献者快速开始——克隆并使用 `setup-intellect.sh` / `setup-intellect.ps1`： **Linux / macOS / WSL2：** ```bash # GitHub git clone --recurse-submodules https://github.com/ontoweb-cn/intellect-agent.git # Gitee（国内） git clone --recurse-submodules https://gitee.com/ontoweb/intellect-agent.git cd intellect-agent ./setup-intellect.sh # 安装 uv、创建 venv、安装 .[all]、创建符号链接 ~/.local/bin/intellect ./intellect # 自动检测 venv，无需先 source ``` **Windows（原生 PowerShell）：** ```powershell git clone --recurse-submodules https://gitee.com/ontoweb/intellect-agent.git cd intellect-agent .\setup-intellect.ps1 # 安装 uv、创建 venv、安装 .[all]、配置 PATH ``` 手动安装（等效于上述命令）： ```bash curl -LsSf https://astral.sh/uv/install.sh | sh uv venv venv --python 3.12 source venv/bin/activate uv pip install -e ".[all,dev]" python -m pytest tests/ -q ``` --- ## 许可证 MIT — 详见 [LICENSE](LICENSE)。 由 [ONTOWEB](https://ontoweb.cn) 构建。