从用户到创造者 · OpenClaw 橙皮书

一、为什么要从"用"走到"造"

你可能会问："我用得好好的，为什么要折腾去开发？"四个答案：

你比开发者更懂"普通人想要什么"——Claw Hub 上 90% 的 Skill 是开发者自嗨，缺的是真正解决普通人问题的；
副业窗口期——AI Agent 生态正处于"早期红利期"，每个细分场景都有人愿意付费；
个人 IP——一个有用的 Skill 是最好的简历，比任何"我擅长 AI"的话都管用；
真正掌控你的工具——开源世界里，"我用过"和"我贡献过"是两种身份。

二、第一个 Skill：30 行代码做"今天日期"

我们从一个最小的例子开始：返回今天是星期几，并附带"今天的微小提醒"。

第 1 步：创建骨架

clawhub init today-reminder
cd today-reminder
ls

today-reminder/
├── skill.json          # Skill 元信息
├── package.json        # Node 依赖
├── README.md           # 用户看的说明
├── LICENSE             # 开源协议（默认 MIT，发布前自检会校验）
├── src/
│   └── index.ts        # 入口
└── tests/
    └── index.test.ts

第 2 步：写 `skill.json`

{
  "name": "today-reminder",
  "version": "0.1.0",
  "description": "返回今天是星期几，并附带微小提醒",
  "author": "你的名字 <你的邮箱>",
  "license": "MIT",
  "category": ["生活"],
  "tags": ["日期", "提醒", "新手"],
  "entry": "src/index.ts",
  "permissions": {
    "filesystem": "none",
    "network": "none"
  }
}

permissions: "none" 是给 Claw Hub 的安全声明——这个 Skill 不需要读写文件、不需要联网。

第 3 步：写 `src/index.ts`

import { defineSkill } from "@openclaw/skill-sdk";

const tips: Record<string, string[]> = {
  Mon: ["新一周加油", "记得给本周列 3 件最重要的事", "周一容易疲惫，午后散步 10 分钟"],
  Tue: ["效率黄金日，啃硬骨头", "看看周一遗留的事"],
  Wed: ["周中检视：本周目标完成 50% 了吗", "和家人吃顿饭"],
  Thu: ["开始为周五的总结做准备", "整理本周收件箱"],
  Fri: ["写周报、清空 todo", "本周 Top 3 成就是什么"],
  Sat: ["休息日，不要工作", "陪家人或朋友"],
  Sun: ["复盘 + 为下周列 3 件事", "提前睡觉"]
};

export default defineSkill({
  name: "today-reminder",
  description: "返回今天是星期几和一句微小提醒",
  parameters: {
    locale: {
      type: "string",
      description: "时区，默认 Asia/Shanghai",
      default: "Asia/Shanghai"
    }
  },
  async run({ locale }) {
    const now = new Date().toLocaleString("en-US", {
      timeZone: locale,
      weekday: "short",
      year: "numeric",
      month: "long",
      day: "numeric"
    });
    const day = now.split(",")[0];
    const dayTips = tips[day] || ["今天也是好日子"];
    const tip = dayTips[Math.floor(Math.random() * dayTips.length)];
    return {
      today: now,
      weekday: day,
      tip
    };
  }
});

第 4 步：本地测试

clawhub dev

会启动一个本地的"调试 OpenClaw"，加载这个 Skill。打开 tui 试一句：

今天是星期几？提醒我点什么？

OpenClaw 会自动调用 today-reminder，返回类似：

{
  "today": "Sun, April 19, 2026",
  "weekday": "Sun",
  "tip": "复盘 + 为下周列 3 件事"
}

第 5 步：写测试

tests/index.test.ts：

import { describe, it, expect } from "vitest";
import skill from "../src/index";

describe("today-reminder", () => {
  it("returns weekday and a tip", async () => {
    const result = await skill.run({ locale: "Asia/Shanghai" });
    expect(result).toHaveProperty("weekday");
    expect(result).toHaveProperty("tip");
    expect(result.tip.length).toBeGreaterThan(0);
  });
});

跑测试：

npm test

第 6 步：写好 README

README.md 是 Claw Hub 上用户看的"应用商店详情页"，至少包含：

# today-reminder

> 返回今天是星期几和一句微小提醒。零依赖，零网络，零权限。

## 安装

clawhub install today-reminder

## 使用

在 OpenClaw 里说：「今天星期几？给我一句提醒」

