OpenCrabs is a new kind of AI assistant that you can run on your own computer or server. It is a Self‑Hosted AI Agent that learns from the data you give it, fixes its own mistakes, and can talk to other tools like Telegram, Discord, or Slack. In this article we’ll walk through what makes OpenCrabs special, how it works, and why it could be a game‑changer for developers, small businesses, and hobbyists who want full control over their AI.

What Is a Self‑Hosted AI Agent?

A Self‑Hosted AI Agent is an AI program that lives on your own hardware instead of a cloud service. You install it, give it your own data, and it runs locally. This gives you:

  • Privacy – Your data never leaves your network.
  • Speed – No round‑trip to a remote server.
  • Control – You can tweak the model, add new skills, or change how it behaves.

OpenCrabs is built with Rust and uses a text‑based interface called Ratatui. It can run on Linux, macOS, or Windows, and it can be managed through a simple command‑line interface or a web dashboard.

How Does OpenCrabs Work?

OpenCrabs is made up of three main parts:

  1. Core Engine – Handles the conversation flow, keeps track of context, and decides which skill to use.
  2. Skills – Small programs that do specific tasks, like searching the web, calling an API, or generating an image.
  3. Profiles – Separate instances that can run side‑by‑side, each with its own memory and settings.

Core Engine

The core engine is the brain of the agent. It receives user input, decides which skill to call, and stitches the responses together. It also keeps a log of every conversation so you can review or train the agent later.

Skills

Skills are like plugins. OpenCrabs comes with a set of built‑in skills:

  • Web Search – Uses a search engine API to find answers.
  • Image Generation – Calls an image model to create pictures.
  • Telegram Bot – Lets the agent talk on Telegram.
  • Discord Bot – Lets the agent talk on Discord.
  • Slack Bot – Lets the agent talk on Slack.
  • WhatsApp Bot – Lets the agent talk on WhatsApp.

You can also write your own skills in Rust or Python and drop them into the skills folder. The engine will load them automatically.

Profiles

Profiles let you run multiple OpenCrabs agents at the same time. Each profile has its own configuration file, memory, and skill set. This is useful if you want one agent to handle customer support and another to manage internal tasks.

Recent Updates to OpenCrabs

The OpenCrabs project is actively maintained. The latest release, 0.2.94, added several new features that make the agent even more powerful and easier to use.

Multi‑Profile Support

You can now create and switch between profiles with simple commands:

opencrabs profile create dev
opencrabs -p dev service install

Each profile gets its own config, memory, and sessions. This means you can keep your development environment separate from production.

Profile Migration and Export/Import

If you want to move a profile from one machine to another, you can export it as a .tar.gz file and import it on the new machine. This is handy for backups or for sharing a setup with a teammate.

Token‑Lock Isolation

OpenCrabs now uses PID‑based lock files to prevent two profiles from using the same bot token at the same time. If a process dies, the lock is automatically cleaned up.

Self‑Healing Features

If the configuration file gets corrupted, OpenCrabs will automatically restore the last good version. It also tracks provider health and logs any failures, so you can see which APIs are having trouble.

CLI Improvements

The command‑line interface now has a longer idle timeout for CLI providers, so long‑running tasks don’t get cut off prematurely. It also fixes a bug where token usage was lost when the CLI exited unexpectedly.

These updates make OpenCrabs more reliable and easier to manage, especially for teams that need to run multiple agents.

Why OpenCrabs Is a Good Choice for Developers

If you’re a developer or a small business owner, you might wonder why you’d choose a Self‑Hosted AI Agent over a cloud‑based solution. Here are a few reasons:

  • Cost Control – You only pay for the hardware you own. No per‑request fees.
  • Data Security – Sensitive data stays on your premises.
  • Customization – You can add or modify skills without waiting for a vendor.
  • Learning Opportunity – Working with OpenCrabs gives you hands‑on experience with AI fundamentals.

OpenCrabs also integrates well with other tools. For example, you can connect it to your GitHub repository to automatically comment on pull requests, or to your Jira instance to create tickets based on chat input.

