BlockCell 不只是一个聊天机器人 — 它是一个真正能执行任务的 AI 智能体。当 ChatGPT 只能告诉你该做什么时，BlockCell 可以：
- 📁 读写你系统上的文件
- 🌐 控制浏览器并自动化网页任务
- 📊 分析 Excel/PDF 文件并生成报表
- 💰 监控股票价格和加密货币市场
- 📧 跨平台发送邮件和消息
- 🔄 自我进化 — 自动修复 bug 并部署改进
你："监控特斯拉股价，如果跌破 200 美元就提醒我"
BlockCell: ✓ 设置监控 → ✓ 每小时检查价格 → ✓ 发送 Telegram 提醒
"极简的单元，极繁的整体。"
BlockCell 的灵感来自《星际之门》中的复制者（Replicators） — 由无数微小、独立的模块块组成的机械生命体。每个模块本身很简单，但组合在一起就能形成战舰、士兵和智慧。它们瞬间适应，进化速度超过任何武器，永远无法被摧毁。
这种哲学贯穿于整个框架：
- Block → 不可变的 Rust 宿主：安全、稳定、确定性
- Cell → 可变的技能层：有生命、能自我修复、无限进化
传统软件在发布的那一刻就停止了生长。BlockCell 是活的。
→ 完整命名故事
- 文件与系统：读写文件、执行命令、处理 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 可以在真实使用中沉淀长期有效的经验：
- 将稳定用户偏好写入
USER.md - 将项目事实、环境约定和踩坑记录写入
MEMORY.md - 将可复用流程整理成 workspace skills
- 后台 review 失败不影响当前对话，所有自动写入都有审计、快照和撤销入口
当你配置多个模型时，BlockCell 可以按策略选择合适的 Provider：
manual：沿用 Provider Pool 的优先级 + 权重选择cost_optimized：短上下文优先使用低成本模型，长上下文回到主力模型quality_first：优先使用高优先级主力模型latency_first：为延迟优先策略预留入口，当前按可用条目的成功历史做稳定性近似
主对话 LLM 调用还支持连接阶段自动降级：如果首选 Provider 在建立流之前出现连接、超时、DNS 等错误，会立即尝试下一个可用 Provider；一旦流式输出已经开始，中途错误不会切换模型，避免把部分输出和另一个模型的结果混在一起。
BlockCell 可以通过 ~/.blockcell/hooks.yaml 在关键生命周期事件上执行本机命令：
pre_tool_use/post_tool_use：工具实际执行前后触发，支持按工具名 glob 匹配session_start/user_prompt/agent_stop：会话和消息级事件- 支持
{tool_name}、{session_id}、{cwd}、{command}、{file_path}、{result}等模板变量 - Hook 失败或超时不会阻断 agent 主流程，适合审计、格式化、通知和外部日志接入
v0.1.7 进一步收紧 agent 的执行边界：
- Tool Policy 支持工具名 glob、渠道条件、路径条件、
allow/ask/deny决策和规则组继承 - 全局 Token / 成本预算按会话跟踪，避免长任务或异常循环失控消耗
- 审计日志支持 SHA-256 hash chain 校验，并记录会话、Provider 调用和预算事件
- Gateway API 默认更严格，普通 API 不再接受 URL
?token=，应使用Authorization: Bearer <token>
- 支持 typed agent、forked subagent、checkpoint 和链式取消
- 支持用户级与项目级 Markdown agent 定义
- 每类 agent 可单独配置工具范围、模型、技能、MCP、one-shot 和权限模式
- CLI、Gateway 和 WebUI 可接收后台任务进度事件
将 BlockCell 作为守护进程运行，连接到：
- Telegram（长轮询）
- WhatsApp（桥接 WebSocket）
- 飞书（长连接 WebSocket）
- Lark（Webhook）
- Slack（Socket Mode，缺少
appToken时可轮询回退） - Discord（Gateway WebSocket）
- 钉钉（Stream SDK）
- 企业微信（WeCom，轮询/Webhook）
- QQ（官方机器人 Gateway/Webhook）
- NapCatQQ（OneBot 11 WebSocket/HTTP）
- 微信（Weixin iLink Bot API，扫码登录/长轮询）
每个渠道都有详细的配置文档（中英双语）：
每份指南包含：
- 📝 应用创建步骤
- 🔑 权限配置说明
- ⚙️ Blockcell 配置示例
- 💬 交互方式说明
⚠️ 常见问题排查
┌─────────────────────────────────────────────┐
│ Rust 宿主（可信核心） │
│ 消息总线 | 工具注册表 | 调度器 │
│ 存储 | 审计 | 安全 │
└─────────────────────────────────────────────┘
↕
┌─────────────────────────────────────────────┐
│ 技能层（可变层） │
│ 纯 Markdown | Markdown + Rhai │
│ Markdown + Python │
└─────────────────────────────────────────────┘
- Rust 宿主：不可变、安全、高性能的基础
- 纯 Markdown 技能：只用
SKILL.md定义行为说明，适合知识型与流程型技能 - Markdown + Rhai 技能：使用
SKILL.md+SKILL.rhai实现结构化编排与工具调用 - Markdown + Python 技能：使用
SKILL.md+ Python 脚本承载更复杂的数据处理、集成与执行逻辑 - 社区技能兼容：支持 skill pack/category 递归扫描，兼容 OpenClaw 与 gbrain skill 格式
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.85+
git clone https://github.com/blockcell-labs/blockcell.git
cd blockcell
cargo build --release# 推荐：交互式向导
blockcell setup
# 启动交互模式
blockcell agentsetup 会创建 ~/.blockcell/ 目录、写入 provider 配置，并在你启用外部渠道时自动补默认 owner 绑定。
blockcell gateway- API 服务器：
http://localhost:18790 - WebUI：
http://localhost:18791 - 默认路由：CLI / WebUI / WebSocket 进入
defaultagent；外部渠道优先按channelAccountOwners.<channel>.<accountId>路由，未命中时回退到channelOwners.<channel>
最小配置示例（~/.blockcell/config.json5）：
{
"providers": {
"deepseek": {
"apiKey": "YOUR_API_KEY",
"apiBase": "https://api.deepseek.com"
}
},
"agents": {
"defaults": {
"model": "deepseek-v4-pro",
"provider": "deepseek",
"maxContextTokens": 1048576,
"reasoningEffort": "high"
}
}
}多模型路由示例：
{
"agents": {
"defaults": {
"routingStrategy": "cost_optimized",
"modelPool": [
{ "model": "deepseek-v4-pro", "provider": "deepseek", "priority": 1, "weight": 3 },
{ "model": "gpt-5.4-mini", "provider": "openai", "priority": 5, "weight": 1 }
]
}
},
"providers": {
"deepseek": { "apiKey": "YOUR_DEEPSEEK_KEY" },
"openai": { "apiKey": "YOUR_OPENAI_KEY" }
}
}cost_optimized 会让短对话优先使用低优先级的便宜条目，复杂长上下文仍优先使用主力模型。更多策略与降级细节见 ModelRouter 智能路由与自动降级。
如果要启用多 agent 与外部渠道，建议按代码当前支持的结构补充，例如下面这个“2 个 agent + 2 个 Telegram 账号”的配置：
{
"agents": {
"defaults": {
"model": "deepseek-v4-pro",
"provider": "deepseek",
"maxContextTokens": 1048576,
"reasoningEffort": "high"
},
"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、maxToolIterationsintentRouter当前支持enabled、defaultProfile、agentProfiles、profilesprofiles.<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
- OpenAI（GPT-5.5、GPT-5.4-mini、o1、o3）
- Anthropic（Claude Opus 4.8、Claude Sonnet 4.6）
- Google Gemini（Gemini 3.1 Pro、Gemini 3.5 Flash）
- DeepSeek（DeepSeek V4 Pro、V3、R1）
- Kimi/Moonshot（月之暗面）
- MiniMax（MiniMax M3）
- 智谱 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？
- 快速开始指南（单 agent）
- 多 agent 快速开始
- 架构深度解析
- 工具系统
- 技能系统
- 记忆系统
- Ghost Native 学习闭环
- ModelRouter 智能路由与自动降级
- Hook 生命周期事件系统
- 渠道配置
- 浏览器自动化
- Gateway 模式
- 自我进化
- CLI 参考
blockcell/
├── bin/blockcell/ # CLI 入口
└── crates/
├── core/ # 配置、路径、共享类型
├── agent/ # Agent 运行时和安全
├── tools/ # 50+ 内置工具
├── skills/ # 技能加载、OpenClaw 兼容与进化
├── storage/ # SQLite 记忆、会话、RabitQ 向量索引
├── 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 上给我们一个 ⭐️！