系列文章：《blockcell 开源项目深度解析》第 8/14 篇

两种运行模式

blockcell 有两种运行模式：

blockcell agent — 交互模式

  • 在终端里和 AI 对话
  • 适合个人使用、开发调试
  • 你在，AI 才工作

blockcell gateway — 守护进程模式

  • 在后台持续运行
  • 提供 HTTP API 和 WebSocket 接口
  • 监听消息渠道（Telegram/Slack/Discord）
  • 执行定时任务（Cron）
  • 你不在，AI 也在工作

本篇介绍 Gateway 模式。

Gateway 启动

blockcell gateway

启动后，你会看到：

[2025-02-18 08:00:00] Gateway starting...
[2025-02-18 08:00:00] API server: http://0.0.0.0:18790
[2025-02-18 08:00:00] WebUI: http://localhost:18791
[2025-02-18 08:00:00] Telegram: connected (polling)
[2025-02-18 08:00:00] Discord: connected (WebSocket)
[2025-02-18 08:00:00] Cron: 3 jobs scheduled
[2025-02-18 08:00:00] Gateway ready.

默认端口：

  • 18790：API 服务器（HTTP）
  • 18791：WebUI（浏览器界面）

HTTP API

Gateway 提供了一个简洁的 REST API：

POST /v1/chat — 发送消息

curl -X POST http://localhost:18790/v1/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的token" \
  -d '{
    "message": "帮我查一下茅台今天的股价"
  }'

响应：

{
  "reply": "茅台（600519）今日股价：1,680.00 元，涨跌幅：+1.23%",
  "task_id": "msg_abc123",
  "tools_used": ["finance_api"]
}

GET /v1/health — 健康检查

curl http://localhost:18790/v1/health

{
  "status": "ok",
  "uptime": 3600,
  "version": "0.x.x"
}

这个接口不需要认证，专门给 Kubernetes/负载均衡器的健康探针用。

GET /v1/tasks — 查看任务列表

curl http://localhost:18790/v1/tasks \
  -H "Authorization: Bearer 你的token"

{
  "summary": {
    "running": 1,
    "completed": 42,
    "failed": 0
  },
  "tasks": [
    {
      "id": "task_xyz",
      "label": "分析茅台财报",
      "status": "running",
      "started_at": "2025-02-18T08:30:00Z"
    }
  ]
}

GET /v1/ws — WebSocket 连接

WebSocket 接口支持实时双向通信：

const ws = new WebSocket('ws://localhost:18790/v1/ws');

// 发送消息
ws.send(JSON.stringify({
  "message": "帮我查一下比特币价格"
}));

// 接收回复（流式）
ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === 'chunk') {
    process.stdout.write(data.content);
  } else if (data.type === 'done') {
    console.log('\n完成');
  } else if (data.type === 'skills_updated') {
    console.log('技能已更新:', data.new_skills);
  }
};

WebSocket 支持流式输出，AI 的回复会一个字一个字地推送过来，体验更流畅。

WebUI 界面

访问 http://localhost:18791，你会看到一个 Web 界面：

┌─────────────────────────────────────────────────────┐
│  blockcell Dashboard                          [登出] │
├──────────┬──────────────────────────────────────────┤
│          │                                          │
│ 导航栏   │  主内容区                                │
│          │                                          │
│ 💬 对话  │  [对话界面 / 任务列表 / 技能管理 / ...]  │
│ 📋 任务  │                                          │
│ 🔧 工具  │                                          │
│ 🧠 技能  │                                          │
│ 📊 进化  │                                          │
│ ⚙️ 设置  │                                          │
└──────────┴──────────────────────────────────────────┘

WebUI 的主要功能：

  • 对话界面：在浏览器里和 AI 对话
  • 任务监控：查看后台任务的执行状态
  • 技能管理：查看、启用/禁用技能
  • 进化记录：查看 AI 的自我进化历史
  • 实时推送：通过 WebSocket 接收技能更新等事件

API 认证

如果你的 Gateway 暴露在公网，必须设置 API Token：

{
  "gateway": {
    "apiToken": "一个复杂的随机字符串，至少32位"
  }
}

调用 API 时，在 Header 里带上 Token：

curl -H "Authorization: Bearer 你的token" http://你的服务器:18790/v1/chat

或者用 Query 参数（适合 WebSocket）：

ws://你的服务器:18790/v1/ws?token=你的token

WebUI 登录也使用同一个 Token 作为密码。

如果没有设置 Token，Gateway 启动时会打印警告：

