Skip to main content
autClaw is a self-hosted automation bot and plugin runtime platform. After you deploy it on Linux or Docker, you can connect IM accounts in the web console, write plugins, install marketplace plugins, configure payments, and review runtime status.
Want to get running first? Follow Deploy autClaw with Docker, then open http://SERVER_IP:8200.

Good fit for these scenarios

Build multi-channel bots

Connect QQ, WeChat, Qianxun, Feishu, and other adapters, then let plugins handle messages, notifications, requests, and payment events.

Turn scripts into plugins

Write automation flows in JavaScript, Python, or Go, and trigger them with rule, event, router, and cron.

Manage the plugin runtime

Install Node.js, Python, and Go runtimes in the console, then manage npm, pip, go, and other dependencies as needed.

Distribute and install plugins

Subscribe to authors, buy or install marketplace plugins, and let authors manage marketplace metadata, listings, and authorization.

Handle paid workflows

Configure WeChat Pay, Alipay, or EasyPay, then let scripts wait for payment, record orders, and continue after success.

Maintain self-hosted instances

Review CPU and memory graphs, hardware info, live logs, online update tasks, and restart status.

Core capabilities

IM adapters and multiple accounts

Manage account connections, default accounts, account status, and send/receive routing through Adapter Gateway. Adapters handle platform protocols, while autClaw handles message dispatch, script scheduling, and delivery receipts.

Local plugin editor

Create, save, start, stop, and debug plugins in “Local apps”. The editor reads the headers at the top of the file and generates menus, parameters, dependencies, scheduled tasks, and marketplace metadata.

Plugin SDK

Use Sender to read message context, reply with text, Markdown, images, voice, video, files, or mixed messages. You can also wait for user input, recall messages, and manage groups.

Buckets and permissions

Store plugin settings, user progress, and cache in buckets. You can search, edit, rename, or delete data in data management, and restrict plugin access to sensitive buckets.

Runtime dependencies

Use mise to manage multiple versions of Node.js, Python, and Go. Use dependency management to install, check, reinstall, cancel, or uninstall plugin dependencies.

Live logs and debugging

Review HTTP, plugin, adapter, dependency, and system event logs. Plugin debugging keeps sessions, messages, and execution records so you can reproduce issues.

What plugins can do

CapabilityHow you can use it
Message triggersUse rule to match text and filter by im_type, user, or group.
Event triggersUse event to handle messages, notifications, requests, meta events, and payment events.
HTTP routesUse router and method to turn a plugin into an HTTP handler.
Scheduled tasksUse cron to run sync, reminder, check, or push tasks on a schedule.
Parameter configUse param to declare form fields with required, secret, boolean, option, and account-scoped settings.
Dependency installUse dependency to declare runtime dependencies and avoid installing packages manually in the container.
Proactive pushUse push, pushImage, pushFile, and pushMixed to send content to a specific channel, group, or user.
Media handlingDownload user-uploaded files and send images, voice, video, files, and mixed messages.
For a new plugin, start with Plugin SDK overview, then fill in triggers, parameters, and dependencies with Manifest headers.

From deployment to daily use

1

Deploy the service

Start autClaw with Docker and persist the data directory to /opt/autclaw or your NAS Docker path.
2

Finish initial setup

Open the console, register an admin account, and follow the prompts to complete login, authorization checks, and machine-code binding.
3

Connect IM accounts

Enable the platform adapter in “Adapter management”, configure account settings, scan a QR code or connect an external framework, and verify that the runtime status is healthy.
4

Install or write plugins

Install plugins from the marketplace, or create scripts in “Local apps”. If you need third-party packages, install them in runtime and dependency management.
5

Observe and iterate

Check resources, errors, and execution records in “System overview” and “Live logs”. After you edit a plugin, save it and trigger another test.

Operations and extensions

Online updates

Trigger an update from the console or an IM channel while keeping user plugins, data, runtime files, and dependency folders.

Docker persistence

Learn the default locations for autMan.db, plugin/, dist/, envs/mise, and envs/packages.

Image hosting

Upload and manage image assets for plugin messages, payment QR codes, diagrams, or temporary materials.

Open API

Create applications and secrets to issue access tokens for external systems, then read system status or user profiles.

Keyword replies

Configure keyword rules without code for common Q&A, quick hints, and basic auto-replies.

Container integration

Test connections to QingLong, Daidai, and other container services so external automation environments can join the autClaw workflow.

Next steps

Deploy autClaw

Prepare Docker and a persistent data directory, then open port 8200 after startup.

Write your first plugin

Choose JavaScript or Python, then read messages and reply with content.
Last modified on June 3, 2026