Skip to content
LAMB 0.8 · Current documentation editionAll versions ↗

Connect LAMB and Moodle

For LMS administrators and teachers. This guide has two independent parts. Part 1 puts LAMB activities and assistants into a Moodle course. Part 2 lets a teacher connect their own Moodle account so that LAMB LEGATUS, LAMB’s built-in agent for teachers, can read that teacher’s courses and import course materials into a knowledge base.

LAMB needs no Moodle plugin. Part 1 uses Moodle’s standard External tool with LTI 1.1. Part 2 uses Moodle’s standard web services for the mobile app. Nothing is installed on the Moodle server: the only Moodle changes are the standard administration settings described below.

Screenshots show LAMB 0.8 and a demonstration Moodle 4.5 site, captured on 17 October 2026 with synthetic courses and accounts. Addresses such as localhost are local test values: use your institution’s public addresses.

Part 1. LAMB in a Moodle course (LTI 1.1)

LAMB offers three LTI entry paths. Each has its own launch URL and credentials, and they are not interchangeable. Choose your LMS entry path explains when to use each one.

Entry pathTool URL ends inConsumer keyShared secret
LAMB activity tool (chat, file evaluation, LLM access)/lamb/v1/lti/launchThe installation’s key, shown in LAMB’s LTI SettingsSet in the same LTI Settings
One published assistant/lamb/v1/lti_users/ltiThe assistant’s own key, shown in its LTI Publish DetailsOne secret for all published assistants, held by the server administrator
Educators open LAMB Creator/lamb/v1/lti_creator/launchThe organization’s keyThe organization’s secret

LAMB checks every launch signature against the address the launch arrived at. The Tool URL in Moodle must therefore be your LAMB server’s exact public address, with the same https scheme and host name your users see.

The steps below set up the LAMB activity tool once for the whole Moodle site. Teachers then add it to any course.

Set up the tool (LAMB and Moodle administrators)

  1. In LAMB, a system administrator chooses Admin in the top bar, then the LTI Settings tab. Under LMS Setup Information it shows the Launch URL and Consumer Key, each with a Copy button. Type the secret under OAuth Shared Secret and choose Save LTI Configuration. When you change the consumer key, type the shared secret again in the same save.
  2. In Moodle, go to Site administration > Plugins > Activity modules > External tool > Manage tools and follow configure a tool manually.
  3. Fill in Tool name (for example “LAMB activities”), Tool URL (the Launch URL from step 1), LTI version “LTI 1.0/1.1”, Consumer key and Shared secret.
  4. Set Tool configuration usage to Show in activity chooser and as a preconfigured tool so teachers can find it in their course.
  5. Choose a Default launch container. The demonstration uses Existing window. Test the container you choose with a teacher and a student account before courses use it.
  6. Under Privacy:
    • Share launcher’s email with tool: Always. On a teacher’s first launch, LAMB finds the teacher’s LAMB account by this email. Without it, a teacher whose LAMB account uses an ordinary email and password sees a page asking them to contact the administrator.
    • Share launcher’s name with tool: Always. LAMB uses it as the display name.
    • Accept grades from the tool. Needed only for File Evaluation, which sends grades back to Moodle when the teacher syncs them. Choose Always, or As specified in Deep Linking definition or Delegate to teacher to let each teacher decide in the activity. Moodle sends the grade return details only when this is on.
  7. Leave the Services section as it is and Save changes.
Moodle External tool configuration form filled in for the LAMB activity tool
Moodle 4.5 site administration on a demonstration site, 17 October 2026. Moodle masks the shared secret. The Tool URL is a local test address. Capture details · Full size

Add an activity to a course (teacher)

  1. In the Moodle course, turn on Edit mode and choose Add an activity or resource. The tool appears under the name the administrator gave it.
  2. Give the activity a name. For File Evaluation, if the administrator chose the delegate option, open the Grade section and tick Allow LAMB activities to add grades in the gradebook (Moodle shows the tool’s name here). Then choose Save and display.
