openclaw/docs/guides/remarkable-integration.md

reMarkable Tablet Integration

Connect your reMarkable tablet to Clawdbot via Tailscale for direct SSH access from anywhere.

Overview

This guide sets up:

• Tailscale VPN on your reMarkable (userspace networking mode)
• Direct SSH access via Tailscale IP
• Ability to upload/manage documents remotely

Tested on: reMarkable 2, OS 3.24.0.149

Prerequisites

• reMarkable with SSH access enabled
• Another computer on the same network (for initial setup)
• Tailscale account

Step 1: Get Tailscale Binaries

The reMarkable's root partition is small (~21MB free), so we install to /home.

# On a computer that can reach your reMarkable
# Download the ARM static binary
curl -fsSL https://pkgs.tailscale.com/stable/tailscale_1.94.1_arm.tgz -o /tmp/tailscale_arm.tgz

# Copy to reMarkable (replace IP with yours)
scp /tmp/tailscale_arm.tgz root@<REMARKABLE_IP>:/home/

Step 2: Install on reMarkable

SSH into your reMarkable and run:

cd /home
tar xzf tailscale_arm.tgz
mkdir -p /home/bin /home/tailscale-state
cp tailscale_*/tailscale tailscale_*/tailscaled /home/bin/
chmod +x /home/bin/tailscale /home/bin/tailscaled

Step 3: Start Tailscale

The reMarkable kernel doesn't have TUN support, so we use userspace networking with --statedir for SSH keys:

# Start the daemon
nohup /home/bin/tailscaled \
  --statedir=/home/tailscale-state \
  --socket=/tmp/tailscaled.sock \
  --tun=userspace-networking > /tmp/tailscaled.log 2>&1 &

# Wait a few seconds, then authenticate
sleep 5
/home/bin/tailscale --socket=/tmp/tailscaled.sock up --ssh

This will print an authentication URL. Visit it to add the reMarkable to your Tailnet.

Step 4: Create Systemd Service

For auto-start on boot:

cat > /etc/systemd/system/tailscaled.service << 'EOF'
[Unit]
Description=Tailscale VPN
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/home/bin/tailscaled --statedir=/home/tailscale-state --socket=/tmp/tailscaled.sock --tun=userspace-networking
ExecStartPost=/bin/sh -c 'sleep 3 && /home/bin/tailscale --socket=/tmp/tailscaled.sock up --ssh'
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable tailscaled
systemctl start tailscaled

Step 5: Configure SSH Client

On your local machine, add to ~/.ssh/config:

Host rem
  HostName <TAILSCALE_IP>  # e.g., 100.91.182.5
  User root
  StrictHostKeyChecking no
  UserKnownHostsFile /dev/null

Now you can simply run:

ssh rem

Document Management

Once SSH is configured, you can manage documents remotely.

Upload PDFs/EPUBs

# Copy file to reMarkable
scp document.pdf rem:/home/root/

# Create metadata and add to library
ssh rem 'cd /home/root/.local/share/remarkable/xochitl && \
  UUID=$(cat /proc/sys/kernel/random/uuid) && \
  cat > ${UUID}.metadata << EOF
{
    "createdTime": "'$(date +%s)'000",
    "lastModified": "'$(date +%s)'000",
    "lastOpened": "0",
    "lastOpenedPage": 0,
    "parent": "",
    "pinned": false,
    "type": "DocumentType",
    "visibleName": "My Document"
}
EOF
cp /home/root/document.pdf ${UUID}.pdf && \
echo "{}" > ${UUID}.content && \
systemctl restart xochitl'

List Documents

ssh rem 'grep -h visibleName /home/root/.local/share/remarkable/xochitl/*.metadata'

Delete Documents

# Find UUID by name
ssh rem 'grep -l "Document Name" /home/root/.local/share/remarkable/xochitl/*.metadata'
# Delete all files with that UUID
ssh rem 'rm /home/root/.local/share/remarkable/xochitl/<UUID>.* && systemctl restart xochitl'

Troubleshooting

"no var root for ssh keys"

Use --statedir=/home/tailscale-state instead of --state=

Connection timeouts

The reMarkable goes to sleep aggressively. Wake it by tapping the screen.

Tailscale not starting on boot

Check logs: journalctl -u tailscaled

No TUN support

This is normal — the reMarkable kernel doesn't include the TUN module. Userspace networking mode works around this.

Limitations

• Userspace networking: Outbound connections from reMarkable require proxy configuration
• Sleep mode: The tablet sleeps frequently; connections may timeout
• Kernel TUN: Not available without custom kernel (risky)

References

• remarkable.guide/tech/tailscale
• Tailscale userspace networking