## 参数

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| locale | string | Asia/Shanghai | 时区 |

## 反馈

GitHub Issue: https://github.com/你的用户名/today-reminder/issues

三、把它发布到 Claw Hub

第 1 步：注册 Claw Hub 账号

clawhub login

按提示在浏览器里扫码登录，绑定 GitHub 账号即可。

第 2 步：发布前自检

clawhub validate

会检查：

元信息是否完整（name / description / license）
测试是否通过
权限声明是否合理
README 是否 > 100 字
是否有 LICENSE 文件
是否有 secrets 泄露（扫源码里的 API Key 痕迹）

第 3 步：发布

clawhub publish

第一次发布会等审核（通常 1-3 个工作日，社区维护者会人工看一遍代码）。审核通过后任何人都能：

clawhub install today-reminder

第 4 步：版本管理

修了 bug 或加了新功能：

# 升级版本
npm version patch    # 0.1.0 → 0.1.1（bug fix）
npm version minor    # 0.1.0 → 0.2.0（新功能）
npm version major    # 0.1.0 → 1.0.0（破坏性变更）

# 重新发布
clawhub publish

支持打标签：

clawhub publish --tag beta    # 只有装 @beta 的用户能拿到

四、写"好"Skill 的 7 个原则

发出去的 Skill 不一定有人用。受欢迎的 Skill 普遍有这 7 个特征：

原则 1：解决"具体"问题，不是"通用"问题

❌ "AI 助手" → 模糊，没人会装 ✓ "把 PDF 发票批量提取金额、时间、商家到 Excel" → 痛点明确

原则 2：开箱即用

零配置最好。如果必须配置，给一份 5 行内的 README 就能跑起来。

原则 3：失败时给"人话"

// ❌ 不友好
throw new Error("ENOENT");

// ✓ 友好
throw new Error(
  `没找到文件 ${path}。请检查：1) 路径是否正确 2) 该文件是否存在 3) 权限是否允许读取`
);

原则 4：默认不申请高危权限

只在真正需要的时候申请。一个"图片处理"Skill 不应该要"读 Cookie"权限。

原则 5：写好"参数描述"

OpenClaw 的主代理会读你写的描述来决定怎么调用。描述写得好，主代理调用得好。

parameters: {
  // ❌ 没用
  path: { type: "string", description: "path" },

  // ✓ 有用
  path: {
    type: "string",
    description: "要处理的图片路径，支持绝对路径或 ~ 开头。例如：~/Desktop/photo.jpg。"
  }
}

原则 6：版本号严格遵守 semver

不破坏老用户的，patch / minor 升级
改函数名 / 改返回值结构 = major 升级
别让用户"升一下版本就什么都跑不了"

原则 7：留好"反馈渠道"

GitHub Issues 是最低标准。复杂的 Skill 推荐建一个 Discussions 板块。

五、加入 OpenClaw 社区

写代码不是孤独的。OpenClaw 有一个非常活跃的社区。

1. GitHub

主仓库：https://github.com/openclaw/openclaw
怎么参与：
- 报 Bug：发现问题就开 Issue（描述清楚、附 openclaw doctor 输出）
- 提需求：新功能开 Discussion
- 贡献代码：从 good-first-issue 标签的 Issue 开始
- 写文档：文档改进永远缺人，门槛低、影响大

2. Claw Hub 社区

网址：https://claw-hub.net/community
Skill 作者圈，每周末有"Show & Tell"，作者展示自己的新 Skill。

3. Discord / Telegram / 微信群

官方 Discord：discord.gg/openclaw
中文 Telegram：t.me/openclaw_zh
微信群：参考附录 D

4. 中文社区精选

知乎专栏 #OpenClaw
掘金 / V2EX / Hacker News 关键词订阅
B 站 UP 主："AI 超元域"、"花叔 Alchain"等

加入社区的"心法"

先看再问：80% 的问题在历史 Issue / 群消息里能找到答案
问问题给完整信息：版本号、系统、报错截图、openclaw doctor
回答问题就是学习：解答别人也帮自己梳理
多分享你做的小成果：哪怕只是一个 5 行的提示词模板，社区也会感谢

六、把 AI 自动化做成副业的 5 条路径

如果你想"不只是为爱发电"，下列路径在 2026 年仍然有大量空间。

路径 1：垂直行业 Skill 包