Moodle activity chooser with a LAMB activities tile
The site-wide tool appears in a teacher's activity chooser as LAMB activities. Demonstration course, 17 October 2026. Capture details · Full size
Moodle New External tool form with the activity name Research Methods helper
Naming the new activity in the demonstration course, 17 October 2026. Capture details · Full size
  1. The first launch by a teacher opens LAMB Activity Setup for that course. Choose the activity type: AI Chat Activity or File Evaluation. LLM access also appears when your organization has set up model access for learners.
  2. Select the assistants learners can use. Only published assistants appear here, so publish them in LAMB first. For File Evaluation, each selected assistant needs a rubric (RAG processor “Rubric RAG”, chosen when the assistant is created), and the activity needs a title and a deadline.
  3. Decide on Allow instructors to review chat transcripts. If you turn it on, teachers can read students’ conversations with each student’s name, and students are told the first time they open the chat. This choice cannot be changed after setup.
  4. Choose Save & Launch. You arrive at the activity’s instructor view, with its students, chats, assistants and access log.
LAMB Activity Setup page with AI Chat Activity selected and one assistant checked
First teacher launch from Moodle into LAMB 0.8, 17 October 2026. LLM access is not offered because the demonstration organization has not set it up. Capture details · Full size
LAMB instructor view of a configured chat activity with zero students
The instructor view straight after setup. Transcript review was left off, and the page says it cannot be changed after creation. Capture details · Full size
  1. Test as a student with a demonstration account. Before a teacher completes setup, a student sees a waiting page. After setup, the student opens the activity with the assistants the teacher selected. For File Evaluation, grades do not reach Moodle on their own: after reviewing them, choose Sync Grades to Moodle in the instructor view, then check that the grade arrives in the Moodle gradebook.

A teacher must already have a LAMB account to set up an activity. LAMB finds it by the email Moodle sends, or by the account created when the teacher first used Creator access from Moodle.

The other two paths in brief

  • One published assistant. Publish the assistant in LAMB. Its detail view then shows LTI Publish Details with the Tool URL and the consumer key. The secret field reads “ASK ADMIN FOR THE SECRET”: the server administrator sets one secret for all published assistants and should replace any default with their own. In Moodle, email sharing is not needed; share the name so learners appear with a readable name.
  • Educators open Creator. An organization administrator opens Org Admin > Settings > LTI Creator, ticks Enable LTI Creator Access and sets the consumer key and secret. The key must be unique across organizations. New users arrive as members of that organization. Email sharing is not needed; share the name for a readable display name.

Expected result: a teacher adds the LAMB tool from the activity chooser, completes setup on the first launch and reaches the instructor view, and a demonstration student can open the configured activity.

Part 2. Connect a teacher’s Moodle account for LAMB LEGATUS

With this connection, LAMB LEGATUS can read the courses a teacher teaches and, after the teacher approves, import course materials into a LAMB knowledge base. Each teacher connects their own account. LAMB can do only what that Moodle account is already allowed to do.

What Moodle needs (standard settings only)

  • Enable web services for mobile devices is on.
  • For the QR route: QR code access is set to QR code with automatic login. Moodle offers this option only on a site served over HTTPS. Moodle refuses QR login for site administrators and for other users who can change the site configuration; those accounts use the token field instead.
  • Users can create mobile tokens. In standard Moodle the authenticated user role already has this permission. No extra role is needed.
  • To read course-wide information, the teacher holds a teacher, non-editing teacher or manager role in that course.

The LAMB server administrator must also set the connector’s encryption key, LAMB_MOODLE_ENCRYPTION_KEY, in the server environment: a Fernet key generated once, as described in the Moodle connector installation notes, and backed up outside the database. Without it, connecting fails with “The administrator must configure LAMB_MOODLE_ENCRYPTION_KEY”. LAMB encrypts each stored Moodle token with it. If the key is lost or changed, every teacher has to connect again.

Enable the connector (organization administrator)

  1. Open Org Admin > Settings > Moodle.
  2. Tick Enable Moodle connector.
  3. Enter the Allowed Moodle base URL: one address, http or https, without a user name, query or fragment.
  4. Choose the Access mode. Read only allows reading and approved imports. Allow selected writes makes two more boxes available: Allow forum replies and new discussions and Allow reviewed grade proposals to be saved. Grade writes are off by default.
  5. Read the disclosure text on the page (its “AAC driver model” is the model LAMB LEGATUS uses), then choose Save organization settings.
