Build AgentQi Mobile From Source

July 17, 2026 ยท View on GitHub

AgentQi Mobile is a .NET MAUI Android application. Local builds do not need the maintainers' Google Play upload key.

Supported Hosts

  • Windows 11 with PowerShell or a Developer Command Prompt.
  • macOS with a terminal and Xcode command-line tools.

Linux is not listed as a supported .NET MAUI development host. Contributors using Linux can still work on and test the platform-neutral Core and OpenClaw projects.

Prerequisites

Install:

  1. .NET SDK 10. The repository's global.json selects the supported feature band.

  2. JDK 21.

  3. Android SDK platform 36 and current Android SDK build tools.

  4. The .NET MAUI Android workload:

    dotnet workload install maui-android

Set JAVA_HOME and either ANDROID_HOME or ANDROID_SDK_ROOT if your tools are not in their standard locations.

Clone And Validate

git clone https://github.com/agentqi/agentqi-mobile.git
cd agentqi-mobile
dotnet workload restore src/AgentQi.Mobile/AgentQi.Mobile.csproj
dotnet restore AgentQi.Mobile.sln
dotnet test tests/AgentQi.Mobile.Core.Tests/AgentQi.Mobile.Core.Tests.csproj -c Release
dotnet test tests/AgentQi.Mobile.OpenClaw.Tests/AgentQi.Mobile.OpenClaw.Tests.csproj -c Release
dotnet build src/AgentQi.Mobile/AgentQi.Mobile.csproj -f net10.0-android

On macOS or another Bash environment, the same checks are wrapped by:

./scripts/validate-android.sh

Run On An Android Device

Enable developer options and USB debugging on the device, confirm that adb devices lists it, then run:

dotnet build src/AgentQi.Mobile/AgentQi.Mobile.csproj \
  -t:Run \
  -f net10.0-android

You can use demo mode without an OpenClaw gateway. To use live mode, configure an operator token and an HTTPS OpenClaw.NET gateway in Settings. HTTP is intentionally limited to loopback, emulator, and private development addresses.

Create A Local Release Bundle

The following command creates a local validation bundle. It is not signed with the AgentQi Google Play upload key:

./scripts/publish-android-release.sh

Output is written below src/AgentQi.Mobile/bin/Release/net10.0-android/. Files under bin/ and Android package artifacts are ignored by Git.

If you publish your own fork, create and protect your own signing key. Never reuse, request, or commit the AgentQi maintainers' signing credentials.

Platform-Neutral Development

The domain and gateway adapter projects can be built and tested without the MAUI workload:

dotnet test tests/AgentQi.Mobile.Core.Tests/AgentQi.Mobile.Core.Tests.csproj
dotnet test tests/AgentQi.Mobile.OpenClaw.Tests/AgentQi.Mobile.OpenClaw.Tests.csproj

Common Problems

  • NETSDK1147: install or restore the maui-android workload with the same .NET SDK selected by global.json.
  • Java SDK not found: install JDK 21 and set JAVA_HOME.
  • Android SDK not found: install platform 36 and set ANDROID_HOME or ANDROID_SDK_ROOT.
  • Device not found: accept the USB debugging prompt and verify the device with adb devices.