📋 Ways to Contribute
Code Contributions
Submit PRs to picclaw (Go), moltclaw (TypeScript), microclaw (C/Rust), or clawland-fleet (Go). Core module PRs earn 2× contribution points.
Hardware Kit Designs
Design sensor kits with BOM, wiring diagrams, and driver scripts for clawland-kits. Each accepted design earns 20 points (+50% with test reports).
Skill Plugins
Build YAML-based skills for the clawland-skills marketplace. Each accepted skill earns 15 points (+50% with unit tests).
Documentation & Tutorials
Write guides, tutorials, translations, or API docs. Each accepted doc earns 5 points (+50% for multilingual versions).
Issue Reports
Report bugs with reproducible steps (1.5× points), security vulnerabilities (3× points), or feature requests. Each valid issue earns 2 points.
Code Reviews
Review open PRs with constructive feedback. Each review earns 3 points (2× for deep reviews with code suggestions).
⭐ Contribution Points System
| Activity | Base Points | Multiplier |
|---|---|---|
| PR Merged | 10 | ×2 for core modules |
| Code Review | 3 | ×2 for deep reviews |
| Valid Issue | 2 | ×1.5 reproducible / ×3 security |
| Skill Plugin | 15 | ×1.5 with tests |
| Kit Design | 20 | ×1.5 with test report |
| Documentation | 5 | ×1.5 for multilingual |
| Community Support | 1 | ×3 for high-quality answers |
🚀 Contribution Workflow
Fork & Clone
Fork the target repository on GitHub. Clone your fork locally and create a feature branch from main.
Develop & Test
Write your code/design/documentation. Run existing tests. Add new tests for your changes. Follow the repository's code style guide.
Submit PR
Push to your fork and open a Pull Request. Use the PR template. Describe what you changed and why. Link related issues.
Review & Merge
A maintainer will review your PR. Address feedback. Once approved, it gets merged and your contribution points are recorded.
📜 Contributor License Agreement (CLA)
All contributors must sign the Clawland CLA before their first PR can be merged. The CLA ensures that the project can use your contributions while you retain your copyright. The CLA bot will automatically prompt you on your first PR.
🌟 First 10 Core Maintainers Bonus
The first 10 developers who achieve Core Maintainer status will receive an additional 0.5% lifetime fixed share of revenue—on top of the standard contribution-point-based share. Early contributors are rewarded the most.
🎨 Code Style Guidelines
- Go (picclaw, clawland-fleet): Follow
gofmtandgolangci-lint. Keep binary size minimal. - TypeScript (moltclaw): Use ESLint + Prettier. Follow the existing architecture patterns.
- C/Rust (microclaw): Memory safety first. Target MCU with ≤64KB RAM.
- Hardware (clawland-kits): BOM must use widely available, low-cost components. Include wiring diagram (KiCad/Fritzing).
- Skills (clawland-skills): YAML format. Include README with usage examples.