⚠️  WARNING: No API token configured. Gateway is open to anyone!
    Set gateway.apiToken in config.json to secure your instance.

定时任务（Cron）

Gateway 模式下，定时任务会自动运行。

创建定时任务

你: 帮我创建一个定时任务，每天早上 8 点生成金融日报，
    通过 Telegram 发给我

AI 会创建一个 Cron 任务：

{
  "schedule": "0 8 * * *",
  "task": "生成今日金融日报，包含大盘走势、热点板块、自选股情况，通过 Telegram 发送",
  "enabled": true
}

管理定时任务

# 列出所有定时任务
blockcell cron list

# 输出：
# ID          SCHEDULE    LAST_RUN              STATUS
# daily_report 0 8 * * *  2025-02-18 08:00:00   ✓ success
# price_check  */10 * * * * 2025-02-18 08:50:00  ✓ success

部署到服务器

使用 systemd（Linux）

创建服务文件 /etc/systemd/system/blockcell.service：

[Unit]
Description=blockcell AI Gateway
After=network.target

[Service]
Type=simple
User=你的用户名
ExecStart=/home/你的用户名/.local/bin/blockcell gateway
Restart=always
RestartSec=10
Environment=HOME=/home/你的用户名

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl enable blockcell
sudo systemctl start blockcell
sudo systemctl status blockcell

使用 Docker

FROM ubuntu:22.04
RUN apt-get update && apt-get install -y curl
RUN curl -fsSL https://raw.githubusercontent.com/blockcell-labs/blockcell/refs/heads/main/install.sh | sh
COPY config.json /root/.blockcell/config.json
EXPOSE 18790 18791
CMD ["blockcell", "gateway"]

docker build -t blockcell .
docker run -d \
  -p 18790:18790 \
  -p 18791:18791 \
  -v ~/.blockcell:/root/.blockcell \
  blockcell

使用 Nginx 反向代理

server {
    listen 443 ssl;
    server_name ai.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location /v1/ {
        proxy_pass http://localhost:18790;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }

    location / {
        proxy_pass http://localhost:18791;
    }
}

与其他应用集成

Gateway 模式让 blockcell 成为一个标准的 HTTP 服务，可以很方便地与其他应用集成：

在 Python 中调用

import requests

def ask_ai(question: str) -> str:
    response = requests.post(
        "http://localhost:18790/v1/chat",
        headers={"Authorization": "Bearer 你的token"},
        json={"message": question}
    )
    return response.json()["reply"]

# 使用
answer = ask_ai("帮我查一下茅台今天的股价")
print(answer)

在 Node.js 中调用

const fetch = require('node-fetch');

async function askAI(question) {
  const response = await fetch('http://localhost:18790/v1/chat', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer 你的token'
    },
    body: JSON.stringify({ message: question })
  });
  const data = await response.json();
  return data.reply;
}

Gateway vs Agent 模式对比

特性 Agent 模式 Gateway 模式
启动方式 blockcell agent blockcell gateway
交互方式 命令行 HTTP API / WebSocket / 消息渠道
定时任务 ❌ ✅
消息渠道 ❌ ✅
路径安全 需要确认 工作目录外直接拒绝
适合场景 开发调试 生产部署
WebUI ❌ ✅

小结

Gateway 模式让 blockcell 从一个命令行工具变成了一个完整的 AI 服务：

  • HTTP API：标准 REST 接口，任何语言都能调用
  • WebSocket：实时流式输出
  • WebUI：浏览器管理界面
  • 定时任务：Cron 调度，AI 自动工作
  • 消息渠道：Telegram/Slack/Discord 全部激活
  • 安全：Token 认证 + 路径隔离

下一篇，我们来看 blockcell 最独特的特性：自我进化系统——AI 如何自动写代码升级自己。

项目地址：https://github.com/blockcell-labs/blockcell
官网：https://blockcell.dev

# gateway # 人工智能 # rust
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

OpenClaw CLI 完整命令手册

avatar 龙虾开发者社区
cover

OpenClaw 配置文件全解析：openclaw.yaml 详解

avatar 龙虾开发者社区

Qwen3-ASR-1.7B在Skills智能体开发中的多语言支持实现

本文介绍了如何在星图GPU平台自动化部署Qwen3-ASR-1.7B大模型驱动的语音识别镜像，实现多语言智能体的语音输入处理。该方案支持52种语言和方言的实时识别，典型应用于电商客服、多语言交互等场景，显著提升智能体的语音理解能力和用户体验。

avatar 龙虾开发者社区