galaxy-opc-plugin

v0.3.7

Published

12 days ago

星环 Galaxy OPC — 一人公司孵化与赋能平台 OpenClaw 插件

0High
0Medium
0Low

p3ngsam

openclaw openclaw-plugin opc one-person-company ai business startup

星环OPC中心 — OpenClaw 插件

一人公司(OPC)孵化与赋能平台，基于 OpenClaw 构建的 AI 员工全套解决方案。

✨ 功能概览

| 模块 | 工具名 | 功能 | |------|--------|------| | 核心管理 | opc_core | 公司注册、客户管理、收支记录 | | AI 员工 | opc_staff | 行政/财务/HR/法务/市场/运营岗位配置 | | 财税管理 | opc_finance | 发票、增值税、所得税、纳税申报、应收应付管理 | | 法务合同 | opc_legal | 合同管理、风险评估、到期提醒 | | 人力资源 | opc_hr | 员工档案、薪资、社保、公积金 | | 新媒体运营 | opc_media | 内容创建、发布排期、数据分析 | | 项目管理 | opc_project | 项目、任务、进度、预算跟踪 | | 投融资 | opc_investment | 融资轮次、投资人、股权结构 | | 服务采购 | opc_procurement | 服务项目、采购订单、费用统计 | | 生命周期 | opc_lifecycle | 里程碑、大事记、时间线报告 | | 运营监控 | opc_monitoring | 指标记录、告警管理、KPI 看板 | | 订单中台 | opc_order | 报价管理、合同流转、里程碑跟踪 | | 新功能 | v0.3: 5大功能 + v0.4: 订单闭环 | 见下方新增功能部分 |

自动提醒服务（后台每小时扫描）：

税务申报到期提醒（7天内）
合同到期提醒（30天内）
里程碑到期提醒（7天内） ← 新增
应收风险分层（normal/warning/critical） ← 新增
现金流预警（净流出超 5000 元）
融资轮次截止跟进

管理后台 http://localhost:18789/opc/admin：

公司仪表盘、财务总览、监控中心
一键进入公司 AI 助手对话
SOP 使用指南

🎯 v0.3 新增功能

1. 智能新手引导 (Onboarding Flow)

首次使用时自动触发个性化引导，通过 3 个问题了解用户需求：

业务阶段: 想法阶段 / 准备注册 / 已注册 / 运营中
业务类型: 内容创作 / 技术服务 / 产品销售 / 其他
预计年收入: <10万 / 10-50万 / >50万

根据回答自动生成个性化启动清单，支持清单项目勾选和中断后继续。

文件: src/opc/briefing-builder.ts

2. 每日智能简报 (Daily Brief)

每天 9:00 主动推送实时简报，包含：

待办提醒: 逾期款项催收、合同到期、税务申报、客户回访
经营数据: 本周/本月收入、支出、利润、现金余额
AI 员工汇报: 财务顾问现金流预警、法务合规提醒、运营进度汇报
推送渠道: OpenClaw 对话 + 飞书 Webhook

文件: src/opc/proactive-service.ts, src/opc/briefing-builder.ts

3. 监控中心 Dashboard

一屏看清公司运营状态，包含：

关键指标卡片: 本月收入/利润、现金余额、应收账款
风险预警列表: 现金流预警(<2月)、合同到期(30天内)、逾期款项、税务提醒
今日待办: 按优先级(紧急/重要/一般)排序，支持快速操作
AI 建议: 基于数据分析的可执行建议，包含行动按钮

访问方式: http://localhost:18789/opc/admin → Dashboard 页签

文件: src/api/dashboard.ts, src/web/config-ui.ts

4. 应收应付管理 (Payment Management)

专业的应收应付账款管理系统：

CRUD 操作:

创建应收/应付记录（含客户、金额、到期日期）
查询列表（按方向/状态/客户筛选）
更新到账金额和状态（支持部分到账）
删除记录和批量操作

核心功能:

自动逾期检测（超期自动标记）
应收应付汇总统计（待收/待付总额、逾期笔数）
发票和合同关联
催款提醒和对账

访问方式: OpenClaw 对话或管理后台"收付款" Tab

文件: src/tools/finance-tool.ts (扩展 5 个新 action)

5. 智能记账 (Smart Accounting)

自然语言记账，智能分类和提醒：

功能:

自然语言解析: 支持"记一笔支出，今天请客户吃饭花了500块"
自动分类: 业务招待费/办公费用/固定资产/生活支出等
智能提醒: "记得保存发票可抵税"、"超出本月预算"、"需要开发票吗？"
连续记账: 支持多笔账目连续输入和修改

使用场景:

用户: "记一笔支出，买了办公用品，150块"
AI: ✓ 已记录
   - 类型: 支出
   - 金额: ¥150
   - 分类: 办公费用 (可抵扣)
   - 提醒: 记得申报时扣除，需要保存发票吗？

文件: src/tools/finance-tool.ts, src/opc/intelligence-engine.ts

🎯 v0.4 新增功能（订单闭环）

6. 订单中台 (Order Management)

签单到回款的全流程管理，每个单子有状态、有金额、有责任时间：

核心流程：

客户咨询 → 创建报价 → 报价转合同 → 签约确认 → 里程碑跟踪 → 款项到账 → 自动记账

主要功能：

报价管理: 创建报价单（自动编号 QT-YYYYMM-NNN），支持多明细行
报价转合同: 一键转合同，自动创建里程碑和应收记录
里程碑跟踪: 签约→初稿→终稿，自动流转状态
到期提醒: 7天内到期的里程碑自动推送
进行中订单: 查看所有活跃合同及进度

