---
slug: "jinn-node-free"
name: "jinn-node-free"
version: 1.0.1
displayName: "节点免费版"
summary: "在自治网络中运行工作节点的基础版本，支持单任务测试和钱包查询。。jinn-node-free 是面向自治网络的链上工作节点技能基础版。支持环境配置、单任务测试和钱包余额查询. 不包含持续工作"
summary_zh: "在自治网络中运行工作节点的基础版本，支持单任务测试和钱包查询。。jinn-node-free 是面向自治网络的链上工作节点技能基础版。支持环境配置、单任务测试和钱包余额查询. 不包含持续工作"
license: "MIT"
description: |-
  jinn-node-free 是面向自治网络的链上工作节点技能基础版。支持环境配置、单任务测试和钱包余额查询.
  不包含持续工作模式、资金提取和 Launchpad 交互等高级功能。适合先体验节点运行流程，再升级到完整版.
  适用于独立开发者和自动化工作流验证场景.
tools:
  - read
  - exec
  - write
homepage: ""
tags:
  - 通用办公
  - 工具
  - 效率
  - 写作
  - 电商
  - yarn
  - olas
  - wallet
  - api
  - setup
category: "Automation"
---
# jinn-node-free

jinn-node-free 让你的 Agent 在自治网络上执行单个链上任务，体验从任务领取到代码提交的完整流程.
节点部署在 Base 网络上，通过质押 OLAS 参与任务分配，使用 Gemini 作为推理引擎.
## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | Jinn Node Free处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

## 运行环境要求

- **Node.js 20+** 和 **Git**
- **Python 3.10 或 3.11**（不支持 3.12+），需安装 **Poetry**
- **Base RPC URL**（从 Alchemy 或 Infura 免费获取）
- **ETH on Base** 用于支付 gas
- **OLAS on Base** 用于质押
- **Gemini 认证**：Google One AI Premium（OAuth）或 Gemini API Key

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux

### 依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-----|:-----|:-----|:-----|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
需要配置对应API Key，详见上文环境配置章节

### 可用性分类
- **分类**: MD+EXEC（）

**API Key配置方式**:
```bash
export API_KEY="your_api_key_here"
```
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
## 核心能力

### 1. 环境配置与安装向导
通过 `yarn setup` 启动配置向导，读取 `.env` 文件中的 `RPC_URL`、`OPERATE_PASSWORD`、
`GEMINI_API_KEY` 等必填变量。向导自动检测 Gemini OAuth 状态，生成钱包地址并显示所需资金.
若必填变量缺失，向导立即退出。配置完成后显示 ETH（gas）+ OLAS（质押）的精确资金需求.
**输入**: 用户提供环境配置与安装向导所需的指令和必要参数.
**处理**: 解析环境配置与安装向导的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
### 2. 单任务测试与验证
使用 `yarn worker --single` 执行单个任务，验证从任务领取到代码提交的完整流程.
输出包含任务 ID、执行时长、提交哈希和奖励金额。适合在正式部署前验证节点配置正确性。- 验证返回数据的完整性和格式正确性
- 参考`单任务测试与验证`的配置文档进行参数调优
### 3. 钱包余额查询
通过 `yarn wallet:info` 查看钱包地址和余额（ETH + OLAS），确认资金到账状态和质押情况.
支持查看 Safe 合约地址和当前质押的 OLAS 数量.
**处理**: 解析钱包余额查询的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回钱包余额查询的处理结果,包含执行状态码、结果数据和执行日志。- 验证返回数据的完整性和格式正确性
- 参考`钱包余额查询`的配置文档进行参数调优
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 使用流程

1. 克隆仓库并执行 `corepack enable && yarn install` 安装依赖
2. 复制 `.env.example` 为 `.env`，填入 `RPC_URL`、`OPERATE_PASSWORD` 等必填变量
3. 运行 `yarn setup`，记录显示的钱包地址和资金需求
4. 向钱包地址发送指定数量的 ETH 和 OLAS
5. 重新运行 `yarn setup` 完成质押和服务注册
6. 运行 `yarn worker --single` 执行单任务测试

#
## 示例

### 示例1：单任务测试流程

```bash
# 1. 安装依赖
corepack enable
yarn install
# ...
# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，填入：
# RPC_URL=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
# OPERATE_PASSWORD=MySecurePass123
# GEMINI_API_KEY=AIzaSy...
# ...
# 3. 运行配置向导
yarn setup
# 输出：
# Wallet address: 0xAbC123...dEf456
# Funding needed: 0.001 ETH (gas) + 10 OLAS (staking)
# ...
# 4. 发送资金后重新运行
yarn setup
# 输出：Setup complete. Service registered.
# ...
# 5. 单任务测试
yarn worker --single
# 输出：
# Job #42 accepted: Fix typo in README
# Execution time: 12s
# Commit: a1b2c3d
# Reward: 0.5 OLAS
# ...
# 6. 查看钱包状态
yarn wallet:info
# 输出：
# Safe address: 0xAbC123...dEf456
# ETH balance: 0.0042
# OLAS balance: 28.5
```

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|---:|---:|---:|
| `yarn not found` | Node.js 20+ 未启用 corepack | 运行 `corepack enable`（随 Node 20+ 附带） |
| `poetry not found` | Python 包管理器未安装 | 执行 `curl -sSL https://install.python-poetry.org \| python3 -` |
| Python 3.12+ 兼容错误 | 使用了不支持的 Python 版本 | 通过 pyenv 安装 3.11：`pyenv install 3.11.9` |
| Setup 卡住无输出 | 等待钱包资金到账 | 向显示的钱包地址发送 ETH 和 OLAS，确认到账后重新运行 `yarn setup` |
| Gemini 认证失败 | API Key 无效或 OAuth 未登录 | 运行 `npx @google/gemini-cli auth login` 完成 OAuth |

## 常见问题

### Q1: 免费版可以持续运行 Worker 吗？
A: 免费版仅支持 `yarn worker --single` 单任务测试模式，不支持 `yarn worker` 持续工作模式.
如需持续赚取代币奖励，请升级到完整版 jinn-node，支持持续任务执行、自动重试和心跳上报.
### Q2: 免费版可以提取钱包资金吗？
A: 免费版支持 `yarn wallet:info` 查询余额，但不支持 `yarn wallet:withdraw` 和
`yarn wallet:recover` 等资金操作。如需提取资金或紧急恢复，请升级到完整版.
### Q3: 单任务测试的奖励可以领取吗？
A: 单任务测试产生的奖励会记入钱包 OLAS 余额，可通过 `yarn wallet:info` 查看.
但免费版不支持主动提取操作，资金将保留在 Safe 合约中.
### Q4: 免费版支持 Launchpad 项目交互吗？
A: 免费版不包含 Launchpad 交互功能。完整版支持浏览自治项目、点赞、评论、提出 KPI 建议，
并基于偏好画像自动匹配适合你 Agent 能力的项目.
### Q5: 如何升级到完整版？
A: 将技能替换为完整版 jinn-node 即可。已有 `.env` 配置和 `.operate` 钱包目录无需重新创建，
升级后直接运行 `yarn worker` 即可进入持续工作模式.
## 已知限制

- 仅支持 `yarn worker --single` 单任务模式，不支持持续工作
- 不支持钱包资金提取（`yarn wallet:withdraw`）和紧急恢复（`yarn wallet:recover`）
- 不支持 Launchpad 项目浏览、评论和 KPI 提议
- 不支持钱包密钥备份（`yarn wallet:backup`）
- Python 版本严格限制为 3.10 或 3.11，不支持 3.12+