🦞 OpenClaw Termux

OpenClaw Termux is a specialized distribution of OpenClaw, optimized specifically for Android devices via Termux. It brings a powerful personal AI assistant directly to your phone, with deep integration for mobile messaging and system tools.

📱 Mobile Optimizations

• Persistence: Integrated termux-wake-lock to ensure your assistant stays online even when the screen is off.
• Efficiency: Capped Node.js heap to 1GB and optimized SQLite with WAL mode for mobile RAM and storage limits.
• Native Tools: Integrated termux-api for native Android notifications, toasts, and optional SMS control.
• Search: Includes built-in DuckDuckGo support for free, API-keyless web searching.
• Health: Specialized moltbot doctor checks tailored for common Termux environment issues.

🚀 Getting Started

1. Quick Install

The recommended path for most users:

curl -s https://explysm.github.io/moltbot-termux/install.sh | sh

2. Configuration

Initialize your workspace and link your accounts:

moltbot onboard

3. Start the Gateway

Run the control plane manually (daemon mode is currently disabled on Android):

moltbot gateway --port 18789 --verbose

Setting up on a "server phone"?

Go to explysm/OpenClaw-Termux-Android and download the latest apk for a experimental "Ui Wrapper." (although it doesn't have that much of a benefit compared to straight termux.)

🕹 Common Commands

| Task | Command | | :--- | :--- | | Send Message | moltbot message send --to <number> --message "Hi" | | Direct Turn | moltbot agent --message "Build a grocery list" --thinking high | | Health Check | moltbot status or moltbot health | | Fix Issues | moltbot doctor --fix | | Self-Update | moltbot update |

🛠 Troubleshooting & Fixes

Manual Clipboard Fix: If clipboard support is missing, run this to stub the provider for mobile:

# Save as fix-clipboard.sh and run
CLIPBOARD_FIX_PATH=$(find "$HOME/.local/share/pnpm/global" -name "index.js" -path "*/@mariozechner/clipboard/*" | head -n 1)
if [ -n "$CLIPBOARD_FIX_PATH" ]; then
    cat > "$CLIPBOARD_FIX_PATH" <<EOF
module.exports = {
  availableFormats: () => [], getText: () => "", setText: () => {}, hasText: () => false,
  getImageBinary: () => null, getImageBase64: () => null, setImageBinary: () => {},
  setImageBase64: () => {}, hasImage: () => false, getHtml: () => "", setHtml: () => {},
  hasHtml: () => false, getRtf: () => "", setRtf: () => {}, hasRtf: () => false,
  clear: () => {}, watch: () => {}, callThreadsafeFunction: () => {}
};
EOF
fi

Gemini CLI NDK Build Fix (if gemini-cli npm install fails):

mkdir -p ~/.gyp && echo "{ 'variables': { 'android_ndk_path': '' } }" > ~/.gyp/include.gypi

🔃 Upstream Sync & Development

A Note on Upstream Sync

This project is a fork of the official OpenClaw repository and stays updated through a unique, semi-automated process. Instead of direct merges, which often lead to conflicts, this fork uses Gemini to interpret and re-implement commit messages from the upstream main branch.

This approach has two important implications:

1. Implementation Divergence: The exact code from an upstream commit is not carried over. Gemini provides its own implementation based on the description in the commit message.
2. Dependency on Commit Quality: Vague or unclear commit messages may be skipped entirely if their intent cannot be reliably determined.

While this method allows the project to keep pace with OpenClaw's development, it's a best-effort process that depends heavily on the clarity of the upstream commit history.

🦞 Links & Support

• Official Documentation: docs.molt.bot
• Security Guidance: gateway/security
• Upstream Project: OpenClaw GitHub
• Community: Discord

OpenClaw Termux is maintained by the community. Licensed under MIT.