AG064/ag-claw

GitHub: AG064/ag-claw

一个模块化的 TypeScript 优先 AI 代理框架,提供 59 个可插拔功能和多种通讯渠道,支持自托管部署。

Stars: 2 | Forks: 0

AG-Claw

模块化 AI 代理框架。自托管。无需订阅。

[![版本](https://img.shields.io/badge/version-0.4.0-blue.svg?style=flat-square)](https://github.com/AG064/ag-claw/releases) [![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-green.svg?style=flat-square)](https://nodejs.org) [![许可证](https://img.shields.io/badge/license-MIT-orange.svg?style=flat-square)](./LICENSE) [![CI](https://img.shields.io/github/actions/workflow/status/AG064/ag-claw/ci.yml?style=flat-square)](https://github.com/AG064/ag-claw/actions) [![Stars](https://img.shields.io/github/stars/AG064/ag-claw?style=flat-square)](https://github.com/AG064/ag-claw/stargazers) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=flat&logo=telegram)](https://t.me/ag_claw) [![Docker](https://img.shields.io/badge/docker-ready-blue?style=flat-square)](https://github.com/AG064/ag-claw/actions/workflows/ci.yml) [![DockerHub](https://img.shields.io/docker/image-size/ag064/ag-claw?style=flat-square)](https://hub.docker.com/r/ag064/ag-claw)

## 30 秒快速入门 ``` # 克隆并运行 git clone https://github.com/AG064/ag-claw.git cd ag-claw npm install npm run dev ``` 就这些。你的代理已上线。 或使用 Docker: ``` docker run -it ag064/ag-claw ``` 或从[最新版本](https://github.com/AG064/ag-claw/releases/latest)获取二进制文件 ## 这是什么? AG-Claw 是基于 OpenClaw 构建的 AI 代理框架。它提供了一个模块化系统,让你可以精确启用所需的功能——Telegram 机器人、记忆后端、自动化工具、安全层,以及更多。 你的数据保留在本地。无云端依赖。无需订阅 ## 内置功能 **通讯:** Telegram、Discord、Slack、WhatsApp、邮件(IMAP/SMTP)、短信、Webchat、Signal。 **记忆:** SQLite、语义搜索、知识图谱、分层记忆、git 同步。 **自动化:** Cron 调度器、网格工作流、文件监视器、Webhook、浏览器自动化、容器沙箱。 **安全:** 加密密钥、速率限制、允许列表、策略引擎、审计日志。 **工具:** 带备用链的 AI 图像生成、YouTube Shorts 处理、技能加载器、自我改进代理 ## 为什么选择 AG-Claw 你可以获得 65+ 个功能作为插件。开启你需要的功能,忽略其余的。所有功能都在本地运行。无供应商锁定。 | 你获得的功能 | 其他框架 | |---|---| | 65+ 个即用功能 | 从头构建一切 | | 8 个通讯通道 | 通常一个,甚至没有 | | 5 个记忆后端 | 通常一个 | | 全程 TypeScript | 通常是 JavaScript 或包装器 | | 安全优先设计 | 事后考虑安全 | | 支持 Docker | 通常需要手动配置 | ## 安装选项 **从源码安装**(推荐用于开发): ``` git clone https://github.com/AG064/ag-claw.git cd ag-claw npm install npm run build npm start ``` **Docker**(推荐用于生产): ``` docker run -it ag064/ag-claw ``` **二进制文件**(无依赖): 从 [github.com/AG064/ag-claw/releases/latest]( enable # Enable a feature agclaw feature disable # Disable a feature agclaw agents # List configured agents agclaw sessions # View conversation sessions agclaw memory search # Search memory agclaw memory stats # Memory statistics agclaw config # Show config agclaw config # Get specific value agclaw config # Set a value agclaw doctor # Diagnose issues agclaw connect # Setup integrations ``` ## 架构 ``` AG-Claw Gateway ├── Channels (Telegram, Discord, Webchat...) ├── Features (65+ plugins) │ ├── computer-control │ ├── image-generation │ ├── skill-evolution │ ├── knowledge-graph │ └── ...59 more ├── Agentic Tool Loop │ ├── LLM Provider (OpenRouter, Anthropic, Ollama...) │ ├── Tools (registered by features) │ └── Memory (semantic, graph, SQLite) └── Security Layer ├── Audit Log ├── Rate Limiting ├── Allowlists / Denylists └── Policy Engine ``` ## 远程访问 **SSH 隧道**(推荐用于本地网络): ``` ssh -L 3000:localhost:3000 user@your-server # 打开 http://localhost:3000 ``` **Tailscale**(VPN,随时可用): ``` tailscale up tailscale serve https ``` **Cloudflare Tunnel**(零配置): ``` cloudflared tunnel --url http://localhost:3000 ``` ## 文档 | 指南 | 用途 | |---|---| | [快速入门](docs/QUICK_START.md) | 5 分钟内启动运行 | | [用户指南](docs/USER_GUIDE.md) | 日常操作 AG-Claw | | [开发者指南](docs/DEVELOPER_GUIDE.md) | 添加功能和贡献代码 | | [API 参考](docs/API.md) | REST 端点和配置架构 | | [迁移指南](docs/MIGRATION_FROM_OPENCLAW.md) | 从 OpenClaw 迁移 | | [安全](SECURITY.md) | 安全特性和最佳实践 | | [功能](docs/FEATURES.md) | 所有 65 个功能文档 | ## 许可证 MIT。版权所有 2024-2026 AG064。基于 nickarora 的 OpenClaw

有问题?在 GitHub 上提交 issue。

标签:AI代理框架, AI自动化, Discord机器人, Docker, Git同步, GNU通用公共许可证, MITM代理, Node.js, Slack机器人, SQLite, Telegram机器人, TypeScript, WhatsApp机器人, 内存系统, 多渠道消息, 安全插件, 安全防御评估, 开源, 无订阅, 模块化框架, 消息聚合, 生产级安全, 网络调试, 自动化, 自动化攻击, 自托管, 语义搜索, 请求拦截