← Back to Skills Marketplace
visawang

Grinders Farm

by visaWang · GitHub ↗ · v0.3.3 · MIT-0
cross-platform ⚠ suspicious
155
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install grinders-farm
Description
Requires grinders-farm CLI + openclaw-plugin-grinders-farm before use. Maps intents to grinders_farm. 使用前需先安装 grinders-farm 与 openclaw-plugin-grinders-farm。
README (SKILL.md)

Grinder's Farm

Languages: English · 中文

Farm preview (4×5 grid, four crop types)


English

This skill maps user chat into exactly one grinders_farm tool call.

Prerequisites (install before this skill works)

The grinders_farm tool is provided by the game CLI and the OpenClaw plugin. Install both from npm first, then install this skill from ClawHub:

npm install -g grinders-farm
openclaw plugins install openclaw-plugin-grinders-farm --dangerously-force-unsafe-install

Restart the OpenClaw Gateway after installing the plugin. Without these packages, /farm and grinders_farm will not run.

Install this skill (optional but recommended for NL)

After the two packages above:

openclaw skills install grinders-farm

How users play (after setup)

  • Slash commands (always works once the plugin is loaded): in Telegram / WebChat / etc., send
    /farm \x3Ccommand> — examples: /farm farm, /farm plant carrot A1, /farm help.
    The part after /farm is the same command string you would pass to grinders-farm-oneshot.
  • Natural language (this skill): when the skill is installed and the agent is allowed to use tools, the user can say things like “plant carrot at A4”; you should map that to grinders_farm with command: "plant carrot A4".
  • This skill does not replace the plugin or the grinders-farm package — it only helps choose the right tool arguments.

Rules

  1. While playing the farm, always use the grinders_farm tool.
  2. Do not use shell/exec/cargo or other execution paths.
  3. Do not only explain—execute (unless the user explicitly says not to).
  4. Crops only: carrot potato tomato pumpkin.
  5. Plot labels: A1D5 (rows A–D, columns 1–5).

Allowed commands

  • farm
  • plant \x3Ccrop> \x3Cpos>
  • water [pos]
  • harvest [pos]
  • shop
  • sell
  • inventory
  • start
  • stop
  • reset
  • help

Intent mapping (priority)

  1. Auto-advance
    • "start auto" / "enable auto" → start
    • "stop auto" / "disable auto" → stop
  2. Plant
    • plant intent + crop + position → plant \x3Ccrop> \x3Cpos>
  3. Water
    • water + position → water \x3Cpos>
    • water only → water
  4. Harvest
    • harvest + position → harvest \x3Cpos>
    • harvest only → harvest
  5. Trade / info
    • shop → shop
    • sell → sell
    • inventory → inventory
  6. Reset / help
    • reset → reset
    • help → help
  7. Fallback
    • farm-related but unclear → farm

Output

  1. Prefer the tool’s text as-is.
  2. If there is a markdown table, output it without wrapping in a code fence.
  3. Keep image URLs as plain clickable links (no backticks).
  4. On failure: return the error first, then one example command.

Examples

  • "plant carrot at A4" → command: "plant carrot A4"
  • "show farm" → command: "farm"
  • "water all" → command: "water"
  • "harvest A2" → command: "harvest A2"
  • "start auto" → command: "start"
  • "stop auto" → command: "stop"

OpenClaw notes

  • Plugin: openclaw-plugin-grinders-farm
  • Run /farm farm once per channel to bind delivery.
  • /farm start auto-advances (one day every 20 minutes).
  • /farm stop stops auto-advance.

Local state files

  • ~/.grinders-farm/farm.json
  • ~/.grinders-farm/farm.png
  • ~/.grinders-farm/auto.log
  • ~/.grinders-farm/openclaw-deliveries.json

中文

此 Skill 的目标只有一个:把用户输入映射成唯一明确grinders_farm 命令并执行。

先决条件(使用本 skill 前必须先装)

grinders_farm 工具由主游戏 CLIOpenClaw 插件一起提供。请先全局安装这两个 npm 包,再从 ClawHub 安装本 skill:

