secretary

What This Skill Does

The Secretary skill is a specialized OpenClaw agent designed for secure M365 environment management. It acts as an executive assistant that bridges the gap between high-level operational tasks and technical governance. By leveraging delegated Azure Entra ID permissions, it maintains strict security boundaries while automating mundane administrative duties. The agent manages three primary domains: communication triage, scheduling optimization, and digital hygiene. It effectively sorts through inbox noise to highlight critical emails, manages calendar availability, and monitors organizational storage by identifying orphaned or stale data within OneDrive. Furthermore, it integrates with Microsoft Teams to ensure relevant stakeholders receive automated updates, streamlining internal workflows while maintaining the principle of least privilege.

Installation

To integrate the Secretary skill into your environment, follow these steps:

1. Register an application in Azure Entra ID as a 'Public Client'.
2. Assign the following delegated permissions: Mail.ReadWrite, Calendars.ReadWrite, Files.ReadWrite, and ChatMessage.Send.
3. Configure your local environment by adding SECRETARY_CLIENT_ID and SECRETARY_TENANT_ID to your .env file.
4. Execute the installation command in your terminal: clawhub install openclaw/skills/skills/cenralsolution/office-secretary.
5. Verify the connection by invoking the help command within your terminal to ensure the secretary_engine.py script has full access to the required graph endpoints.

Use Cases

• Executive Inbox Management: Automatically filter and prioritize high-stakes emails during busy periods to ensure prompt responses.
• Calendar Syncing: Coordinate meeting schedules with internal and external parties without manual back-and-forth communication.
• OneDrive Governance: Audit organizational cloud storage to flag stale or orphaned files that consume quotas and present potential security risks.
• Team Communications: Push automated system or project alerts to specific Teams channels to keep teams aligned in real-time.

Example Prompts

1. "Secretary, please triage my inbox and list the high-priority emails received in the last 24 hours."
2. "Find a 30-minute window for a meeting with [email protected] between 9 AM and 5 PM this Thursday."
3. "Run a scan on my OneDrive and generate a report of all orphaned files that haven't been accessed in over 90 days."

Tips & Limitations

• Security: This skill relies on delegated permissions; ensure your Azure account has MFA enabled to prevent unauthorized access.
• Rate Limiting: Microsoft Graph API has specific throttling thresholds; avoid running heavy drive scans frequently to prevent API lockout.
• Permissions: If a command fails, double-check that your Entra ID app has granted administrative consent for the requested scopes.
• Scope: The skill is limited to the data accessible by the authenticated user account. Ensure the user has appropriate permissions to the specific Teams channels being targeted.