- name
- navi-office
- description
- NaviOffice OA 办公系统 MCP 集成技能 - 覆盖系统管理、人力资源、考勤、财务、CRM、销售、采购、库存、项目、生产、计量检测 11 大模块，支持数据查询与业务操作。
NaviOffice OA 办公自动化系统
工具名称以模块前缀开头，详细参数查阅 references/ 对应文档。
| 模块 | 包含功能 | 文档 |
|---|---|---|
| 系统管理 | 公司信息、切换公司、部门列表、组织架构树、权限查询、新增部门 | system.md |
| 人力资源 | 员工列表/详情/新增、个人信息、生日提醒、合同到期、试用期到期、薪资查询 | hr.md |
| 考勤管理 | 打卡记录、全员考勤、月度/年度统计、部门统计、请假申请/记录/余额、加班记录 | attendance.md |
| 财务管理 | 收支看板、部门费用、应收应付总览、利润分析、收入统计、收支趋势、应收/应付列表与新增、费用报销 | finance.md |
| CRM | 客户列表/详情/新增、商机列表/详情/新增、销售业绩、销售漏斗 | crm.md |
| 销售管理 | 订单列表/详情/新增、合同列表/新增、应收计划生成、销售统计、销售排名、销售客户列表 | sales.md |
| 采购管理 | 供应商列表/新增、采购订单列表/详情/新增、采购统计 | purchase.md |
| 库存管理 | 物料列表/新增、仓库列表、库存列表/报表、低库存预警、入库单/出库单新增、出入库统计、周转分析 | inventory.md |
| 项目管理 | 我的项目/待办、项目列表/详情/新增、任务列表/详情/新增、工时统计、成本核算 | project.md |
| 生产管理 | 生产订单列表/详情/新增、工单列表/详情/新增、设备列表/详情 | mes.md |
| 计量检测 | 委托单列表/详情/新增、从订单生成委托单、器具列表、证书列表、业务员/工程师业绩统计 | calibration.md |
安装
clawdhub install navi-office环境变量与安全说明（必读）
# 必填
NAVI_OFFICE_API_TOKEN=your_api_token_here
# 可选（默认官方地址）
NAVI_OFFICE_API_URL=https://oa.teredy.com/api
# 可选：是否允许非官方域名，默认 false
NAVI_OFFICE_ALLOW_CUSTOM_DOMAIN=false- 必填：
NAVI_OFFICE_API_TOKEN - 可选：
NAVI_OFFICE_API_URL（默认https://oa.teredy.com/api） - 可选：
NAVI_OFFICE_ALLOW_CUSTOM_DOMAIN（默认false） - 请求头：
X-Api-Token: ${NAVI_OFFICE_API_TOKEN} - 默认仅从技能目录
.env读取凭证，避免误读当前工作目录下无关凭证 - 默认只允许官方域名
oa.teredy.com；若使用自定义地址，需显式设置NAVI_OFFICE_ALLOW_CUSTOM_DOMAIN=true - 若无法确认域名来源，请勿使用生产环境真实令牌
CLI 脚本
NaviOffice/scripts 目录包含可调用脚本：
navioffice.sh（Shell）navioffice.py（Python）navioffice.js（Node.js）
CLI 调用示例
部分工具的参数值本身是 JSON 字符串（如 employeeData），CLI 调用时需对内层 JSON 转义：
# 普通参数（值为基本类型）
mcporter call navi-office.hr_queryEmployeeInfo --args '{"employeeName":"张三"}'
# 参数值为 JSON 字符串时，内层需转义引号
mcporter call navi-office.hr_updateEmployee --args '{"employeeId":1051,"employeeData":"{\"employeeStatus\":1}"}'渐进式工具加载（强制）
为减少 token 消耗，禁止首轮把全量工具塞入上下文，必须按下面流程：
- 先调用
tool_catalog，获取可用模块目录和工具数量 - 根据用户问题只选择最相关模块
- 再调用
load_module_tools，参数示例：{"module":"attendance","detailLevel":"brief"} - 若
brief不足以确定参数，再对同一模块使用detailLevel=full - 只有跨模块问题才追加加载其他模块，避免全量加载
调用规则
- 名称→ID：用户提供名称时，先调查询接口获取 ID 再操作（如客户名→customerId、部门名→deptId、员工名→employeeId）
- 模糊查询：
employeeNamedeptNamecustomerNameorderNamesupplierNamematerialNameequipmentNameinstrumentName等字段可直接传名称，无需先查 ID - 查询条件：能够精准查询的参数一定要带上，尽量不要查询全量列表
- 分页：列表默认每页 10 条，用
page/limit调整 - 日期格式：
yyyy-MM-dd或yyyyMM - 权限：无权限时返回明确错误提示
- 工具加载策略：默认
brief，仅在必要时full