选一个你熟悉的行业（律师 / 会计 / 房产经纪 / 自媒体）；
做 5-10 个针对性 Skill 的"行业包"；
通过 Claw Hub Pro 收费，或自己网站售卖；
案例：有人做"小红书博主套件"，月销 800 单，单价 39 元。

路径 2：定制化部署服务

帮中小企业本地部署 OpenClaw（数据不出门）；
单次报价 5,000-30,000 元（视复杂度）；
持续维护按月收费 1,500-5,000 元；
案例：律所 / 设计公司 / 中介门店都是好客户。

路径 3：内容 / 知识付费

录"OpenClaw 实战课"（B 站、视频号、知识星球）；
写 newsletter / 公众号；
出付费电子书（橙皮书 PDF）。
案例：有人开知识星球，3000+ 付费用户，年收入 ¥XX 万。

路径 4：AI 工作流模板店

把你做过的高质量工作流（个人早报、求职助手、租房筛选）打包成"模板"售卖；
单价 9.9-49.9 元，复杂套件 99-299 元；
通过 Gumroad / 自己网店 / 付费社群售卖。

路径 5：行业自媒体 + 工具变现

开公众号 / B 站频道，专做"AI 自动化"垂类；
一边讲一边推自己开发的 Skill / 课程 / 服务；
案例：花叔、AI 超元域。

温馨提示：副业是马拉松不是百米。先选一条路深耕 6-12 个月，再看效果决定是否扩张。同时做 5 条路的 100% 失败。

七、给"普通人创造者"的 3 条心法

1. 完成比完美重要

你的第一个 Skill 不需要惊艳，有人在用就赢了。把它做出来，发出去，用户会告诉你怎么改。

2. 持续比聪明重要

每周更新一次 Skill 的人，半年后比"一次性写完美就闷头不动"的人，用户多 50 倍。

3. 帮人比赚钱重要

你帮别人省的每一分钟，最终都会以你想不到的方式回到你身上。AI 时代里"乐意分享"的人，最容易脱颖而出。

八、给自己设一个"6 个月路线图"

我们提供一个示意，你按自己节奏调：

月 1：  熟练用 OpenClaw，每天用 1 小时
月 2：  写 10 个高质量提示词模板
月 3：  搭好 5 个工作流
月 4：  发布第一个 Skill 到 Claw Hub
月 5：  在社区分享一篇"我的 OpenClaw 实战"
月 6：  做一次直播 / 写一份系统教程，开始接定制

12 个月后，你会有：

自己的 Skill 包（10+）
一个小但活跃的读者群
第一笔来自 AI 自动化的收入
一个跟"早晨 7:40 醒来翻 38 条微信"截然不同的工作生活节奏

九、最后的话

写到这里，整本《OpenClaw 橙皮书》接近尾声。

我们在序言里讲过那个"被琐事压垮的 24 小时"。如果你跟着这本书把所有章节都跑通了，你的 24 小时真的会变成另一个样子：

早 8:00，你的早报已经在微信里
上午专注做 3 件最重要的事
中午休息时，AI 替你处理了昨晚客户的反馈邮件
下午 2 点开会，会议结束 5 分钟内纪要已经在群里
周五下午 5 点，周报初稿已经躺在你的桌面
周末和家人爬山，AI 替你盯着想抢的演唱会票

这不是科幻，这是你已经能做到的事。

唯一剩下的事，就是动手。 关掉橙皮书，打开终端，跑你的第一个 openclaw onboard。

如果这本书帮到了你，希望你也能写一份属于你自己的"普通人 AI 指南"，传递给更多人。

后会有期。

本章一图回顾

                  你的成长路径
        ┌─────────────────────────────┐
        │ 用户       配模型 + 装 Skill  │
        │   ↓                          │
        │ 熟手       写提示词 + 工作流  │
        │   ↓                          │
        │ 进阶       子代理 + 安全审计  │
        │   ↓                          │
        │ 创造者     写 Skill + 发布    │
        │   ↓                          │
        │ 影响者     社区分享 + 副业     │
        └─────────────────────────────┘

致谢与下一步

整本《OpenClaw 橙皮书》到此完结。请别忘了去翻附录：

附录 A 常用命令速查表：80+ 条命令一页查
附录 B 30 个开箱即用提示词：复制就能跑
附录 C 术语表：30+ 个术语随时查
附录 D 资源与社区链接：进一步学习的所有路径
附录 E 100 项达成清单：100 个可打卡的小动作，从入门到创造者