npm install -g grinders-farm
openclaw plugins install openclaw-plugin-grinders-farm --dangerously-force-unsafe-install

安装插件后请重启 OpenClaw Gateway。若未安装上述包,/farmgrinders_farm 无法运行。

再安装本 skill(想用自然语言时)

两个 npm 包装好后,再执行:

openclaw skills install grinders-farm

用户怎么玩(装好之后)

  • 斜杠命令(插件加载后可用): 在 Telegram / WebChat 等里发
    /farm \x3C子命令>,例如 /farm farm/farm plant carrot A1/farm help
    /farm 后面这一段,与传给 grinders-farm-oneshot 的参数一致。
  • 自然语言(本 skill): 用户说「在 A4 种胡萝卜」时,应映射为 grinders_farmcommand: "plant carrot A4"
  • 本 skill 不能替代插件和主包 —— 只负责把聊天意图转成正确 tool 参数。

必须遵守

  1. 用户在玩农场时,必须调用 grinders_farm tool。
  2. 不用 shell/exec/cargo 等其它执行路径。
  3. 不要只讲解不执行(除非用户明确说“先别执行”)。
  4. 作物只允许:carrot potato tomato pumpkin
  5. 坐标格式固定:A1~D5(行 A-D,列 1-5)。

命令白名单(仅这些)

  • farm
  • plant \x3Ccrop> \x3Cpos>
  • water [pos]
  • harvest [pos]
  • shop
  • sell
  • inventory
  • start
  • stop
  • reset
  • help

意图映射(按优先级匹配)

命中后立即执行,不要多重猜测。

  1. 自动推进
    • “开启自动 / 开始挂机 / start auto” -> start
    • “停止自动 / 关掉挂机 / stop auto” -> stop
  2. 种植
    • 包含“种/种植/播种”且有作物+坐标 -> plant \x3Ccrop> \x3Cpos>
  3. 浇水
    • “浇水”+坐标 -> water \x3Cpos>
    • 仅“浇水” -> water
  4. 收获
    • “收获”+坐标 -> harvest \x3Cpos>
    • 仅“收获” -> harvest
  5. 交易/信息
    • “商店/买什么” -> shop
    • “卖掉/出售” -> sell
    • “仓库/库存/背包” -> inventory
  6. 重置/帮助
    • “重置/重开” -> reset
    • “帮助/help” -> help
  7. 兜底
    • 农场相关但不够明确 -> farm

输出规则(避免歧义)

  1. 工具返回内容优先,尽量原样呈现。
  2. 若含 markdown 表格,原样输出,不包代码块。
  3. 若含图片 URL,保持纯链接可点击,不加反引号。
  4. 命令失败时:先返回错误原文,再给一条可执行示例命令。

标准示例

  • “在 A4 种胡萝卜” -> command: "plant carrot A4"
  • “看农场” -> command: "farm"
  • “全部浇水” -> command: "water"
  • “收 A2” -> command: "harvest A2"
  • “开自动” -> command: "start"
  • “停自动” -> command: "stop"

OpenClaw 使用要点

  • 插件:openclaw-plugin-grinders-farm
  • 先在每个目标频道执行一次 /farm farm 完成绑定
  • 执行 /farm start 开始自动推进(固定 20 分钟/天)
  • 执行 /farm stop 停止自动推进

本地状态文件

  • ~/.grinders-farm/farm.json
  • ~/.grinders-farm/farm.png
  • ~/.grinders-farm/auto.log
  • ~/.grinders-farm/openclaw-deliveries.json
