# OctoClaw

Download the Octoclaw application from [here](https://cdn.openledger.xyz/OctoClaw-1.0.2.dmg).

### System Requirements & Permissions

OctoClaw currently supports macOS environments only and requires root-level access for installation.

* Installation must be executed by a root user (sudo privileges required)
* Non-root users will not be able to complete the installation process

#### macOS Requirement

* Supported OS: macOS
* Recommended: Latest stable version

#### Important Note

If you attempt to install OctoClaw without root privileges:

* Installation will fail silently or stop during setup
* Background services will not initialize

Here’s a detailed guide to setup your OctoClaw Bot

### Step 1: Getting Started with OctoClaw

<figure><img src="/files/xfQvEpU27636nXR8WTfM" alt=""><figcaption></figcaption></figure>

#### OctoClaw is OpenLedger claw bot agent designed for:

* Multi-LLM orchestration
* Secure local execution of AI workflows
* Autonomous crypto operations via integrations

Click the "Get Started" button to begin the setup process.

### Step 2: Choosing a Provider and Model

<figure><img src="/files/6xMYMFdO0sKz74TtzpLp" alt=""><figcaption></figcaption></figure>

Select the AI provider you wish to use as your OctoClaw bot's core intelligence layer.&#x20;

OctoClaw supports multiple inference providers:

* Anthropic (Recommended)
* OpenAI
* Google (Gemini)
* Mistral
* Groq
* Cohere
* Together AI
* OpenRouter
* Ollama (local models)

Pick your preferred model iteration from the MODEL dropdown menu.

Click Continue to proceed to authentication.

*<mark style="color:$warning;">Model Recommendation (Claude Sonnet 4.6) - For the best performance and most reliable results, we recommend using models from Anthropic, particularly the Claude series.</mark>*

### Step 3: API Key Input

<figure><img src="/files/rAHWGgT1Im9WKWeQO75Q" alt=""><figcaption></figcaption></figure>

* You must provide a valid API key for your chosen model to execute tasks.
* Click the console link located directly below the input field if you need to generate a new key from the provider's website.

<figure><img src="/files/mKq67sg2V3YYKWiwSX5Z" alt=""><figcaption></figcaption></figure>

* Paste your active API key into the designated text field.&#x20;
* Wait for the system to detect a valid key format, which will activate the installation button and turn it orange.&#x20;
* Click the Install OctoClaw -> button to deploy your OctoClaw bot.

### Step 4: Installing OctoClaw

<figure><img src="/files/V0MHwcVSMwWpl0Fm1aMb" alt=""><figcaption></figcaption></figure>

* Wait while the app downloads and sets up the required services.
* Check for a green tick to confirm the installation is successful.

### Step 6: Accessing the Dashboard

<figure><img src="/files/sRzsxe2nqRC4mCFFm0tQ" alt=""><figcaption></figcaption></figure>

* The Chat interface is the primary execution environment.&#x20;
* Verify your currently active AI model at the bottom left corner of the screen.&#x20;
* Use the central input box to type direct messages or execute commands.

### Step 7: Connecting External Apps

<figure><img src="/files/Jt8j7agd6Ft1IBX6ASFc" alt=""><figcaption></figcaption></figure>

* Go to CONNECT APPS and click CONNECT on the Telegram card.
* Open Telegram → search @BotFather → send /newbot → follow the prompts.
* Copy the API token provided.

### Step 8: Link & Verify Telegram

<figure><img src="/files/iZgnjYMy4GhVsfP7lkS0" alt=""><figcaption></figcaption></figure>

* Paste the token into the Telegram integration in OctoClaw.
* Click Connect to complete setup.
* Confirm the CONNECTED status appears on the Telegram card.&#x20;
* &#x20;Start chatting with your OctoClaw bot directly from your mobile device.

Note: Conversations made through the OctoClaw application will not be reflected in your telegram chat. Conversations made through Telegram will be reflected in the OctoClaw Application.

### Step 9: Exploring Agent Skills

<figure><img src="/files/LnTlPF04vXCdodB0Dhcd" alt=""><figcaption></figcaption></figure>

* Navigate back to the sidebar and open the SKILLS tab.&#x20;
* Add modular integrations to exchanges and other data providers, such as Binance, for executing trades or to access any other information.
* Click CONNECT to begin enabling the OctoClaw bot to perform granular actions and analytics.

### Step 10: Exchange Setup & Activation

<figure><img src="/files/ZwA9VrVz4xrlmmEBVTR6" alt=""><figcaption></figcaption></figure>

* Select your exchange and review the configuration. Enter your API Key and Secret Key (Generate your API Key and Secret Key from your exchange account (e.g., [Binance API settings](https://www.binance.com/en-IN/support/faq/detail/360002502072)).
* Choose and enable the required skill modules (Spot, Convert, Margin, etc.).
* Click Connect after verifying credentials and permissions.
* Wait for authentication and module installation; keep the app open during syncing.
* Once completed, a green ACTIVE tag confirms the integration and active modules.

### Step 11: Interacting with the OctoClaw Bot

<figure><img src="/files/6sGdKkl4Tb1pIrT34kiv" alt=""><figcaption></figcaption></figure>

* Navigate back to the CHAT menu to access the primary chatting interface.
* Use slash commands to quickly interact with your OctoClaw bot's newly connected skills.
* Click on the quick prompt pills, such as "What can you do?", to test its advanced capabilities.&#x20;
* Review the OctoClaw bot's comprehensive responses, which will now display its active capabilities ranging from Personal Assistant functions to active Crypto Trading and System integrations.

*<mark style="color:$danger;">**Disclaimer:**</mark>* \
\
*<mark style="color:$danger;">**Your Telegram bot can execute actions on your behalf. If you add it to public groups or share access, others may send commands that trigger trades or actions. This can lead to loss of funds.**</mark>*

*<mark style="color:$danger;">**Keep your bot private and do not share access.**</mark>*

### Step 12: Viewing Your Balance

<figure><img src="/files/ubp4OtH6trJDauaXHnxR" alt=""><figcaption></figcaption></figure>

* Click on the BALANCE section located on the main left-hand sidebar menu.
* Your overall usage and credits can be tracked here.&#x20;

*<mark style="color:red;">**Disclaimer:**</mark>*\
*<mark style="color:red;">**1. If an older version of Node.js is installed on the system, the installation may fail.**</mark>*

*<mark style="color:red;">**2. For better results, prefer the Claude Sonnet provider.**</mark>*

*<mark style="color:red;">**3. After terminating and reopening the application, the chat screen may take some time to reload.**</mark>*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://openledger.gitbook.io/openledger/octoclaw/octoclaw.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.