Organization Moodle settings with the connector enabled in read-only mode
Org Admin > Settings > Moodle in LAMB 0.8, 17 October 2026, in read-only mode with both write options off. Capture details · Full size

Connect your account (teacher)

  1. Once the connector is enabled, a Moodle link appears in LAMB’s top bar. It opens Your Moodle.
  2. With a QR code: in Moodle, open your profile, display the QR code for automatic mobile login and take a screenshot. Within about three minutes, upload it under QR code image, choose your computer under Your computer (macOS, Windows PowerShell or Linux) and choose Prepare local command. LAMB only reads the image and builds a command; nothing is exchanged or stored yet.
  3. Run that command in a terminal on the same computer and network. It sends Moodle’s standard QR-login request for your token, identifying itself as the Moodle app because Moodle accepts that request only from the app, and copies the token to the clipboard. If your institution does not allow this, use the token field instead.
  4. Paste the token into Mobile-service token and choose Connect Moodle. You can also paste an existing mobile-service token for your account here.
  5. LAMB checks that the token works on the allowed Moodle site, then stores it encrypted with your connection. It does not check that the Moodle account is yours, so paste only a token for your own account.

Never paste a Moodle token into a LAMB LEGATUS conversation. LAMB LEGATUS does not ask for one.

Your Moodle page before connecting, with QR upload, computer choice and token field
Your Moodle before connecting, 17 October 2026. The demonstration Moodle runs without HTTPS, so its QR route could not be completed; the connection shown next was made with a pasted token. Capture details · Full size
Your Moodle page showing a connected account and one course where the user is a teacher
After connecting: the Moodle site, its version, the account, and courses grouped by the teacher's role. Capture details · Full size

What LAMB LEGATUS can then do

Open LAMB LEGATUS from the top bar and ask about your course. See Work with LAMB LEGATUS for the basics.

  • Without asking: read courses, assignments, forums, grades, quizzes, the calendar and similar information, with course-wide reads limited to courses where you are a teacher; collect new forum posts across those courses; read a course file, Page or Book without importing it.
  • Drafts for your review: feedback on a submission with a proposed grade and a rationale. A draft changes nothing in Moodle.
  • After your approval, one card per action: import a File, Folder, Page or Book into a new or existing knowledge base. Imports need approval even in read-only mode. The card lists the source, the destination, each file and the chunk settings.
  • Only if the organization allows writes, and with approval each time: post or reply in a forum, or save one learner’s grade with its rationale after you have seen the submission. When a write is not allowed, LAMB LEGATUS offers a draft for you to post yourself.

Tick Advanced mode on the Your Moodle page to see the exact command on each approval card as well as the explanation. It applies to all your conversations.

LAMB LEGATUS approval card for creating a knowledge base from a Moodle folder
An import waiting for approval, 17 October 2026: source folder, new knowledge base, two files, chunk settings, and Create and import, Edit proposal or Cancel. Capture details · Full size

What reaches the model provider

Student names, posts and grades that LAMB LEGATUS reads reach the organization’s configured model provider. Details of a proposed action also reach the organization’s small, fast model, which writes the approval explanation. When LAMB LEGATUS reads a course file, Page or Book without importing it, the full text of that document goes to the organization’s small, fast model, or to the LAMB LEGATUS model if no small model is set; LAMB LEGATUS itself receives only an overview and the passages it asks for. With a local provider this data stays on your premises; with a hosted provider it leaves them. Plan this with your data protection officer. See also privacy.

Disconnect

  1. On Your Moodle, choose Disconnect Moodle. LAMB deletes the stored token and cancels any approval still waiting.
  2. Disconnecting does not revoke the token in Moodle. To revoke it, change your Moodle password and leave Log out of all web apps ticked (this signs out every mobile and web-service session of your account), or ask your Moodle administrator to delete the token under Site administration > Server > Web services > Manage tokens.

If the administrator changes the allowed Moodle address, your connection shows “Stored connection is inactive”. Disconnect, then connect again.

Expected result: Your Moodle shows Connected with your account and your courses, LAMB LEGATUS can describe a course you teach, and an import creates a knowledge base only after you approve its card.