moodle-ws

What This Skill Does

The moodle-ws skill provides a robust interface for interacting with Moodle 4.x instances through its native REST Web Services API. Designed for educators, administrators, and developers, this skill abstracts the complexity of Moodle's API endpoints into intuitive commands. It enables the automation of essential LMS tasks, including the creation and configuration of courses, management of user enrollments, and the deployment of educational activities such as quizzes, assignments, and discussion forums. Additionally, the skill supports data retrieval tasks like fetching student rosters or current course listings, and enables the programmatic submission of grades back to the Moodle gradebook, ensuring a seamless integration between your OpenClaw agent and your institutional learning platform.

Installation

To integrate this skill into your environment, use the OpenClaw package manager via the following command in your terminal:

clawhub install openclaw/skills/skills/exeandino/moodle-ws-skill

Once installed, ensure you have your Moodle Web Service token ready. For security best practices, store your credentials in a non-versioned configuration file located at ~/.openclaw/workspace/secrets/moodle-ws.json to prevent accidental exposure of your sensitive API tokens.

Use Cases

• Automated Course Setup: Automatically provision a new course shell, add necessary modules like forums and assignments, and set up enrollment methods at the start of a semester.
• Administrative Efficiency: Quickly enroll or remove bulk lists of students from courses based on external CSV or database inputs, reducing manual entry errors.
• Gradebook Synchronization: Push grades from an automated grading script or external assessment tool directly into the Moodle gradebook.
• Activity Management: Update the due dates of existing assignments or modify quiz settings across multiple courses simultaneously.

Example Prompts

1. "Create a new course named 'Advanced AI Concepts' in the 'Computer Science' category and add an introductory forum."
2. "Enroll the list of students provided in the 'data.csv' file into the 'Machine Learning 101' course."
3. "Update the due date for the 'Final Project' assignment in the 'History 202' course to next Friday at 5 PM."

Tips & Limitations

To ensure operational success, verify that your Moodle user account possesses the required 'webservice' and 'moodle/course' capabilities. Always perform initial testing within a sandboxed Moodle staging environment before deploying automation workflows to a production campus site. Note that this skill requires direct network access to your Moodle instance; if your Moodle is behind a firewall, ensure that your OpenClaw environment is appropriately whitelisted. Remember that the skill's efficacy depends heavily on the scope of permissions granted to the specific API token provided.