human-management

Provisions human users in HiClaw with Matrix-based permissions and access.

5.3k|652|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/agentscope-ai/HiClaw --skill human-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: human-management
Source: https://github.com/agentscope-ai/HiClaw/tree/main/manager/agent/skills/human-management
Command: npx skills add https://github.com/agentscope-ai/HiClaw --skill human-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, curl, openssl, mc, msmtp, sendmail, sed, cut, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the operational problem of safely onboarding real human users into HiClaw and granting the correct permissions so they can collaborate with agents through Matrix (e.g., Element) without manual configuration.

Core Features & Use Cases

  • Permission-scoped human onboarding (levels 1–3): Creates a human account and assigns access to the Manager and/or specific Team Leaders/Workers according to the inclusive permission rules.
  • Room invitation & auto-join: Invites the human to the appropriate Matrix rooms (team rooms and worker rooms) and can auto-join using the newly registered human token when available.
  • Registry + auditable propagation: Updates humans-registry.json, pushes updated agent openclaw.json permission settings to MinIO, and triggers agent-side file-sync so authorization takes effect.
  • Optional welcome email: Sends credentials and login details via SMTP when --email is provided and SMTP is configured.

Quick Start

Use the human-management skill to add a level 2 human to specific team(s) and their associated workers by running the provided create-human workflow with your Matrix ID, display name, teams, workers, and optional email.

Frequently Asked Questions about human-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I provision human users in Matrix and assign them team permissions?

Provisioning human users in Matrix involves creating an account and assigning level 1–3 permissions. This Skill recalculates groupAllowFrom, updates the humans-registry, and pushes openclaw.json settings to MinIO for propagation.

Can I automate sending Matrix credentials to newly onboarded users via email?

Yes, you can automate sending Matrix credentials to newly onboarded users via email. When the --email flag is provided and SMTP is configured, the Skill sends login details using msmtp or sendmail.

How to manage Matrix room invitations for team leaders and workers automatically?

Managing Matrix room invitations for team leaders and workers automatically is handled by the Skill. It invites humans to appropriate team and worker rooms, and can auto-join using the newly registered human token when available.

Does this access control workflow require MinIO to sync agent permissions?

Yes, this access control workflow requires MinIO to sync agent permissions. It pushes updated agent openclaw.json permission settings to MinIO, which triggers the agent-side file-sync so authorization takes effect.

What is the best way to remove human access and update registry files for controlled collaboration rooms?

The best way to remove human access and update registry files for controlled collaboration rooms is using the manage-humans-registry scripts. This recalculates permissions and ensures auditable propagation across all connected agents.