RedCore — 红芯战场大脑

RedCore 是基于 OpenClaw 的多 Agent AI 协作平台，提供多 Agent 对话、全球资讯态势感知、Agent 管理与编排、定时任务等能力。

快速开始

第一步：安装依赖

确保你的系统已安装：

依赖	版本要求	检查命令	安装方式
Node.js	>= 18	`node -v`	nodejs.org
npm	随 Node.js 安装	`npm -v`	随 Node.js 安装
OpenClaw	最新版	`openclaw --version`	`npm install -g openclaw`

Windows 用户：以下终端命令请在 WSL2 (Ubuntu) 或 Git Bash 中执行，不要在 CMD/PowerShell 中执行。

第二步：克隆项目

git clone https://github.com/fewioj9f/ttt.git ~/redcore
cd ~/redcore
npm install

npm install 会自动安装前端依赖和 auth-server 依赖。

第三步：配置 OpenClaw

首次使用 OpenClaw 需要完成初始化配置（选择模型提供商、填入 API Key 等）：

openclaw onboard

按提示操作：选择模型提供商（如 DeepSeek）→ 输入 API Key → Gateway 配置（默认端口 18789 即可）→ 跳过频道和技能（可选）。

如需后续修改配置：openclaw configure --section model（修改模型）或 openclaw configure --section gateway（修改网关）。

第四步：启动 Gateway

# 在一个终端中前台运行 Gateway（开发推荐）
openclaw gateway run

# 或者安装为系统服务后台运行
openclaw gateway install
openclaw gateway start

看到 Gateway running on ws://127.0.0.1:18789 表示启动成功。

Gateway 必须保持运行，另开一个终端执行后续步骤。

第五步：获取 Gateway Token

在新终端中执行：

openclaw config get gateway.auth.token

复制输出的 Token 字符串，下一步需要用到。

如果输出为空，执行 openclaw doctor --generate-gateway-token 自动生成一个。

第六步：启动 RedCore

方式 A：单用户模式（推荐个人使用）

cd ~/redcore
npm run dev

浏览器打开 http://localhost:3000 ，在「系统设置 → 连接配置」中粘贴上一步获取的 Gateway Token，点击「保存」。

方式 B：多用户模式（团队协作）

cd ~/redcore
cp .env.example .env

编辑 .env 文件，填入以下内容：

# 必填：DeepSeek API Key
DEEPSEEK_API_KEY=sk-your-key-here

# 必填：Gateway Token（第五步获取的）
REDCORE_GATEWAY_TOKEN=your-gateway-token

# 可选：修改端口（默认即可）
REDCORE_PROXY_PORT=3002
REDCORE_GATEWAY_URL=ws://localhost:18789

然后一键启动：

npm run start:all

浏览器打开 http://localhost:3000 ，注册账号后登录即可。

多用户模式通过 Auth Proxy 实现用户隔离，每个用户只能看到自己的会话和 Agent。

可选：ArbiterOS 安全治理

ArbiterOS 为 Agent 提供安全策略管控、指令审计和工具调用过滤。不安装不影响核心功能，安装后可增强安全性。

cd ~/redcore
npm run setup:arbiteros

按提示操作，脚本会自动：安装 Python 依赖 → 生成 litellm 配置 → 注册模型到 OpenClaw。

启动方式：npm run start:all 会自动检测并启动 ArbiterOS Kernel。

详细说明见 README-ARBITEROS.md。

项目结构

redcore/
├── src/                    # 前端源码
│   ├── api/                #   WebSocket RPC + HTTP 客户端
│   ├── pages/              #   9 个页面（对话/资讯/代理/技能/数据库/任务/日志/设置/协作）
│   ├── components/         #   UI 组件（chat/news/agents/groupchat/federation/...）
│   ├── store/              #   Zustand 状态管理（chat/agent/news/groupChat/federation）
│   ├── engine/             #   引擎（relay/groupChat/delegate/messageBus）
│   ├── auth/               #   多用户认证（JWT + 登录/管理员页）
│   ├── main.jsx            #   入口
│   ├── App.jsx             #   根组件
│   └── index.css           #   全局样式
├── auth-server/            # 独立认证代理（多用户模式）
│   ├── index.js            #   Express + WS 代理入口
│   ├── ws-proxy.js         #   WebSocket RPC 代理 + 数据隔离
│   ├── db.js               #   SQLite 初始化
│   ├── routes/             #   REST 路由（auth/admin/files）
│   └── package.json        #   独立依赖
├── scripts/                # 部署脚本
│   ├── start-all.sh        #   一键启动（Gateway + Auth Proxy + 前端）
│   └── setup-arbiteros.sh  #   ArbiterOS 安装配置
├── arbiteros/              # ArbiterOS 安全治理内核（可选）
├── package.json            # 依赖 + 脚本
├── vite.config.js          # Vite 配置
├── tailwind.config.js      # Tailwind 主题
└── index.html              # HTML 入口

功能列表

页面	路由	功能
对话	`/chat`	多 Agent 会话、流式对话、Markdown 渲染、工具调用展示、Agent/模型切换
资讯	`/news`	全球态势地图、热点 AI 查询、资讯流、战场研判室
协作	`/groupchat`	多 Agent 群聊、任务委派、作战室
代理	`/agents`	预设 Agent + 自定义 CRUD
技能	`/skills`	Agent 技能管理
数据库	`/database`	数据源管理、文件上传
任务	`/tasks`	定时任务、Cron 调度
日志	`/logs`	系统监控、实时日志
设置	`/settings`	Gateway 连接配置、模型列表

技术栈

React 18 + Vite 5 + TailwindCSS 3 + Zustand 4 + ECharts 6 + WebSocket RPC (Protocol v3) + Ed25519 签名

常见问题

npm install 失败

# 确认 Node.js 版本
node -v  # 需要 >= 18

# 清除缓存重试
rm -rf node_modules package-lock.json && npm install

# 网络问题可切换镜像
npm config set registry https://registry.npmmirror.com

聊天无回复

确认 Gateway 正在运行：终端应显示 Gateway running on ws://127.0.0.1:18789
确认已填入 Gateway Token：设置页 → 连接配置 → Gateway Token
确认模型 API Key 有效：openclaw configure --section model 查看

WebSocket 连不上

确认 Gateway 端口为 18789：openclaw config get gateway.port
浏览器必须通过 http://localhost:3000 访问，不能用 IP 地址
多用户模式确认 Auth Proxy 正在运行：curl http://localhost:3002/api/health

Ed25519 签名失败

浏览器需在安全上下文中运行（localhost 或 HTTPS），不能用 IP 地址直接访问。

清除 localStorage 后重连失败

清除 localStorage 会导致设备身份丢失。解决方法：

在 RedCore 设置页重新填入 Gateway Token 并保存
或删除 Gateway 侧的设备记录：rm ~/.openclaw/devices/paired.json 后重启 Gateway

构建产物部署

npm run build    # 产出 dist/ 目录
# dist/ 可用任意静态服务器托管，支持子目录部署

生产环境需确保 Gateway allowedOrigins 包含前端域名，且应关闭 allowInsecureAuth。

npm 脚本速查

命令	说明
`npm run dev`	启动前端开发服务器 (:3000)
`npm run build`	构建生产版本
`npm run start:all`	一键启动所有服务（多用户模式）
`npm run start:auth`	仅启动 Auth Proxy (:3002)
`npm run start:arbiteros`	仅启动 ArbiterOS Kernel
`npm run setup:arbiteros`	安装配置 ArbiterOS