Getting Started with OpenCrabs

Below is a quick guide to installing and running OpenCrabs on a Linux machine. The steps are similar for macOS and Windows.

1. Install Rust

OpenCrabs is written in Rust, so you need the Rust toolchain:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

2. Clone the Repository

git clone https://github.com/adolfousier/opencrabs.git
cd opencrabs

3. Build the Binary

Article supporting image

cargo build --release

The binary will appear in target/release/opencrabs.

4. Create a Profile

opencrabs profile create default

5. Configure Bot Tokens

Edit ~/.opencrabs/profiles/default/config.toml and add your bot tokens:

[telegram]
token = "YOUR_TELEGRAM_BOT_TOKEN"

[discord]
token = "YOUR_DISCORD_BOT_TOKEN"

6. Run the Agent

opencrabs -p default service install
opencrabs -p default service start

You should now see the agent online in your chosen chat platform.

Advanced Features

OpenCrabs is more than just a chat bot. It can do a lot of useful things:

1. Self‑Healing

If the agent crashes or a skill fails, OpenCrabs will automatically restart the skill or the whole agent. This reduces downtime and keeps conversations flowing.

2. Skill Development

You can write a new skill in Rust or Python. The skill must expose a simple JSON interface. Once you drop it into the skills/ folder, the core engine will load it automatically.

3. Multi‑Profile Collaboration

You can run a “support” profile and a “development” profile on the same machine. Each profile can have its own set of skills and its own chat platform. This is great for teams that need separate environments.

4. Provider Health Tracking

OpenCrabs keeps a log of how often each external API (like OpenAI or Google) succeeds or fails. You can view this data with the /doctor command in any chat platform.

Comparison with Other AI Agents

There are several other AI agents on the market, such as OpenCrabs’ competitor “OpenCrabs AI Agent” (the same name but a different project) and the newer “SkillClaw & ClawBench” framework. Here’s how OpenCrabs stacks up:

Feature OpenCrabs SkillClaw & ClawBench
Self‑Hosted Yes No
Multi‑Profile Yes No
Self‑Healing Yes Limited
Skill Development Easy Requires more setup
Provider Health Built‑in Not built‑in

OpenCrabs offers a more complete package for teams that want full control over their AI.

Real‑World Use Cases

1. Customer Support Bot

A small e‑commerce store can run OpenCrabs on a local server to answer FAQs, process returns, and provide order status. Because the agent is self‑hosted, the store keeps all customer data in-house.

2. Internal Knowledge Base

A software team can use OpenCrabs to answer questions about code, pull requests, or deployment status. The agent can pull data from GitHub, Jira, and Slack, and it can even generate documentation snippets.

3. Personal Assistant

An individual can run OpenCrabs on a Raspberry Pi to manage calendar events, set reminders, and fetch news headlines. The agent can also generate images or short videos using the built‑in image skill.

Future Roadmap

The OpenCrabs team is actively working on new features:

  • GraphQL API – Expose the agent’s capabilities through a GraphQL endpoint.
  • Web Dashboard – A browser‑based UI for managing profiles and viewing logs.
  • AI‑Based Skill Generation – Use an LLM to auto‑generate new skills from natural language descriptions.

These additions will make OpenCrabs even more powerful and user‑friendly.

How to Contribute

OpenCrabs is open source. If you want to help:

  1. Fork the repository.
  2. Create a new branch for your feature.
  3. Submit a pull request with clear documentation.
  4. Join the community on Discord or Telegram to discuss ideas.

Your contributions help keep the project alive and growing.

Conclusion

OpenCrabs is a Self‑Hosted AI Agent that gives you full control over your AI. With its self‑healing, multi‑profile support, and easy skill development, it’s a great choice for developers, small businesses, and hobbyists who want to keep their data private and their AI flexible. Whether you’re building a customer support bot, an internal knowledge base, or a personal assistant, OpenCrabs provides the tools you need to get started quickly and scale as you grow.

If you’re interested in learning more or trying it out, check out the official repository on GitHub or visit the Neura AI website for related tools and resources.