企服助手 (Enterprise Service Assistant)

专业的园区企业服务智能助手，提供全方位的企业服务数字化支持。

🎯 核心能力

8 大业务模块

🔒 数据安全机制（v1.3.0 新增）

四大铁律：凭证不外泄、台账不外传、记忆不跨会话、群聊必脱敏。

• 🛡️ 运行时自动脱敏：输出前自动替换企业全名→编号、金额→汇总、个人信息→星号
• 🔐 会话隔离：主私聊可查看全部，群聊仅可见脱敏汇总，定时任务仅引用汇总数据
• 🚨 安全审计命令：输入 @企服助手 安全检查 即触发5项扫描（凭证/URL/项目名/群聊/文件权限）
• 📊 数据流向矩阵：明确各类数据的读/写/输出/群聊权限

详细机制请参考 references/数据安全机制.md

📦 安装与配置

安装

clawhub install enterprise-service-assistant

配置步骤（必做！）

本 Agent 不含任何真实数据，用户必须自行创建知识库：

1. 创建知识库目录: workspace/knowledge-base/
2. 复制模板: references/知识库模板.md → workspace/knowledge-base/PROJECT_KB.md
3. 填写配置:
   • 数据源 URL（Excel 台账腾讯文档链接）
   • 企微 Webhook 地址
   • 业务规则（催缴阈值、SLA 时限等）
   • 园区名称和占位符
4. 重启 OpenClaw 加载配置

💡 详细引导请参考 references/新用户引导.md

🏗️ 架构设计

分层架构（保护隐私）

企服助手 Agent
├── 通用层（随 Agent 分享，本包内容）
│   ├── AGENTS.md          # 通用行为规则和工作流程
│   ├── SOUL.md            # 通用人格设定
│   ├── IDENTITY.md        # 通用身份设定
│   ├── TOOLS.md           # 通用工具说明
│   ├── HEARTBEAT.md      # 心跳配置
│   ├── MEMORY.md          # 长期记忆模板
│   └── USER.md            # 用户配置模板
│
├── references/（参考文件，纯模板）
│   ├── 知识库模板.md       # PROJECT_KB.md 填写模板
│   └── 新用户引导.md       # 首次使用引导流程
│
└── 用户本地层（❌ 不在 GitHub/ClawHub 中）
    └── knowledge-base/PROJECT_KB.md   # 用户自建的项目配置

数据安全承诺

• ✅ 本打包不包含: knowledge/PROJECT_KB.md、memory/*.md、任何 Excel 台账、真实企业数据
• ✅ references/ 目录: 全部为纯模板（📝待填写），不含任何本地数据
• ✅ 用户数据安全: 所有园区真实数据（房源、租户、报价）必须用户自建到 workspace/knowledge-base/
• ✅ SKILL.md 读取逻辑: workspace 优先 → references fallback

🛠️ 技能依赖

安装本 Agent 后，需确保以下技能可用：

• tencent-docs + mcporter — 腾讯文档操作
• docx / pdf / xlsx — 文档处理
• qclaw-cron-skill — 定时任务
• online-search — 在线搜索
• xbrowser — 浏览器自动化

📖 使用示例

# 客户查询
@企服助手 查询客户 T1-601
@企服助手 客户画像 上海铭尤力
@企服助手 查询风险客户

# 费用管理
@企服助手 催缴检查
@企服助手 统计费用收缴率

# 工单管理
@企服助手 查看待处理工单
@企服助手 工单超时升级

# 服务匹配
@企服助手 服务匹配
@企服助手 走访管理

# 报告生成
@企服助手 生成本月KPI报告
@企服助手 导出客户台账到腾讯文档

# 定时任务
@企服助手 设置每月1号提醒催缴
@企服助手 查看定时任务列表

🔄 版本历史

v1.3.0 (2026-05-29)

• ✅ 新增完整运行时数据安全机制
• ✅ 四大铁律：凭证不外泄、台账不外传、记忆不跨会话、群聊必脱敏
• ✅ 运行时自动脱敏规则（企业名→编号、金额→汇总、个人信息→星号）
• ✅ 会话隔离机制（私聊/群聊/定时任务分级访问）
• ✅ 安全审计命令：@企服助手 安全检查
• ✅ 新增 references/数据安全机制.md 详细文档

v1.2.0 (2026-05-29)

• ✅ 新增 SECURITY.md 安全声明文件
• ✅ 清理 MEMORY.md 中真实项目名称引用
• ✅ references/ 确认全部为纯模板

v1.1.0 (2026-05-29)

• ✅ 知识库分离重构
• ✅ references/ 恢复为纯模板

v1.0.0 (2026-05-29)

• ✅ 初始版本发布

📞 支持与反馈

• 更新: clawhub update enterprise-service-assistant
• 卸载: clawhub uninstall enterprise-service-assistant
• Issues: 在 ClawHub 提交

⚠️ 重要提示: 这是通用版本，不包含任何真实项目数据。使用者必须按照 references/知识库模板.md 创建自己的 knowledge-base/PROJECT_KB.md 才能使用完整功能。