Fluora Setup - Interactive Onboarding Wizard (GitHub Version)
Complete setup wizard for accessing the Fluora marketplace. Uses the official GitHub repository for the latest working version.
What This Skill Does
Automates the entire Fluora setup process:
- 1. ✅ Clones
fluora-mcp from GitHub (https://github.com/fluora-ai/fluora-mcp) - ✅ Installs dependencies and builds locally
- ✅ Generates wallet (auto-creates
~/.fluora/wallets.json) - ✅ Extracts wallet address from private key
- ✅ Displays funding instructions
- ✅ Configures mcporter with local Fluora registry
- ✅ Verifies setup is working
Prerequisites
- - Node.js 18+
- npm
- git
- mcporter installed (optional, will guide if missing)
Usage
From OpenClaw Agent
CODEBLOCK0
Direct Script Usage
CODEBLOCK1
What Gets Created/Modified
1. Local fluora-mcp Repository
CODEBLOCK2
Cloned from GitHub and built locally with all dependencies.
2. Wallet File
CODEBLOCK3
Auto-generated on first run with structure:
CODEBLOCK4
3. mcporter Config
~/.openclaw/workspace/config/mcporter.json
(or
~/.mcporter/mcporter.json if workspace config doesn't exist)
Adds Fluora registry pointing to local build:
CODEBLOCK6
Note: Uses the LOCAL GitHub build, not npx fluora-mcp from npm, because the npm version has a parameter parsing bug.
Wallet Funding
The skill will display your wallet address and instructions:
CODEBLOCK7
Network Details
- - Network: Base (Coinbase L2)
- Token needed: USDC only (for service payments, $5-10 recommended)
- Payments: Handled automatically with USDC, no additional tokens needed
Where to Get USDC on Base
From an exchange:
- - Coinbase: Withdraw USDC → Select "Base" network
- Binance: Withdraw USDC → Select "Base" network
- OKX: Similar process
Bridge from Ethereum:
- - https://bridge.base.org
- Transfer USDC from Ethereum → Base
Buy directly on Base:
- - Use Coinbase Wallet or Rainbow Wallet
- Buy USDC directly on Base
Verification
The skill automatically verifies:
- - ✅ fluora-mcp cloned from GitHub
- ✅ Dependencies installed
- ✅ Build successful
- ✅ Wallet file exists
- ✅ Private key is valid
- ✅ Wallet address derived correctly
- ✅ mcporter config is valid JSON
- ✅ Fluora registry configured with local path
Optional: Check wallet balance (after funding)
Return Value
CODEBLOCK8
After Setup
Test Your Setup
CODEBLOCK9
Start Building
Now you can use the other Fluora skills:
- 1. workflow-to-monetized-mcp - Generate your own service
- railway-deploy - Deploy to Railway
- fluora-publish - List on marketplace
Troubleshooting
"git clone failed"
Ensure you have git installed and internet access.
"npm install failed"
Check Node.js version (18+) and npm is working.
"Build failed"
Check the error in the build output. Usually dependency issues.
"wallets.json not created"
Run the local fluora-mcp once manually:
CODEBLOCK10
"Invalid private key"
The key in
~/.fluora/wallets.json should be 0x-prefixed hex string (66 characters).
"Wrong network"
Make sure you're sending USDC on
Base network, not Ethereum mainnet or other L2s.
"Still no balance after funding"
- - Check transaction on Base block explorer: https://basescan.org
- Wait 1-2 minutes for confirmation
- Verify you sent to the correct address
- Ensure you selected Base network (not Ethereum)
Why GitHub Instead of npm?
The npm package (fluora-mcp@0.1.38) has a parameter parsing bug where useService cannot receive parameters correctly. The GitHub repository (v0.1.39+) has the fix.
Bug details:
- - npm version: Schema definition uses plain object, breaking MCP parameter passing
- GitHub version: Fixed schema definition, all parameters work correctly
Security Notes
Private Key Safety
- -
~/.fluora/wallets.json contains your private key - Keep this file secure (default permissions: 600)
- Never commit to git
- Never share the private key
- This wallet is for buying services, not storing large amounts
Best Practices
- - Fund with small amounts initially $1 USDC
- Rotate wallets if compromised
- Use separate wallet for each OpenClaw instance
Cost Summary
Setup Costs
- - fluora-mcp clone: Free
- Initial funding: $1 USDC
Ongoing Costs
- - Service calls: $0.001-0.20 per call (varies by service)
- Payments: Handled automatically with USDC, no additional fees. Gas fees are covered by the seller
Example Usage
- - $5 USDC → ~250-5000 calls (depending on service)
- Most calls are $0.001-0.02
Resources
- - Fluora marketplace: https://fluora.ai
- GitHub repo: https://github.com/fluora-ai/fluora-mcp
- Base network: https://base.org
- Block explorer: https://basescan.org
- USDC info: https://www.circle.com/en/usdc
Fluora 设置 - 交互式引导向导（GitHub 版本）
访问 Fluora 市场的完整设置向导。使用官方 GitHub 仓库获取最新可用版本。
此技能的功能
自动化整个 Fluora 设置流程：
- 1. ✅ 从 GitHub 克隆 fluora-mcp (https://github.com/fluora-ai/fluora-mcp)
- ✅ 安装依赖项并在本地构建
- ✅ 生成钱包（自动创建 ~/.fluora/wallets.json）
- ✅ 从私钥提取钱包地址
- ✅ 显示充值说明
- ✅ 使用本地 Fluora 注册表配置 mcporter
- ✅ 验证设置是否正常工作
前置条件
- - Node.js 18+
- npm
- git
- 已安装 mcporter（可选，如果缺失会提供引导）
使用方法
从 OpenClaw Agent 使用
typescript
// 运行交互式设置
await setupFluora();
// 带选项
await setupFluora({
skipMcporterConfig: false,
fundingAmount: 10 // 以 USDC 为单位
});
直接脚本使用
bash
交互式设置（推荐）
node setup.js
跳过 mcporter 配置
node setup.js --skip-mcporter
自定义充值金额
node setup.js --funding 10
创建/修改的内容
1. 本地 fluora-mcp 仓库
~/.openclaw/workspace/fluora-mcp/
从 GitHub 克隆并在本地构建，包含所有依赖项。
2. 钱包文件
~/.fluora/wallets.json
首次运行时自动生成，结构如下：
json
{
BASE_MAINNET: {
privateKey: 0x...
}
}
3. mcporter 配置
~/.openclaw/workspace/config/mcporter.json
（如果工作区配置不存在，则为 ~/.mcporter/mcporter.json）
添加指向本地构建的 Fluora 注册表：
json
{
mcpServers: {
fluora-registry: {
command: node,
args: [/Users/你的用户名/.openclaw/workspace/fluora-mcp/build/index.js],
env: {
ENABLEREQUESTELICITATION: true,
ELICITATION_THRESHOLD: 0.01
}
}
}
}
注意： 使用本地的 GitHub 构建版本，而非 npm 的 npx fluora-mcp，因为 npm 版本存在参数解析错误。
钱包充值
该技能将显示您的钱包地址和说明：
您的 Fluora 钱包地址：
0x1234567890abcdef1234567890abcdef12345678
充值钱包：
- 1. 打开 Coinbase、Binance 或您偏好的交易所
- 向上述地址发送 5-10 USDC
- 重要提示： 选择 Base 网络（而非以太坊主网）
- 等待约 1 分钟确认
网络详情
- - 网络： Base（Coinbase L2）
- 所需代币： 仅 USDC（用于服务支付，建议 5-10 USDC）
- 支付： 使用 USDC 自动处理，无需额外代币
如何获取 Base 网络上的 USDC
从交易所获取：
- - Coinbase：提取 USDC → 选择 Base 网络
- Binance：提取 USDC → 选择 Base 网络
- OKX：类似流程
从以太坊桥接：
- - https://bridge.base.org
- 将 USDC 从以太坊转移到 Base
直接在 Base 上购买：
- - 使用 Coinbase Wallet 或 Rainbow Wallet
- 直接在 Base 上购买 USDC
验证
该技能自动验证：
- - ✅ 从 GitHub 克隆 fluora-mcp
- ✅ 依赖项已安装
- ✅ 构建成功
- ✅ 钱包文件存在
- ✅ 私钥有效
- ✅ 钱包地址正确派生
- ✅ mcporter 配置为有效 JSON
- ✅ Fluora 注册表已配置本地路径
可选：检查钱包余额（充值后）
返回值
json
{
success: true,
walletAddress: 0x...,
privateKeyPath: ~/.fluora/wallets.json,
fluoraPath: ~/.openclaw/workspace/fluora-mcp,
mcporterConfigured: true,
funded: false,
nextSteps: [
在 Base 网络上用 1 USDC 充值钱包,
测试：mcporter call fluora-registry.exploreServices,
开始使用 workflow-to-monetized-mcp 进行构建
]
}
设置完成后
测试您的设置
bash
列出可用服务
mcporter call fluora-registry.exploreServices()
使用免费服务（测试网截图）
mcporter call fluora-registry.useService --args {
serviceId: zyte-screenshot,
serverUrl: https://pi5fcuvxfb.us-west-2.awsapprunner.com,
serverId: c2b7baa1-771c-4662-8be4-4fd676168ad6,
params: {url: https://example.com}
}
使用付费服务（PDF 转换 - 需要确认）
mcporter call fluora-registry.useService --args {
serviceId: pdfshift-convert,
serverUrl: https://9krswmmx4a.us-west-2.awsapprunner.com,
serverId: c45d3968-0aa1-4d78-a16e-041372110f23,
params: {websiteUrl: https://example.com}
}
开始构建
现在您可以使用其他 Fluora 技能：
- 1. workflow-to-monetized-mcp - 生成您自己的服务
- railway-deploy - 部署到 Railway
- fluora-publish - 在市场上架
故障排除
git clone failed
确保您已安装 git 并且可以访问互联网。
npm install failed
检查 Node.js 版本（18+）和 npm 是否正常工作。
Build failed
检查构建输出中的错误。通常是依赖项问题。
wallets.json not created
手动运行一次本地 fluora-mcp：
bash
cd ~/.openclaw/workspace/fluora-mcp
node build/index.js
启动后按 Ctrl+C
Invalid private key
~/.fluora/wallets.json 中的密钥应为 0x 前缀的十六进制字符串（66 个字符）。
Wrong network
确保您在
Base 网络上发送 USDC，而非以太坊主网或其他 L2 网络。
Still no balance after funding
- - 在 Base 区块浏览器上检查交易：https://basescan.org
- 等待 1-2 分钟确认
- 验证您发送到了正确的地址
- 确保您选择了 Base 网络（而非以太坊）
为什么使用 GitHub 而非 npm？
npm 包（fluora-mcp@0.1.38）存在参数解析错误，导致 useService 无法正确接收参数。GitHub 仓库（v0.1.39+）已修复此问题。
错误详情：
- - npm 版本：Schema 定义使用普通对象，破坏了 MCP 参数传递
- GitHub 版本：修复了 Schema 定义，所有参数正常工作
安全说明
私钥安全
- - ~/.fluora/wallets.json 包含您的私钥
- 确保此文件安全（默认权限：600）
- 切勿提交到 git
- 切勿分享私钥
- 此钱包用于购买服务，而非存储大额资金
最佳实践
- - 初始充值少量金额，如 1 USDC
- 如果钱包泄露，请轮换使用
- 每个 OpenClaw 实例使用独立钱包
费用汇总
设置费用
- - fluora-mcp 克隆：免费
- 初始充值：1 USDC
持续费用
- - 服务调用：每次 0.001-0.20 USDC（因服务而异）
- 支付：使用 USDC 自动处理，无额外费用。Gas 费用由卖家承担
使用示例
- - 5 USDC → 约 250-5000 次调用（取决于服务）
- 大多数调用费用为 0.001-0.02 USDC
资源
- - Fluora 市场：https://fluora.ai
- GitHub 仓库：https://github.com/fluora-ai/fluora-mcp
- Base 网络：https://base.org
-
