FastClaw - AI Agent Framework with multi-channel support
Project description
FastClaw
A lightweight but powerful AI Agent framework in Python.
PyPI Installation (Recommended)
# Install
pip install fastclaw-ai
# Run
fastclaw start
# Persistent running (recommended for server)
nohup fastclaw start > /tmp/fastclaw.log 2>&1 &
Configure Agent
After starting, visit http://localhost:8765 , click Settings in the top right corner to configure main_agent, recommended: deepseek-chat.
Or edit the config file:
vim ~/.fastclaw/workspace/data/agents/main_agent/metadata.json
CLI Usage
# Interactive chat
fastclaw chat
# New session
fastclaw chat --new
# Check status
fastclaw status
Git Clone
git clone https://github.com/kandada/fastclaw.git
cd fastclaw
pip install -r requirements.txt
# Run
python main.py start
# Persistent running
nohup python main.py start > fastclaw.log 2>&1 &
Configure Agent
After starting, visit http://localhost:8765 , click Settings in the top right corner to configure main_agent, recommended: deepseek-chat.
Or edit the config file:
vim workspace/data/agents/main_agent/metadata.json
CLI Usage
# Interactive chat
python main.py chat
# New session
python main.py chat --new
# Check status
python main.py status
Design Philosophy
FastClaw is built on the core concept of event-driven agent orchestration. Key design principles:
- Graph-based Agent: Uses a directed graph to orchestrate agent behavior, supporting conditional branching between nodes (e.g., tool execution, response generation)
- Event Streaming: Real-time streaming output of LLM responses for better user experience
- Tool System: Extensible tool framework supporting Shell commands, skills, and custom integrations
- Session Management: Persistent conversation history with multi-session support
- Cron Scheduling: Built-in cron-style task scheduling for automated workflows
Features
- 🤖 LLM-powered - Built on FastMind framework with streaming support
- 🔧 Tool Calling - Execute Shell commands, skills, and more
- ⏰ Cron Jobs - Schedule tasks with cron expressions
- 💬 Multi-channel - Feishu, iMessage integrations
- 🎨 Extensible - Easy to add custom skills and agents
- 🐍 Python Ecosystem - Seamlessly call professional libraries like numpy and pandas, enabling AI to use Python ecosystem tools as skillfully as humans
License
GPL-3.0
Copyright (c) 2024-2026 xiefujin. All rights reserved.
Official Website
https://www.fastclaw.world/ | https://fastclaw-ai.com/
Acknowledgments
Inspired by OpenClaw. Special thanks to the open source community.
FastClaw is powerful, but its use depends entirely on the user - all responsibility lies with the user yourself.
Author:xiefujin email: 490021684@qq.com,welcome to contact me.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fastclaw_ai-1.1.5.tar.gz.
File metadata
- Download URL: fastclaw_ai-1.1.5.tar.gz
- Upload date:
- Size: 626.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
03655985cea3e843e8b78a0cae523a94b1231cdccdcdf5ecb406ff7fe2bfa71a
|
|
| MD5 |
d01f4936303cc7d455203d19e770e6d7
|
|
| BLAKE2b-256 |
c9475885e0101336ff3bf70199addc21d112ea22d79e1e62c998f96dfc170824
|
File details
Details for the file fastclaw_ai-1.1.5-py3-none-any.whl.
File metadata
- Download URL: fastclaw_ai-1.1.5-py3-none-any.whl
- Upload date:
- Size: 637.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca32ffae9e556b5e881993bf9a461504f51ca50beed00de209d82b9caf771b17
|
|
| MD5 |
bb6d99d10de497bb16a73285e1e711dc
|
|
| BLAKE2b-256 |
107e2d98f9971b28dee3149222776362e0eeafababda1020cd28d628ddff6f53
|