GoClaw Clear 专用 - by:Annmy

多租户 AI Agent 平台。支持 Agent、Agent Team、Skill、工具、知识库、定时任务、Hook、审计、权限控制和本地业务自动化。

项目地址 · 快速开始 · 核心能力 · 系统架构

GoClaw 是一个面向企业内部和本地业务自动化的多租户 AI Agent 平台。它不是单纯聊天界面，而是把模型、Agent、技能、工具、知识库、文件处理、定时任务和权限体系组合在一起，让不同用户、不同租户、不同业务流程可以在同一套系统中稳定执行。

当前项目仓库地址：

https://github.com/Annmys/goclaw

• 多租户管理：支持租户、用户、角色、租户内资源隔离和租户级 Agent 可见范围。
• Agent 与 Agent Team：支持单 Agent 对话，也支持多 Agent 协同、任务拆分、审核和返工。
• Skill 技能系统：支持核心 Skill、自定义 Skill、版本管理、权限控制和业务流程固化。
• 知识库与图谱：支持文档存储、Vault、Knowledge Graph、语义检索和业务资料沉淀。
• 定时任务：支持按计划同步本地业务数据，例如流转单、产品包装重量表、包装资料索引。
• 本地文件处理：支持 Excel、Word、PDF、图片、标签、船务清单等本地文件处理场景。
• 模型 Provider：支持 OpenAI 兼容接口、Kimi Code、DeepSeek、DashScope 等多种模型接入方式。
• 权限与安全：支持 Gateway Token、API Key、租户角色、管理员权限、工具审批、审计记录和敏感配置隔离。
• Docker 部署：支持后端、前端、PostgreSQL、pgvector 和可选组件组合部署。

GoClaw 的核心由前端控制台、后端网关、PostgreSQL 数据库、Agent 运行循环、Skill 执行系统、本地挂载目录和外部模型 Provider 组成。前端负责配置和交互，后端负责权限、调度、对话、工具执行和数据存储。

租户可以理解为组织。租户内用户共享该租户允许访问的 Agent、Agent Team、Skill、工具、知识库和定时任务结果。不同租户之间的数据、会话和权限互相隔离。

Agent 的执行不是一次简单模型调用，而是由上下文加载、历史整理、Prompt 生成、模型思考、工具调用、结果观察、记忆写入和摘要沉淀组成。这样可以让复杂任务有过程、有记录、有回滚依据。

GoClaw 的知识能力由短期会话、长期记忆、Vault 文档库和 Knowledge Graph 组成。业务数据可以通过定时任务转换为可查询索引，也可以通过 Vault 进入知识库。

Agent Team 适合复杂业务。调度 Agent 负责拆分任务，业务 Agent 负责执行，审核 Agent 负责检查数据准确性和文件格式，知识 Agent 负责沉淀规则和反馈问题。

Skill 用来把稳定的业务流程固化为可复用能力。例如船务清单处理、标签生成、包装计算、流转单查询、产品包装重量查询等，都可以通过 Skill 统一执行和迭代。

GoClaw 可以接入多个模型 Provider，并通过不同 Agent 绑定不同模型。企业可以按业务场景选择模型，例如普通问答、代码能力、文件处理、审核、翻译、图片分析等。

GoClaw 的权限控制重点包括：登录身份、Gateway Token、租户角色、管理员权限、Agent 可见范围、工具审批、API Key 加密存储、审计记录和租户数据隔离。

git clone https://github.com/Annmys/goclaw.git
cd goclaw

chmod +x prepare-env.sh
./prepare-env.sh

make up WITH_WEB_NGINX=1

默认访问地址：

前端控制台：http://localhost:3000
后端健康检查：http://localhost:18790/health

make up                 # 启动服务
make down               # 停止服务
make logs               # 查看后端日志
make reset              # 清理数据并重建，谨慎使用

• 识别用户上传的 Excel 文件类型。
• 判断文件适合交给哪个专门技能处理。
• 支持订单、订单附件、船务清单、流转单、包装相关表格等常见业务文件分流。

• 处理 CI、PL、EPL 等船务清单相关 Excel。
• 支持查询流转单内容索引和产品包装重量表。
• 支持生成或补全 EPL/PL。
• 尽量保留 Excel 原始格式、合并单元格、列宽、边框、Logo 和关键公式。

• 读取订单 Excel 和订单附件。
• 识别标签类型：工字标、唛头、平面标等。
• 根据客户要求和特殊型号选择模板。
• 调用 BarTender 生成真实标签预览。
• 支持用户确认后再批量打印。

• 参考原有包装计算逻辑。
• 支持读取包装资料索引。
• 输出计算结果到订单对应文件夹。

• 查询订单对应流转单。
• 返回包装数量、外箱规格、产品明细等信息。
• 配合船务清单处理技能补全 EPL/PL。

• 查询产品包装重量表索引。
• 支持按产品型号、规格、类型查询包装重量。
• 为船务清单、包装计算等技能提供重量数据。

• 同步流转单索引。
• 转换产品包装重量表索引。
• 转换包装资料索引。
• 生成 sqlite 数据，方便技能快速查询。

go test ./...
go build -o goclaw.exe .

corepack pnpm -C ui/web install
corepack pnpm -C ui/web build

docker compose -f docker-compose.yml -f docker-compose.postgres.yml -f docker-compose.selfservice.yml up -d --build goclaw-ui

本项目使用 CC BY-NC 4.0 许可证。