Openclawd CLI

OpenClawd 的

多提供商人工智能平台。20+法学硕士。MCP集成。桌面+消息。语音输入。代币分析。

建筑

OpenClawd Architecture

npx openclawd-cli

安装

git clone https://github.com/rohitg00/openclawd
cd openclawd && ./setup.sh

将API密钥添加到 .env:

ANTHROPIC_API_KEY=sk-ant-xxx

运行：

cd server && npm start   # Terminal 1
npm start                # Terminal 2

提供商

与任何供应商合作。将API密钥添加到 .env:

ANTHROPIC_API_KEY      # Claude (default)
OPENAI_API_KEY         # GPT-4o, o1
GEMINI_API_KEY         # Gemini 2.0
GROQ_API_KEY           # Ultra-fast Llama
OPENROUTER_API_KEY     # 200+ models
VENICE_API_KEY         # Privacy-focused
DEEPSEEK_API_KEY       # DeepSeek R1
XAI_API_KEY            # Grok
MISTRAL_API_KEY        # Mistral/Codestral

Olama车型在本地运行时自动发现。

模型回退

提供程序发生故障时自动故障转移。在设置>常规或 .env:

FALLBACK_PROVIDER=openai
FALLBACK_MODEL=gpt-4o

当主提供者出错时，OpenClawd会自动重试回退。

令牌使用仪表板

设置>使用选项卡显示：

• 汇总卡片（总代币、估计成本、请求计数）
• 7天代币使用柱状图
• 按提供商细分表
• 聊天中的每条消息令牌徽章

频道机器人

将AI连接到消息平台。在设置>频道或 .env:

TELEGRAM_BOT_TOKEN=xxx        # Telegram (polling mode)
DISCORD_BOT_TOKEN=xxx         # Discord (intents)
SLACK_BOT_TOKEN=xoxb-xxx      # Slack (Socket Mode)
SLACK_APP_TOKEN=xapp-xxx      # Slack app token

WhatsApp通过二维码扫描连接（Baileys，无需令牌）。

每个机器人都支持 /reset, /model ，以及 /status 命令。每个用户的对话历史记录，最多50条消息，24小时会话到期。

语音输入

点击麦克风按钮或按下 Ctrl/Cmd+Shift+V 口述。使用浏览器Web Speech API-不需要外部服务。支持带临时结果的连续听写。

MCP服务器

包括20+台服务器。通过API或配置添加：

# Add from catalog
curl -X POST localhost:3001/api/mcp/servers/from-catalog/github

# Or edit server/mcp-servers.json

可用：文件系统、内存、git、github、slack、postgres、puppetter等。

API

# Chat
curl -X POST localhost:3001/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello", "chatId": "test"}'

# Providers
curl localhost:3001/api/llm/providers

# MCP catalog
curl localhost:3001/api/mcp/catalog

# Usage history
curl localhost:3001/api/llm/usage/history

# Channel status
curl localhost:3001/api/channels/status

# Start a channel bot
curl -X POST localhost:3001/api/channels/telegram/start \
  -H "Content-Type: application/json" \
  -d '{"token": "your-bot-token"}'

详细架构

OpenClawd Detailed Architecture

用户界面

• 桌面应用 --基于Electron的原生应用程序，适用于macOS、Windows、Linux，带有语音输入和令牌仪表板
• 命令行界面 — npx openclawd 用于终端优先工作流
• 频道机器人 --Telegram、Discord、WhatsApp（二维码）、Slack（套接字模式）

后端（服务器：3001）

• 聊天API --SSE通过模型回退流式传输响应
• 提供商注册表 --与20多个LLM提供商的统一接口，具有自动故障转移功能
• 渠道经理 --机器人生命周期、会话管理、每个用户的对话状态
• MCP经理 --加载器+目录，用于30+MCP服务器集成
• 身份验证配置文件和用法 -API密钥管理、令牌跟踪、成本估算
• 代理循环和内存 --持久对话上下文和代理编排

法学硕士提供者（20+）

Claude（代理SDK）、OpenCode（免费+付费）、Ollama（本地）、OpenAI、Gemini、Groq、DeepSeek、Mistral、xAI等。

MCP服务器（30+目录）

文件系统、内存、GitHub、Fetch、Brave、Slack、Git、DB等。从内置目录添加或手动配置。

构建和发布（GitHub操作）

• macOS .dmg / .zip
• 视窗 .exe （NSIS）
• Linux .AppImage / .deb
• npm openclawd-cli
• GitHub发布（草案）

许可证

麻省理工学院