🦞 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.

---

$3

- 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.

---

$3

#### 1. Quick Install
The recommended path for most users:
``bash
curl -s https://explysm.github.io/moltbot-termux/install.sh | sh
`

#### 2. Configuration
Initialize your workspace and link your accounts:
`bash
moltbot onboard
`

#### 3. Start the Gateway
Run the control plane manually (daemon mode is currently disabled on Android):
`bash
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.)
---

$3

| Task | Command |
| :--- | :--- |
| Send Message | moltbot message send --to --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 |

---

$3

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


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" <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):
`bash
mkdir -p ~/.gyp && echo "{ 'variables': { 'android_ndk_path': '' } }" > ~/.gyp/include.gypi
`

---

$3

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.

---

$3

- 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.