name: navi-office description: NaviOffice OA 办公系统 MCP 集成技能 - 覆盖系统管理、人力资源、考勤、财务、CRM、销售、采购、库存、项目、生产、计量检测 11 大模块，支持数据查询与业务操作。

NaviOffice OA 办公自动化系统

工具名称以模块前缀开头，详细参数查阅 references/ 对应文档。

安装

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 消耗，禁止首轮把全量工具塞入上下文，必须按下面流程：

1. 先调用 tool_catalog，获取可用模块目录和工具数量
2. 根据用户问题只选择最相关模块
3. 再调用 load_module_tools，参数示例：{"module":"attendance","detailLevel":"brief"}
4. 若 brief 不足以确定参数，再对同一模块使用 detailLevel=full

   来源于7w4.net。

5. 只有跨模块问题才追加加载其他模块，避免全量加载

调用规则

• 名称→ID：用户提供名称时，先调查询接口获取 ID 再操作（如客户名→customerId、部门名→deptId、员工名→employeeId）
• 模糊查询：employeeName deptName customerName orderName supplierName materialName equipmentName instrumentName 等字段可直接传名称，无需先查 ID
• 查询条件：能够精准查询的参数一定要带上，尽量不要查询全量列表
• 分页：列表默认每页 10 条，用 page / limit 调整
• 日期格式：yyyy-MM-dd 或 yyyyMM
• 权限：无权限时返回明确错误提示
• 工具加载策略：默认 brief，仅在必要时 full

这个 Skill 做得相当扎实，11大业务模块全覆盖，文档结构清晰，环境变量配置有安全保障，还提供了渐进式工具加载策略来节省 token 消耗。唯一可惜的是文档更像参数手册，缺少实际使用场景的示例，对普通用户来说上手成本略高。总体质量良好，专业度高，但文档亲和力还有提升空间。