BlueClaw

BlockCell进化为BlueClaw - 蓝虾

用 Rust 构建的自进化 AI 多智能体框架

🌟 BlockCell 有何不同

BlockCell 不只是一个聊天机器人 — 它是一个真正能执行任务的 AI 智能体。当 ChatGPT 只能告诉你该做什么时，BlockCell 可以：

📁 读写你系统上的文件
🌐 控制浏览器并自动化网页任务
📊 分析 Excel/PDF 文件并生成报表
💰 监控股票价格和加密货币市场
📧 跨平台发送邮件和消息
🔄 自我进化 — 自动修复 bug 并部署改进

你："监控特斯拉股价，如果跌破 200 美元就提醒我"
BlockCell: ✓ 设置监控 → ✓ 每小时检查价格 → ✓ 发送 Telegram 提醒

🎯 名字由来

"极简的单元，极繁的整体。"

BlockCell 的灵感来自《星际之门》中的复制者（Replicators） — 由无数微小、独立的模块块组成的机械生命体。每个模块本身很简单，但组合在一起就能形成战舰、士兵和智慧。它们瞬间适应，进化速度超过任何武器，永远无法被摧毁。

这种哲学贯穿于整个框架：

Block → 不可变的 Rust 宿主：安全、稳定、确定性
Cell → 可变的技能层：有生命、能自我修复、无限进化

传统软件在发布的那一刻就停止了生长。BlockCell 是活的。

→ 完整命名故事

✨ 核心特性

🛠️ 内置 50+ 工具

文件与系统：读写文件、执行命令、处理 Excel/Word/PDF
网页与浏览器：网页抓取、无头 Chrome 自动化（CDP）、HTTP 请求
金融数据：实时股票行情（A股/港股/美股）、加密货币价格、DeFi 数据
通讯：邮件（SMTP/IMAP）、Telegram、Slack、Discord、飞书
媒体：截图、语音转文字（Whisper）、图表生成、Office 文件创建
AI 增强：图像理解、文字转语音、OCR

🧬 自我进化系统

当 AI 在执行任务时反复失败，BlockCell 可以：

检测错误模式
使用 LLM 生成改进的代码
自动审计、编译和测试
通过金丝雀部署（10% → 50% → 100%）
如果性能下降则自动回滚

检测到错误 → LLM 生成修复 → 审计 → 测试 → 金丝雀部署 → 全量发布
                                        ↓ 失败时
                                      自动回滚

🌐 多渠道支持

将 BlockCell 作为守护进程运行，连接到：

Telegram（长轮询）
WhatsApp（桥接 WebSocket）
飞书（长连接 WebSocket）
Lark（Webhook）
Slack（Socket Mode，缺少 appToken 时可轮询回退）
Discord（Gateway WebSocket）
钉钉（Stream SDK）
企业微信（WeCom，轮询/Webhook）

📖 渠道接入指南

每个渠道都有详细的配置文档（中英双语）：

中文文档	English Docs
Telegram 配置	Telegram Setup
Discord 配置	Discord Setup
Slack 配置	Slack Setup
飞书配置	Feishu Setup
钉钉配置	DingTalk Setup
企业微信配置	WeCom Setup
WhatsApp 配置	WhatsApp Setup
Lark 配置	Lark Setup

每份指南包含：

📝 应用创建步骤
🔑 权限配置说明
⚙️ Blockcell 配置示例
💬 交互方式说明
⚠️ 常见问题排查

🏗️ Rust 宿主 + 三种技能形态

┌─────────────────────────────────────────────┐
│         Rust 宿主（可信核心）                │
│  消息总线 | 工具注册表 | 调度器              │
│  存储 | 审计 | 安全                          │
└─────────────────────────────────────────────┘
                     ↕
┌─────────────────────────────────────────────┐
│         技能层（可变层）                     │
│  纯 Markdown | Markdown + Rhai              │
│  Markdown + Python                          │
└─────────────────────────────────────────────┘

Rust 宿主：不可变、安全、高性能的基础
纯 Markdown 技能：只用 SKILL.md 定义行为说明，适合知识型与流程型技能
Markdown + Rhai 技能：使用 SKILL.md + SKILL.rhai 实现结构化编排与工具调用
Markdown + Python 技能：使用 SKILL.md + Python 脚本承载更复杂的数据处理、集成与执行逻辑

