agentCLAWHUBUnverified
fn-fpk
飞牛NAS (fnOS) FPK 应用打包开发技能。使用此技能开发和打包飞牛NAS第三方应用（.fpk），包括：Native 应用（Node.js/Python/Java/Go/Shell 等）和 Docker 应用。涵盖整个开发周期：开发环境准备、fnpack 创建项目、manifest 配置、权限/资源配置、用户入口配置（应用入口 app/ui/config + 桌面图标 + 文件右键菜单）、生命周期脚本编写（cmd/main）、向导配置（wizard）、图标规范、CGI 反向代理、统一网关注册/认证、运行时环境（Python/Node.js/Java）、中间件服务（Redis/MinIO/RabbitMQ/MariaDB）、依赖管理、fnpack CLI 打包、appcenter-cli 测试安装、到上架发布；以及飞牛开放平台 Open API 接入（文件授权、页面路由、界面语言/主题、后端平台配置查询、前端 JS SDK @trimjs/web-app）。用户提到"飞牛"、"fnOS"、"FPK"、"飞牛应用"、"开放 API"、"Open API"、"@trimjs/web-app"、"文件授权"、"授权路径"、"trim.file"时触发。 Skill: fn-fpk Owner: dalingo81 Summary: 飞牛NAS (fnOS) FPK 应用打包开发技能。使用此技能开发和打包飞牛NAS第三方应用（.fpk），包括：Native 应用（Node.js/Python/Java/Go/Shell 等）和 Docker 应用。涵盖整个开发周期：开发环境准备、fnpack 创建项目、manifest 配置、权限/资源配置、用户入口配置（应用入口 app/ui/config + 桌面图标 + 文件右键菜单）、生命周期脚本编写（cmd/main）、向导配置（wizard）、图标规范、CGI 反向代理、统一网关注册/认证、运行时环境（Python/Node.js/Java）、中间件服务（Redis/MinIO/RabbitMQ/MariaDB）、依赖管理、fnpack CLI 打包、appcenter-cli 测试安装、到上架发布；以及飞牛开放平台 Open API
OpenClaw
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 2026
Version
1.3.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.3.1release · observed Aug 28, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: medium.
clawhub skill install s17fm5y7gm95aa1r5m04hw8tbs87dqj6:fn-fpk- Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-dalingo81-fn-fpk/snapshot"
Documentation
CLAWHUB
143,453 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: fn-fpk
description: 飞牛NAS (fnOS) FPK 应用打包开发技能。使用此技能开发和打包飞牛NAS第三方应用（.fpk），包括：Native 应用（Node.js/Python/Java/Go/Shell 等）和 Docker 应用。涵盖整个开发周期：开发环境准备、fnpack 创建项目、manifest 配置、权限/资源配置、用户入口配置（应用入口 app/ui/config + 桌面图标 + 文件右键菜单）、生命周期脚本编写（cmd/main）、向导配置（wizard）、图标规范、CGI 反向代理、统一网关注册/认证、运行时环境（Python/Node.js/Java）、中间件服务（Redis/MinIO/RabbitMQ/MariaDB）、依赖管理、fnpack CLI 打包、appcenter-cli 测试安装、到上架发布；以及飞牛开放平台 Open API 接入（文件授权、页面路由、界面语言/主题、后端平台配置查询、前端 JS SDK @trimjs/web-app）。用户提到"飞牛"、"fnOS"、"FPK"、"飞牛应用"、"开放 API"、"Open API"、"@trimjs/web-app"、"文件授权"、"授权路径"、"trim.file"时触发。
---
# fn-fpk — 飞牛 NAS fnOS FPK 应用开发
> 基于官方文档 https://developer.fnnas.com 于 2026-08-28 全面更新（新增开放平台 Open API 整章）。
> 系统架构: x86_64 (AMD64) 与 ARM64 均支持；Linux 内核 6.12.18+, Debian 发行版。
> fnpack 版本: 1.2.3, appcenter-cli 预装在 fnOS 中。
---
## 1. 开发环境准备
### 1.1 系统要求
- **fnOS 版本**: ≥ 0.9.27
- **架构**: 支持 **x86_64 (AMD64)** 与 **ARM64**。manifest `platform` 字段可选 `x86` / `arm` / `all`（Docker 应用常用 `all`）；纯 Native 应用需按目标架构交叉编译。fnpack 同时提供 `linux-amd64` 与 `linux-arm64` 二进制
- **存储**: 至少创建一个存储空间
- **权限**: 管理员权限（安装/卸载/系统设置）
### 1.2 开发方式
- **本地开发**: 在本地用 fnpack CLI 打包，再传送到 fnOS 设备安装
- **远程开发**: SSH 到 fnOS 设备直接开发，结合 `appcenter-cli install-local` 快速测试
### 1.3 技术栈
| 语言/框架 | 支持情况 |
|-----------|---------|
| Node.js | ✅ (v14/v16/v18/v20/v22) |
| Python | ✅ (3.8/3.9/3.10/3.11/3.12) |
| Java | ✅ (11/17/21 OpenJDK) |
| Go | ✅ Linux 运行时支持 |
| Shell | ✅ (Bash) |
| HTML/JS/CSS | ✅ 前端任意框架 |
### 1.4 CLI 工具
#### fnpack 打包工具
下载地址：https://static2.fnnas.com/fnpack/fnpack-1.2.3-{os}-{arch}
| 平台 | 二进制 |
|------|--------|
| Windows x86 | `fnpack-1.2.3-windows-amd64` |
| Linux x86 | `fnpack-1.2.3-linux-amd64` |
| Linux ARM | `fnpack-1.2.3-linux-arm64` |
| macOS Intel | `fnpack-1.2.3-darwin-amd64` |
| macOS M 系列 | `fnpack-1.2.3-darwin-arm64` |
安装：
```bash
chmod +x fnpack-1.2.3-linux-amd64
sudo mv fnpack-1.2.3-linux-amd64 /usr/local/bin/fnpack
fnpack --help
```
#### appcenter-cli （预装在 fnOS 中）
```bash
# 安装 fpk 文件
appcenter-cli install-fpk myapp.fpk
# 从本地目录安装（开发模式，无需打包）
cd /path/to/myapp
appcenter-cli install-local
# 管理应用
appcenter-cli list # 已安装列表
appcenter-cli start myapp # 启动
appcenter-cli stop myapp # 停止
# 手动安装功能（仅测试用途）
appcenter-cli manual-install # 查看状态
appcenter-cli manual-install enable # 开启
appcenter-cli manual-install disable # 关闭
# 设置默认存储空间
appcenter-cli default-volume # 查看当前
appcenter-cli default-volume 1 # 设置存储空间1
# 静默安装（跳过向导）
appcenter-cli install-fpk myapp.fpk --env config.env
```
---
## 2. 应用类型
| 类型 | 描述 | 创建命令 |
|------|------|----------|
| **Native 应用** | 直接运行在 fnOS 上的应用 | `fnpack create <appname>` |
| **Docker 应用** | 基于 Docker Compose 容器编排 | `fnpack create <appname> --template docker` |
| **纯服务应用**（无 UI） | 无 Web 访问入口 | 加 `--without-ui true` |
---
## 3. 项目结构与核心文件
### 3.1 通用结构（fnpack create 生成）
```
myapp/
├── app/ # 应用可执行文件/资源目录
│ ├── server/ # 后台服务程序（Native 应用）
│ ├── ui/ # Web _meta.json
{
"ownerId": "kn77pvxj7zf4hrd6q5ydgn2js5826rny",
"slug": "fn-fpk",
"version": "1.3.1",
"publishedAt": 1787900127952
}skill-card.md
## Description:
Guides developers through building and packaging third-party Feiniu NAS fnOS FPK apps, including native and Docker apps, manifests, permissions, lifecycle scripts, UI entries, Open API integration, and testing or publishing workflows.
This skill is ready for commercial/non-commercial use.
## Publisher:
[dalingo81](https://clawhub.ai/user/dalingo81)
### License/Terms of Use:
MIT-0
## Use Case:
Developers and engineers use this skill to produce fnOS FPK packaging guidance, shell commands, manifests, permission/resource configuration, lifecycle script examples, and Open API integration patterns for Feiniu NAS applications.
### Deployment Geography for Use:
Global
## Known Risks and Mitigations:
Risk: Unsafe shell examples could lead an agent to generate vulnerable NAS lifecycle scripts.
Mitigation: Review generated lifecycle scripts before use, validate or parse configuration files instead of sourcing them as shell, and avoid copying unsafe shell examples as-is.
Risk: The skill may suggest installing fnpack system-wide from a downloaded binary.
Mitigation: Verify fnpack from an authenticated source before installation and confirm the selected binary matches the target OS and architecture.
Risk: Generated packages could run with excessive privileges.
Mitigation: Keep apps running as the package user unless root is strictly required and justified for the specific application.
## Reference(s):
- [Feiniu fnOS Developer Documentation](https://developer.fnnas.com)
- [Feiniu Open API Overview](https://developer.fnnas.com/api/overview/)
- [fnpack 1.2.3 Download Pattern](https://static2.fnnas.com/fnpack/fnpack-1.2.3-{os}-{arch})
## Skill Output:
**Output Type(s):** [Guidance, Markdown, Code, Shell commands, Configuration]
**Output Format:** [Markdown guidance with code blocks, configuration snippets, and shell commands]
**Output Parameters:** [1D]
**Other Properties Related to Output:** [May include fnpack and appcenter-cli command examples plus fnOS manifest, resource, privilege, UI, wizard, and lifecycle-script snippets.]
## Skill Version(s):
1.3.1 (source: server release evidence)
## Ethical Considerations:
Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.Github ReposUpdated 1d agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/dalingo81/skills/fn-fpk",
"sourceUrl": "https://clawhub.ai/dalingo81/skills/fn-fpk",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T01:40:48.672Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-dalingo81-fn-fpk/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-dalingo81-fn-fpk/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T01:40:48.672Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/dalingo81/fn-fpk",
"sourceUrl": "https://clawhub.ai/dalingo81/fn-fpk",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T01:40:48.672Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.3.1",
"href": "https://clawhub.ai/dalingo81/fn-fpk",
"sourceUrl": "https://clawhub.ai/dalingo81/fn-fpk",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T06:55:27.952Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-dalingo81-fn-fpk/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-dalingo81-fn-fpk/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.3.1",
"description": "新增飞牛开放平台 Open API 整章（文件授权/页面路由/界面语言主题/后端平台配置/前端 JS SDK @trimjs/web-app）；fnpack 升级至 1.2.3；修正架构支持 ARM64",
"href": "https://clawhub.ai/dalingo81/fn-fpk",
"sourceUrl": "https://clawhub.ai/dalingo81/fn-fpk",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T06:55:27.952Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.