Yoma+HR 智能助手

Yoma+HR 是一个企业 HR 智能助手原型，面向员工自助咨询和 HR 知识库管理场景。系统通过员工侧 Bot、管理侧 Bot 和 Web Admin Portal，提供政策问答、文档上传、知识库维护、权限隔离和审计追踪能力。

本项目基于 OpenClaw 构建，仓库内只包含 HR 场景定制内容：Agent workspace、Skills、配置模板、Admin Portal 和项目文档，不包含 OpenClaw 源码。

核心能力

模块	说明	状态
政策问答	检索 HR 知识库，回答员工关于假期、考勤、福利、入离职等制度问题	可演示
知识库管理	管理员上传、更新、删除政策文档，并自动记录审计日志	可演示
权限隔离	员工侧只读，管理侧可维护，降低提示注入和误操作风险	可演示
文档转换	支持将 PDF、Word、文本制度文件转换为 Markdown 知识库文档	可演示
入离职 / 考勤流程	入职引导、离职流程、请假调班等操作型能力	规划中

系统结构

          员工侧 Bot           管理侧 Bot
         (HR小助手)          (HR管理后台)
              |                   |
              v                   v
        hr-assistant          hr-admin          Admin Portal
        Skills:               Skill:            (:18790)
        - hr-policy-qa        - hr-admin
        - hr-general
              |                   |
              v                   v
        memory_search         memory_write
        (知识库只读)          (知识库读写)
              |                   |
              +-------+-----------+
                      |
               ~/.openclaw/data/hr-policies/

• hr-assistant：员工入口，只读知识库，负责政策问答和普通 HR 咨询分流。
• hr-admin：管理入口，拥有知识库维护权限，用于 HR 管理员操作。
• Admin Portal：独立 Web 服务，用于文档上传、文档管理和审计日志查看。

目录结构

yomajiahr/
  install.sh              # 一键部署脚本
  config/                 # OpenClaw 配置模板和服务配置
  workspaces/             # 员工侧与管理侧 Agent workspace
  skills/                 # HR 场景 Skills
  admin-portal/           # 知识库管理 Web 服务
  docs/                   # 架构、部署和参赛文档
  SPECS.md                # 项目规格说明

快速运行

1. 安装

cd yomajiahr
./install.sh

脚本会完成：

1. 安装或检查 Node.js 与 OpenClaw。
2. 创建 ~/.openclaw/ 运行目录。
3. 复制 workspace、skills 和配置文件。
4. 安装 Admin Portal 依赖。

2. 配置环境变量

编辑 ~/.openclaw/.env，填入模型、Embedding、Bot 和管理后台所需密钥：

vi ~/.openclaw/.env

3. 启动服务

OPENCLAW_CONFIG_PATH=~/.openclaw/openclaw.json \
  openclaw gateway run --bind loopback --port 18789

cd admin-portal
OPENCLAW_STATE_DIR=~/.openclaw node server.mjs

4. 健康检查

curl http://127.0.0.1:18790/api/health

期望返回：

{"status":"ok","service":"hr-admin-portal"}

演示流程

1. HR 管理员通过 Admin Portal 上传一份脱敏制度文档。
2. 系统自动转换为 Markdown，推理标题、分类、文档编号、版本和生效日期。
3. 员工向 HR小助手 提问政策问题。
4. hr-policy-qa 检索知识库并返回带依据的回答。
5. 员工尝试请求删除或修改制度，系统因权限隔离无法执行。
6. HR 管理员查看审计日志，确认上传或维护动作可追踪。

文档

• 项目 Specs
• 架构说明
• 部署指南