qqqqqf-q/Arkloop

干净、强大、属于你的 AI Agent 平台 --AI agents, without the clutter.

Arkloop – 本地优先的 AI 代理平台

是什么 – Arkloop 是一个开源桌面应用程序，可在您自己的机器上完全运行对话式 AI 代理。它集成了基于 Go 的后端、React 网页 UI 和 Electron 容器，无需任何外部服务器即可提供完整的聊天界面、多模型路由、工具调用和持久化记忆功能。

为何重要 – 大多数 AI 聊天工具依赖云服务，或需要您自行搭建后端组件（数据库、消息队列等）。Arkloop 将所有功能整合到一个嵌入式进程中，使用本地 SQLite 存储，为您提供隐私保护、离线使用能力，以及在 macOS、Linux 和 Windows 上的简单安装体验。

功能	你能获得
多模型路由	可连接 OpenAI、Anthropic、Gemini 或任何 OpenAI 兼容 API。可设置模型优先级，并提供您自己的 API 密钥。
代理运行时	内置工具调用、MCP 服务器和“ClawHub”技能。支持启动子代理和调度任务。
记忆	默认为纯文本笔记本；可选语义记忆（Nowledge）。也可禁用以实现无状态机器人。
渠道	可将同一代理导出为 Telegram、Discord、QQ、Feishu 和 WeChat 机器人，并支持定时心跳运行。
自定义角色	每个角色可独立设置系统提示、工具白名单、预算上限和执行器类型。

桌面应用 – 从 GitHub Releases 页面下载适用于您操作系统的最新版本。安装程序包含运行时，只需启动应用即可。
命令行工具 – 首次启动桌面应用后，可安装 ark 命令行工具。运行 ark web 可以无头模式启动相同的本地服务器。
包管理器 – macOS: brew install qqqqqf-q/arkloop/arkloop；Arch Linux: yay -S arkloop-bin / arkloop-git。
无头 Linux 一键命令 – 通过 curl-pipe 命令获取合适的二进制文件，并在 0.0.0.0 上启动 Web UI。

组件	技术栈	作用
桌面端	Electron	嵌入 Go 运行时并提供 UI 的原生外壳。
运行时	Go	单一进程，提供 API、工作逻辑、SQLite 存储和进程内事件总线。
Web UI	React + TypeScript	聊天界面；打包进桌面应用，也可由 `ark web` 提供。
CLI	Go	`ark` 可执行文件 – 与同一运行时的无头入口点。

所有数据均本地存储于 SQLite 数据库中；无需任何外部服务（如 Postgres、Redis 或消息队列）。

前端 – 在 src/apps/desktop 内运行 pnpm install，然后执行 pnpm dev 以热重载 Electron 应用。
无头模式 – 使用 pnpm build 构建 Web UI，运行 Go 入口点：go run ./src/services/cli/cmd/ark web。
CI – 运行 bin/ci-local quick 执行本地持续集成检查。
欢迎贡献；即使非代码反馈也欢迎通过 GitHub Issues 提交。

Arkloop 使用自定义的“Arkloop 许可证”，是修改版 Apache 2.0 许可证，包含以下条款：

总结 – Arkloop 为开发者和高级用户提供了干净、自包含的环境，用于实验 AI 代理、尝试多个 LLM 提供商，并将机器人暴露于主流消息平台——所有操作均可在您的笔记本电脑上完成。