自动化亮点：

✅ 报价转合同 → 自动创建 N 个里程碑 + N 条应收
✅ 签约确认 → 自动启动第一个里程碑
✅ 里程碑完成 → 自动启动下一个里程碑
✅ 到账登记 → 自动创建交易记录 + 更新里程碑

工具名: opc_order

文件: src/tools/order-tool.ts

使用指南: 查看 ORDER_WORKFLOW_GUIDE.md

7. 回款助手增强 (Collection Assistant)

AI 赋能的应收催款和风险管理：

核心功能：

AI 催款文案: 自动生成礼貌/坚定/紧急三种语气的催款邮件、微信、短信
风险分层: 自动分类 normal（≤7天）/ warning（8-30天）/ critical（>30天）
一键到账: 登记收款，自动创建交易记录，自动完成里程碑
自动提醒: 到期前 3/7 天、逾期 7/15/30 天自动推送

风险分层规则： | 风险等级 | 逾期天数 | 自动操作 | |----------|----------|----------| | normal | ≤ 7 天 | 常规跟进 | | warning | 8-30 天 | 电话催收 | | critical | > 30 天 | 创建告警，建议升级催收 |

示例对话：

你: "客户A逾期15天了，帮我生成催款文案"
AI: [调用 generate_collection_notice]
    已生成礼貌催款文案：
    - 邮件：【友情提醒】XX项目款项到期提醒
    - 微信：张总好！初稿款3600已到期，麻烦核对一下~
    - 短信：【XX公司】尊敬的客户，您有一笔3600元...

工具名: opc_finance (扩展 4 个新 action)

文件: src/tools/finance-tool.ts

8. 数据闭环追溯

完整的业务数据链：

报价单 ID → 合同 ID → 里程碑 ID → 应收 ID → 交易 ID

每一笔钱都有完整的来龙去脉，支持：

从报价单追溯到最终收款
从交易记录反查对应的合同和里程碑
生成客户价值分析报告

📦 安装

前提条件

已安装并运行 OpenClaw Gateway
Node.js 20+

方式一：直接克隆到插件目录（推荐）

# 进入你的 OpenClaw 插件目录
cd <your-openclaw-dir>/extensions

# 克隆插件
git clone https://github.com/P3ngSaM/opc.git opc-platform

# 安装依赖
cd opc-platform
npm install

方式二：手动下载

下载 Release 压缩包，解压到 <openclaw>/extensions/opc-platform/，然后 npm install。

⚙️ 配置

在 OpenClaw 配置文件 ~/.openclaw/openclaw.json 中启用插件：

{
  "plugins": {
    "entries": {
      "opc-platform": {
        "enabled": true,
        "config": {
          "dbPath": "~/.openclaw/opc-platform/opc.db"
        }
      }
    }
  }
}

dbPath 可选，默认为 ~/.openclaw/opc-platform/opc.db，支持 ~/ 路径前缀。

🚀 快速开始

第一次使用（自动触发新手引导）

重启 OpenClaw Gateway 后，对 AI 说：

我想创建一家一人公司，帮我注册吧

系统会自动触发新手引导：

询问你的业务阶段、业务类型、预计年收入
生成个性化启动清单
引导你完成首个任务

典型 SOP 流程

1. 新手引导        → 首次使用自动触发，生成启动清单
2. 公司注册        → opc_core: register_company
3. 激活公司        → opc_core: activate_company
4. 配置 AI 员工    → opc_staff: init_default_staff
5. 日常运营        → 智能记账、应收应付管理、定期简报
6. 监控仪表盘      → 访问 Dashboard 查看关键指标和风险预警
7. 融资管理        → opc_investment: create_round
8. 生命周期报告    → opc_lifecycle: generate_report

使用新增功能

查看每日简报

AI: 给我发送今天的经营简报

（系统也会在每天 9:00 自动推送）

管理应收应付

AI: 记录一笔应收账款，客户是张三，金额5000，3月15号到期
AI: 列出所有逾期的应收款项
AI: 更新张三的应收账款状态为已到账

智能记账

AI: 记一笔支出，今天请客户吃饭花了800块
AI: 记录一笔收入，某某客户付款了2万

访问 Dashboard

浏览器打开: http://localhost:18789/opc/admin
点击"监控中心"查看关键指标、风险预警和今日待办

📁 项目结构

opc-platform/
├── index.ts                 # 插件入口
├── openclaw.plugin.json     # 插件元数据
├── package.json
├── src/
│   ├── api/                 # HTTP API 路由
│   ├── db/                  # SQLite 数据库适配器 & Schema
│   ├── opc/                 # 上下文注入、提醒服务、工作区工厂
│   ├── tools/               # 11 个 AI 工具模块
│   └── web/                 # 管理后台 UI (config-ui) & Landing Page
└── skills/                  # OpenClaw Skills 配置
    ├── basic-crm/
    ├── basic-finance/
    ├── company-registration/
    └── ...（共 11 个技能包）

🗄️ 数据库

使用 SQLite（WAL 模式），自动迁移，无需手动建表。主要数据表：

opc_companies — 公司档案
opc_transactions — 收支流水
opc_contracts — 合同管理
opc_tax_filings — 税务申报
opc_employees / opc_hr_records — HR 档案
opc_investment_rounds — 融资轮次
opc_alerts — 告警记录
opc_staff_config — AI 员工角色配置
...共 19 张表

🛠️ 开发

# 类型检查
npx tsc -p tsconfig.json --noEmit

# 构建管理后台 UI（如修改了 UI）
# 在 openclaw 根目录执行：
node scripts/ui.js build