Clawd Hands

English

Clawd Hands 探索、共享并管理你的 OpenClaw Skills —— 支持本地智能体技能同步、云端状态管理与社区开源共享，打造更强大的 AI 智能体生态。

Clawd Hands 是一个面向 OpenClaw 的专属 Skill 共享与管理中心。

它主要解决两件事：

• 用户在网页端查看和管理自己本地 OpenClaw Skills 的目标状态。
• 用户将自己的 Skill 包上传到平台并共享给社区其他用户下载。

当前功能

• 注册、登录、退出登录
• 首页共享区
• 个人主页 Skill 管理区
• OpenClaw 本地 Skill 状态上报
• 网页端启用 / 禁用目标状态管理
• 轻量配置时间戳接口：OpenClaw 先轮询变更时间，再按需同步全量状态
• Skill 包上传共享
• 共享详情页展示 SKILL.md
• 从平台下载共享 Skill 包

当前同步模型

本项目当前使用的是：

• skill.md 作为唯一接入说明入口
• OpenClaw 本地定时任务作为同步执行器
• 每 5s 请求一次：
  • GET /api/openclaw/config-updated-at
• 只有 configUpdatedAt 变化时才继续调用：
  • GET /api/openclaw/skills/sync
  • POST /api/openclaw/skills/report

这意味着：

• 网页端改状态后，不需要等很久
• OpenClaw 不需要高频拉全量技能列表

技术栈

• Node.js
• 原生 HTTP server
• SQLite (better-sqlite3)
• 原生前端 HTML / CSS / JS

本地启动

要求：

• Node.js 22+

安装依赖：

npm install

启动开发服务：

npm run dev

默认地址：

http://localhost:3000

数据存储

当前项目已经切到 SQLite。

主要本地数据文件：

• data/app.db
• data/packages/

历史文件：

• data/db.json

db.json 现在只作为历史迁移来源 / 备份，不再是主存储。

关键接口

认证：

• POST /api/auth/register
• POST /api/auth/login
• POST /api/auth/logout
• GET /api/auth/me

用户：

• GET /api/users/me
• PATCH /api/users/me
• GET /api/users/me/api-key

OpenClaw 同步：

• GET /api/openclaw/config-updated-at
• GET /api/openclaw/skills/sync
• POST /api/openclaw/skills/report

Skill 管理：

• GET /api/users/me/reported-skills
• POST /api/reported-skills/:id/desired-state
• POST /api/reported-skills/:id/upload-package
• POST /api/reported-skills/:id/unshare

共享区：

• GET /api/shared-skills
• GET /api/shared-skills/:id
• GET /api/shared-skills/:id/download

项目结构

src/
  server.js
  store.js
  auth.js

public/
  index.html
  app.js
  profile.html
  profile.js
  skill-detail.html
  skill-detail.js
  skill.md

data/
  app.db
  packages/

当前限制

• 首页搜索、分页和加载态还可以继续收口
• 详情页版本信息展示还不完整
• 个人主页的状态展示还可以再细化

开源说明

建议不要提交以下本地文件：

• data/app.db
• data/app.db-wal
• data/app.db-shm
• data/db.json
• data/packages/
• .env*

这些条目已经加入 .gitignore。

问题反馈 (Support)

遇到任何问题、Bug 或有新的功能建议，欢迎在 GitHub Issues 提交反馈。

许可证 (License)

本项目基于 MIT License 开源，允许自由使用、修改和分发。