🚀 快速开始

安装（推荐）

curl -fsSL https://raw.githubusercontent.com/blockcell-labs/blockcell/main/install.sh | sh

这会将 blockcell 安装到 ~/.local/bin。自定义安装位置：

BLOCKCELL_INSTALL_DIR="$HOME/bin" \
curl -fsSL https://raw.githubusercontent.com/blockcell-labs/blockcell/main/install.sh | sh

从源码构建

前置要求：Rust 1.75+

git clone https://github.com/blockcell-labs/blockcell.git
cd blockcell
cargo build --release

首次运行

# 推荐：交互式向导
blockcell setup

# 启动交互模式
blockcell agent

setup 会创建 ~/.blockcell/ 目录、写入 provider 配置，并在你启用外部渠道时自动补默认 owner 绑定。

守护进程模式（带 WebUI）

blockcell gateway

API 服务器：http://localhost:18790
WebUI：http://localhost:18791
默认路由：CLI / WebUI / WebSocket 进入 default agent；外部渠道优先按 channelAccountOwners.<channel>.<accountId> 路由，未命中时回退到 channelOwners.<channel>

📸 项目截图

守护进程模式

WebUI 界面

⚙️ 配置说明

最小配置示例（~/.blockcell/config.json5）：

{
  "providers": {
    "deepseek": {
      "apiKey": "YOUR_API_KEY",
      "apiBase": "https://api.deepseek.com"
    }
  },
  "agents": {
    "defaults": {
      "model": "deepseek-chat"
    }
  }
}

如果要启用多 agent 与外部渠道，建议按代码当前支持的结构补充，例如下面这个“2 个 agent + 2 个 Telegram 账号”的配置：

