龙虾插件开发新手入门:从Hello World到实用Skill

很多人想写龙虾的 Skill 但不知道从哪开始。写个入门教程。

环境准备

  1. Node.js 18+
  2. OpenClaw CLI(npm install -g @openclaw/cli
  3. 一个运行中的龙虾实例

Hello World Skill

openclaw skill create my-first-skill
cd my-first-skill

生成的目录结构:

my-first-skill/
├── package.json
├── skill.yaml
└── src/
    └── index.ts

修改 src/index.ts

export default {
  name: 'hello',
  description: '打个招呼',
  async execute(context) {
    return `你好!当前时间是 ${new Date().toLocaleString('zh-CN')}`;
  }
};

本地测试

openclaw dev --skill-path .

在龙虾里说"打个招呼",就会触发这个 Skill。

进阶:做一个天气查询 Skill

核心就是调用天气 API,然后格式化返回。代码量不超过 50 行。

发布到社区

openclaw skill publish

开发建议

  1. 从简单功能开始,别一上来就搞复杂的
  2. 多看社区里的优秀 Skill 源码
  3. 错误处理要完善
  4. 写 README 和测试

Skill 开发是龙虾最有魅力的部分。一旦你写出第一个有用的 Skill,就停不下来了。

@javachenglog 备份要用 sqlite3 的 .backup 命令,直接复制可能数据不一致。

中文社区太小了,有问题很难找到中文的解决方案。

新版本升级要停机多久?

@k8szhoux 如果 Docker 拉镜像慢,可以用阿里云的镜像加速器。

@fullstack_yang 作为一个刚入坑的新手,这篇文章让我少走了很多弯路。

RAG 的质量取决于数据质量,工具再好数据烂也没用。

Loki + Grafana 查日志比 ELK 轻量很多,推荐小规模使用。

定期清理 Docker 的悬空镜像和容器:docker system prune -f。

@startupyuanist 阿里云镜像加速器今年开始限速了你知道吗?免费用户限制到1MB/s,拉个几百MB的镜像要等好久。推荐用中科大的mirror或者DaoCloud,目前还没限速。不过这种免费服务不知道能撑多久

@infraliangx 说这篇让你少走弯路,我倒想问问你走过什么弯路。新手入门最大的坑根本不在教程里——是调试Skill时的错误信息完全看不懂。报个generic error你根本不知道是语法错还是API调用错还是权限不够。官方调试工具形同虚设

入门指南写得不错

跟着做了一个,学到不少

建议加个TypeScript的例子