FastClaw 是一个高性能的 AI 智能体框架，支持多智能体协作、多渠道集成和全面的扩展特性。

• 多智能体编排: 协调多个具有不同角色的专业智能体
• 多渠道支持: 8+ 渠道适配器（Telegram、Slack、Discord、飞书、钉钉、QQ、企业微信、WhatsApp）
• 真实 LLM 集成: 支持 OpenAI、Anthropic、Ollama 和 DeepSeek
• 记忆系统: JSONL 会话存储 + Markdown 长期记忆 + SQLite 向量搜索
• 工具与技能: 动态工具注册、沙箱执行和可扩展的技能系统
• MCP 协议: 模型上下文协议支持，用于可扩展的工具集成
• 插件系统: 模块化插件架构，支持自定义扩展
• 审计日志: 所有操作的完整审计追踪
• 错误处理: 高级错误处理，支持重试和优雅降级
• CLI 接口: 用于管理和测试的命令行界面
• 工作空间管理: 多工作空间支持，提供隔离环境

FastClaw 实现了一个全面的智能体框架：

• 网关: WebSocket 控制平面，用于实时通信
• 智能体运行时: 嵌入式智能体循环，推理-执行周期
• 多智能体编排器: 协调多个专业智能体
• LLM 集成: 多个 LLM 提供商的统一接口
• 记忆系统: JSONL 会话存储 + Markdown 长期记忆 + SQLite 向量索引
• 工具与技能: 动态工具注册，沙箱执行
• MCP 支持: 模型上下文协议，用于可扩展的工具集成
• 插件系统: 模块化插件架构
• 审计日志记录器: 完整的操作日志记录

fastclaw/
├── core/                 # 核心框架
│   ├── gateway.py       # WebSocket 网关
│   ├── agent.py         # 智能体运行时和循环
│   ├── llm_client.py    # LLM 客户端集成
│   ├── tools.py         # 工具注册表
│   ├── multi_agent.py   # 多智能体编排器
│   ├── workspace.py     # 工作空间管理
│   ├── audit.py         # 审计日志记录
│   ├── error_handler.py # 错误处理
│   ├── plugin.py        # 插件系统
│   ├── cli.py           # CLI 接口
│   ├── llm/             # LLM 适配器
│   │   ├── base.py
│   │   ├── openai_adapter.py
│   │   ├── anthropic_adapter.py
│   │   └── ollama_adapter.py
│   ├── mcp/             # MCP 协议
│   │   ├── manager.py
│   │   └── protocol.py
│   └── skills/          # 技能系统
│       ├── base.py
│       ├── manager.py
│       └── registry.py
├── adapters/            # 渠道适配器
│   ├── base.py
│   ├── telegram.py
│   ├── slack.py
│   ├── discord.py
│   ├── feishu.py
│   ├── dingtalk.py
│   ├── qq.py
│   ├── wecom.py
│   ├── whatsapp.py
│   └── webhook.py
├── storage/             # 存储实现
│   ├── session_store.py
│   └── memory_store.py
├── workspace/           # 智能体工作空间（Markdown 文件）
│   ├── AGENTS.md
│   ├── SOUL.md
│   ├── TOOLS.md
│   └── MEMORY.md
├── state/               # 运行时状态
│   ├── sessions/
│   └── memory/
├── ui/                  # Web 界面
│   └── index.html
├── main.py              # 入口点
├── config.yaml          # 配置文件
├── ARCHITECTURE.md      # 架构文档
├── ROADMAP.md           # 项目路线图
└── requirements.txt     # Python 依赖

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 设置环境变量
export DEEPSEEK_API_KEY="your_api_key_here"
export DEEPSEEK_BASE_URL="https://api.deepseek.com/v1"

# 启动服务器
python3 main.py

# 访问 Web 界面
在浏览器中打开 http://localhost:8000

• POST /api/v1/chat - OpenAI 兼容的 HTTP API
• WS /api/ws - 用于实时通信的 WebSocket 端点
• GET /api/v1/tools - 列出可用工具
• GET /api/v1/sessions - 列出活动会话
• GET / - Web 界面

编辑 config.yaml 进行配置：

llm:
  provider: "openai"  # openai | anthropic | ollama
  openai:
    api_key: "${DEEPSEEK_API_KEY}"
    base_url: "${DEEPSEEK_BASE_URL}"
    model: "deepseek-chat"

agents:
  - id: "coordinator"
    role: "coordinator"
    model: "deepseek-chat"
    enabled: true

channels:
  telegram:
    enabled: false
    bot_token: "${TELEGRAM_BOT_TOKEN}"
  slack:
    enabled: false
    bot_token: "${SLACK_BOT_TOKEN}"

• OpenAI: GPT-4、GPT-3.5
• DeepSeek: DeepSeek-V3、DeepSeek-Coder
• Anthropic: Claude 3 Opus、Sonnet、Haiku
• Ollama: 本地模型（Llama2、Mistral 等）

• Telegram: 完整的 Bot API 支持
• Slack: 应用集成
• Discord: 支持 Slash 命令的 Bot
• 飞书: 企业 Bot
• 钉钉: 企业 Bot
• QQ: OneBot 协议
• 企业微信: 企业 Bot
• WhatsApp: Business API
• Webhook: 通用 Webhook 适配器

• bash: 执行 Shell 命令（需批准）
• file_read: 读取文件内容
• file_write: 写入文件内容
• file_list: 列出目录内容
• calculator: 计算数学表达式
• memory_add: 添加到长期记忆
• memory_search: 搜索记忆

# 列出所有 CLI 命令
python3 -m core.cli --help

# 使用特定配置启动智能体
python3 -m core.cli start --config config.yaml

# 列出可用工具
python3 -m core.cli tools list

# 运行测试查询
python3 -m core.cli query "你好，FastClaw！"

• 功能特性指南 - 所有功能的详细配置和使用说明
• 渠道集成指南 - 8+ 种通讯渠道的完整配置教程
• API 参考文档 - REST API 和 WebSocket API 完整参考
• CLI 工具指南 - 命令行工具完整使用手册

• ARCHITECTURE.md - 详细的架构文档
• ROADMAP.md - 项目路线图和里程碑
• DEEPSEEK_SETUP.md - DeepSeek 集成指南

• README.md - English README | 英文版 README

MIT 协议