Usage Guidance
This skill appears to do what it says: translate user chat into a single grinders_farm CLI invocation and integrate with OpenClaw. Before installing, consider: 1) You must install two npm-based components (grinders-farm CLI and openclaw-plugin-grinders-farm) and restart the OpenClaw Gateway; the SKILL.md tells you how. 2) The plugin uses the --dangerously-force-unsafe-install flag when shown as an example — that bypasses some install safety checks; only run that if you trust the plugin source. 3) The plugin will create and write files in ~/.grinders-farm and ~/.openclaw/media and may spawn detached background processes (image server, auto-worker) that can auto-start via plugin config; be comfortable with that persistence. 4) No secrets or cloud credentials are requested, but the code does read path-related env vars (OPENCLAW_BIN, GRINDERS_FARM_ROOT, etc.) — these are for locating binaries, not for exfiltration. 5) If you plan to run npm install from the repository, review package.json and the lockfile for large/extra dependencies. If anything about the package source is untrusted or if you do not want background processes or local state files, do not install the plugin; you can still play manually via the grinders-farm CLI in the terminal without installing the OpenClaw plugin or this skill.
Capability Assessment
Purpose & Capability
Name/description (map intents → grinders_farm) matches the provided SKILL.md and the included plugin/CLI integration code. The repo contains an OpenClaw plugin that registers /farm and a skill that maps chat to a single grinders_farm tool call. One minor inconsistency: the SKILL.md and README require the grinders-farm CLI and the openclaw plugin, but the registry metadata only lists 'npx' as a required binary — the skill relies on external binaries (grinders-farm, openclaw) even if they aren't declared in the minimal required-bins list.
Instruction Scope
Runtime instructions are narrowly scoped: map NL to a single approved grinders_farm command and execute that tool. The included plugin code performs local file reads/writes under ~/.grinders-farm and ~/.openclaw/media, starts local helper processes (image server, auto worker), and invokes the grinders-farm CLI via child processes — all consistent with the documented behavior. SKILL.md explicitly forbids arbitrary shell/exec use beyond the tool call, and the code adheres to running the game CLI and plugin-related flows rather than scanning unrelated user data.
Install Mechanism
The skill is instruction-only (no install spec) but ships many source files including an OpenClaw plugin and package files. There is no remote arbitrary-download installer in the skill metadata. Installation requires the user to npm install the grinders-farm CLI and to install the openclaw-plugin-grinders-farm (the README and SKILL.md instruct to run openclaw plugins install with --dangerously-force-unsafe-install). That flag is a user action and raises an operational-security consideration (it forces plugin install), but the install mechanism itself is standard (npm/global CLI + OpenClaw plugin install) and not an opaque remote fetch from an untrusted URL.
Credentials
The skill does not request secrets or credentials (requires.env is empty). The code does read environment variables (OPENCLAW_BIN, GRINDERS_FARM_ROOT, GRINDERS_FARM_CLI_BIN, NVM_BIN, etc.) to locate executables or override paths; these are non-secret configuration variables used for locating binaries. It does not require AWS keys or other unrelated secrets. Note: the package-lock included in the repo contains many third-party packages (e.g., AWS-related libs) in the lockfile, but the plugin package.json lists only peerDependencies for OpenClaw — review package.json/lockfile if you plan to run npm install from the repo.
Persistence & Privilege
The plugin and CLI write persistent local state under the user's home (~/.grinders-farm) and stage media under ~/.openclaw/media. They also launch detached helper processes (image server, auto worker) and can auto-start background workers via plugin config. These behaviors are expected for this kind of plugin but do mean the software will create persistent files and background processes on install/when started.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install grinders-farm
  3. After installation, invoke the skill by name or use /grinders-farm
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.3
Bilingual onboarding/docs, demo farm image, and clearer prerequisites for first-time users.
v0.3.2
调整自动推进为每20分钟一天;修复发布包图像素材与自动推进worker路径。
v0.3.0
Rename from claw-farm to grinders-farm and clarify command mapping rules.
Metadata
Slug grinders-farm
Version 0.3.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Grinders Farm?

Requires grinders-farm CLI + openclaw-plugin-grinders-farm before use. Maps intents to grinders_farm. 使用前需先安装 grinders-farm 与 openclaw-plugin-grinders-farm。 It is an AI Agent Skill for Claude Code / OpenClaw, with 155 downloads so far.

How do I install Grinders Farm?

Run "/install grinders-farm" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Grinders Farm free?

Yes, Grinders Farm is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Grinders Farm support?

Grinders Farm is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Grinders Farm?

It is built and maintained by visaWang (@visawang); the current version is v0.3.3.

💬 Comments