{
  "agents": {
    "defaults": {
      "model": "deepseek-chat"
    },
    "list": [
      {
        "id": "default",
        "enabled": true,
        "name": "General Assistant",
        "intentProfile": "default"
      },
      {
        "id": "ops",
        "enabled": true,
        "name": "Operations Assistant",
        "intentProfile": "ops",
        "maxToolIterations": 12
      }
    ]
  },
  "intentRouter": {
    "enabled": true,
    "defaultProfile": "default",
    "agentProfiles": {
      "default": "default",
      "ops": "ops"
    },
    "profiles": {
      "default": {
        "coreTools": ["read_file", "write_file", "list_dir", "web_fetch", "message"],
        "intentTools": {
          "Chat": { "inheritBase": false, "tools": [] },
          "FileOps": ["read_file", "write_file", "list_dir"],
          "WebSearch": ["web_search", "web_fetch"]
        }
      },
      "ops": {
        "coreTools": ["http_request", "message", "notification", "alert_rule", "list_tasks"],
        "intentTools": {
          "DevOps": ["http_request", "notification", "alert_rule", "list_tasks"],
          "Communication": ["message", "notification"]
        },
        "denyTools": ["write_file", "exec"]
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "accounts": {
        "main_bot": {
          "enabled": true,
          "token": "123456:MAIN_BOT_TOKEN",
          "allowFrom": ["alice"]
        },
        "ops_bot": {
          "enabled": true,
          "token": "123456:OPS_BOT_TOKEN",
          "allowFrom": ["oncall_group"]
        }
      },
      "defaultAccountId": "main_bot"
    }
  },
  "channelOwners": {
    "telegram": "default"
  },
  "channelAccountOwners": {
    "telegram": {
      "main_bot": "default",
      "ops_bot": "ops"
    }
  },
  "gateway": {
    "apiToken": "YOUR_STABLE_API_TOKEN",
    "webuiPass": "YOUR_WEBUI_PASSWORD"
  }
}

这里要注意：

agents.list 里的字段要使用代码实际支持的字段，例如 id、enabled、name、intentProfile、maxToolIterations
intentRouter 当前支持 enabled、defaultProfile、agentProfiles、profiles
profiles.<name> 里可以配置 coreTools、intentTools、denyTools
Telegram 多账号要写在 channels.telegram.accounts 下，每个账号使用 enabled、token、allowFrom
渠道路由使用 channelOwners
账号级覆盖路由使用 channelAccountOwners
如果你只需要单 agent，请直接看上面的最小配置，或者阅读 QUICKSTART.zh-CN.md
如果你需要完整多 agent 部署说明，请阅读 QUICKSTART.multi-agent.zh-CN.md

支持的 LLM 提供商

OpenAI（GPT-4o、GPT-4.1、o1、o3）
Anthropic（Claude 3.5 Sonnet、Claude 4）
Google Gemini（Gemini 2.0 Flash、Pro）
DeepSeek（DeepSeek V3、R1）
Kimi/Moonshot（月之暗面）
MiniMax（MiniMax 2.5）
智谱 AI（GLM-5）
硅基流动（SiliconFlow）
Ollama（本地模型，完全离线）
OpenRouter（统一访问 200+ 模型）

🔧 可选依赖

要使用完整功能，请安装这些工具：

图表：Python 3 + matplotlib / plotly
Office：Python 3 + python-pptx / python-docx / openpyxl
音频：ffmpeg + whisper（或使用 API 后端）
浏览器：Chrome/Chromium（用于 CDP 自动化）
仅 macOS：chrome_control、app_control

📚 文档

🏗️ 项目结构

blockcell/
├── bin/blockcell/          # CLI 入口
└── crates/
    ├── core/               # 配置、路径、共享类型
    ├── agent/              # Agent 运行时和安全
    ├── tools/              # 50+ 内置工具
    ├── skills/             # Rhai 引擎与进化
    ├── storage/            # SQLite 记忆与会话
    ├── channels/           # 消息适配器
    ├── providers/          # LLM 提供商客户端
    ├── scheduler/          # Cron 与心跳
    └── updater/            # 自升级系统

🤝 贡献

我们欢迎贡献！以下是开始的方法：

Fork 本仓库
创建特性分支（git checkout -b feature/amazing-feature）
提交你的更改（git commit -m 'Add amazing feature'）
推送到分支（git push origin feature/amazing-feature）
打开 Pull Request

详细指南请参阅 CONTRIBUTING.md。

🔒 安全性

路径安全：自动验证文件系统访问
沙箱执行：Rhai 脚本在隔离环境中运行
审计日志：所有工具执行都被记录
网关认证：API 访问支持 Bearer token

在交互模式下，~/.blockcell/workspace 外的操作需要明确确认。

📊 使用场景

金融自动化

"监控茅台股价，如果跌破 1500 就提醒我"
"分析我的 portfolio.xlsx 并建议再平衡"

数据处理

"读取 ~/Documents 中的所有 PDF 并创建摘要表格"
"从 data.csv 生成带图表的销售报告"

网页自动化

"每小时检查公司网站，如果宕机就提醒"
"用 sheet.xlsx 中的数据填写 example.com 上的表单"

通讯

"每天发送站会总结到 Slack #team-updates"
"将紧急邮件转发到我的 Telegram"

🌍 社区

GitHub：blockcell-labs/blockcell
官网：blockcell.dev
Discord：加入我们的社区
Twitter：@blockcell_dev

📝 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

🙏 致谢

BlockCell 站在巨人的肩膀上：

Rust - 系统编程语言
Rhai - 嵌入式脚本引擎
Tokio - 异步运行时
SQLite - 嵌入式数据库
OpenClaw - OpenClaw
NonaClaw - python版本Claw

如果你觉得 BlockCell 有用，请在 GitHub 上给我们一个 ⭐️！

⭐ 在 GitHub 上 Star • 📖 阅读文档 • 💬 加入 Discord

Name		Name	Last commit message	Last commit date
Latest commit History 149 Commits
.cargo		.cargo
.github/workflows		.github/workflows
.idea		.idea
bin		bin
crates		crates
data		data
docs		docs
refs		refs
rules		rules
screenshot		screenshot
skills		skills
vendor		vendor
webui		webui
.DS_Store		.DS_Store
.dockerignore		.dockerignore
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
Dockerfile		Dockerfile
LICENSE		LICENSE
QUICKSTART.md		QUICKSTART.md
QUICKSTART.multi-agent.md		QUICKSTART.multi-agent.md
QUICKSTART.multi-agent.zh-CN.md		QUICKSTART.multi-agent.zh-CN.md
QUICKSTART.zh-CN.md		QUICKSTART.zh-CN.md
README.en.md		README.en.md
README.md		README.md
install.sh		install.sh
manifest.json		manifest.json

Folders and files

Latest commit

History

Repository files navigation