安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install frihet-erp
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 frihet-erp。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Frihet ERP skill 引导使用 Frihet MCP 服务器的 AI 代理执行安全、可预测的操作。它确立读取优先的默认原则，说明何时需要人工审批，并通过幂等性和重试前协调实践，帮助防止重复或意外变更。
此套件专为 Openclaw Skills 和兼容的代理宿主设计，不会预先注册 MCP 服务器或写入工具。用户必须在 OAuth 授权前，明确配置包含 39 项只读操作的字面值允许列表，然后仅在需要时选择启用其他操作。

应用场景

使用只读工具查询 Frihet 发票、客户、费用、产品、属性、交易或其他业务记录。
调用操作前，检查拟执行的 Frihet 操作属于读取、草稿，还是会产生外部副作用的操作。
准备本地草稿，展示相关字段和总额，并暂停以供人工审核后再完成操作。
通过明确的只读工具允许列表，将 Frihet MCP 接入 OpenClaw 或其他受支持的代理宿主。
写入结果不明确时，先检查服务器状态，再考虑重试，以安全恢复。
遇到权限范围不足错误时，升级给获授权用户处理，而不是尝试绕过限制。

工作原理

安装 skill 套件。默认不会注册 Frihet MCP 工具。
将 Frihet MCP 端点添加到代理宿主，并明确选择 39 个字面值只读操作名称。避免使用 glob，以免新添加的上游工具被自动启用。
设置允许列表后再完成 OAuth。OAuth 凭据和令牌由宿主管理。
对于请求的操作，查阅 Frihet 权威安全契约和操作元数据；尝试写入前先读取目标的最新状态。
对于本地草稿操作，准备并展示草稿，然后暂停以供人工审核，再发送或完成操作。对于标记为具有外部副作用的操作，必须取得人工审批。
如果写入结果不明确，请检查 Frihet 记录，并遵守其幂等键，再决定是否需要再次调用。
将服务器范围和权限视为权威依据。遇到 403 insufficient_scope 响应时应升级处理，不要尝试绕过。

配置指南

安装套件，然后使用明确的只读允许列表注册 Frihet MCP。顺序很重要：应用允许列表前，不要授权 OAuth。

安装 skill 套件；不会预先注册 MCP 服务器。

clawhub install @frihet/agent-plugin

使用字面值只读工具允许列表注册 Frihet。

openclaw mcp add frihet
--url https://mcp.frihet.io/mcp
--transport streamable-http
--auth oauth
--include 'list_invoices,get_invoice,search_invoices,list_clients,get_client,list_client_activities,list_expenses,get_expense,list_vendors,get_vendor,list_quotes,get_quote,list_products,get_product,list_recurring_invoices,get_recurring_invoice,list_reservations,get_reservation,list_properties,list_bank_accounts,get_bank_account,list_transactions,list_deposits,get_deposit,list_webhooks,get_webhook,list_team_members,list_kitchen_tickets,get_kitchen_ticket,list_kitchen_stations,list_menu_items,list_sales,get_sale,list_terminals,get_time_summary,get_quarterly_taxes,get_business_context,get_monthly_summary,anomaly_list'

应用只读允许列表后再授权。

openclaw mcp login frihet
对于 Hermes，请添加服务器，并使用其交互式配置在授权前取消选择会修改数据的操作。在 Cursor、ChatGPT 或 Gemini 中，请使用宿主的 allowed-tools 面板，并输入相同的 39 个字面值名称。不要使用 list_* 之类的通配模式。之后如需启用写入，请明确配置所需操作，并遵循宿主的人工作审批能力；skill 本身不会授予权限。
Frihet ERP 运营契约 数据架构与分类体系
此 skill 依赖 Frihet 的权威运营契约和操作级能力元数据，而不是根据工具名称猜测安全性。
资源 用途
Frihet-io/frihet-mcp 中的 docs/agent-onboarding.json 当前关于操作安全性和能力的机器可读事实来源。
vendor/frihet-mcp-onboarding.json 用于离线验证的随附契约副本。
optional-mcps/frihet/manifest.yaml 预先检查只读操作的连接器清单。
references/mcp.json.example 配置参考示例；此套件有意不提供根目录级的 mcp.json。
tests/test_security_posture.py 检查套件是否保持其安全态势，并记录字面值允许列表。
每项操作都可能通过 meta["io.frihet/capability"] 暴露元数据，字段包括 operation、category、mutates_state、idempotency_required、external_side_effects 和 human_authority_required。运行时应使用这些元数据作出策略决策。默认允许列表包含 39 个只读工具：28 个 list* 操作、8 个 get_* 操作、search_invoices、anomaly_list，以及适用的时间、税务或业务情境摘要。修改数据的操作不会预先启用。

高级特性

明确指定字面值只读允许列表，可防止新的上游操作在未提醒的情况下被授权。
能力元数据提供有关数据修改、幂等性要求、外部副作用和人工授权的结构化信号。
运营契约要求写入前重新读取目标，并在重试结果不明确的操作前协调服务器状态。
Hermes 可使用配套 Frihet 插件的
pre_tool_call
hook，将契约指定的操作导向其审批关卡。
在所述插件模型中，OpenClaw 没有等效的宿主级审批 hook；skill 会指示代理暂停并请求明确确认，同时通过按服务器进行工具筛选提供结构性控制。
由宿主管理的 OAuth 会将访问令牌和刷新令牌保留在 skill 之外；插件不会读取、复制、刷新或冒用凭据。
契约验证测试会强制检查关键安全要求，包括不存在根目录级
mcp.json
，以及记录 39 个名称的允许列表。

name: frihet description: | Read-first integration with the Frihet ERP canonical MCP. The skill is the
portable operating contract: it documents the read-before-write, draft-show-
stop, externalSideEffects-driven approval, idempotency, and reconcile-before-
retry patterns the Frihet MCP expects.

USE WHEN: a task involves Frihet ERP, a Frihet MCP tool, or a question about
whether a specific Frihet operation is read, draft, or irreversible. Pair
with the live MCP server at https://mcp.frihet.io/mcp (Streamable HTTP,
OAuth 2.1 + PKCE) for execution.

DO NOT USE FOR: non-Frihet ERPs, generic MCP guidance, or any operation
whose irreversible status is unclear. When in doubt, run the canonical
contract check below before issuing the call.