thClaws

一个 Rust 二进制，搞定 GUI/CLI/Web 的 AI 智能体

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 187 🐛 待处理 5 👀 关注 17

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1254

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队thClaws

官网地址https://thclaws.ai

GitHubhttps://github.com/thClaws/thClaws

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言Rust

技术栈/模型agent-harness,agent-teams,ai-agent,anthropic,claude-code,cli,desktop-app,developer-tools,gemini,kms,llm,llm-wiki,mcp,model-context-protocol,multi-provider,ollama,openai,rust,tauri,telegram-bot

GitHub 星标★ 1254

上线时间2026-04-20 00:00:00

代码更新2026-11-06

仓库体积52.6 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

thClaws 是一个用原生 Rust 构建的开源 AI 智能体框架，它将 GUI、CLI、无头模式和 Web 应用整合在同一个二进制文件中，解决了开发者需要为不同场景分别部署智能体的问题。它支持多模型提供商（如 Anthropic、Gemini），并集成了 MCP（模型上下文协议）、技能、插件和智能体团队等核心能力。用户可以通过统一的接口构建、运行和管理 AI 智能体，无论是本地桌面应用、命令行工具还是远程 Web 服务。其核心优势在于 Rust 带来的高性能和低资源占用，同时提供灵活的扩展机制，适合从个人自动化到企业级智能体编排的多种需求。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1254

技术标签

agent-harness agent-teams ai-agent anthropic claude-code

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 30 分钟部署方式：本地安装 6 步

环境要求

当前 stable 版 Rust 工具链（CI 所用版本，未固定 MSRV）
Node.js 20+
pnpm 10+（frontend/package.json 固定 pnpm@10.x，corepack 会拒绝 pnpm 9）

安装与启动步骤

1克隆仓库

从 GitHub 拉取 thClaws 源码并进入项目目录，后续所有命令都在此目录下执行。
```
git clone https://github.com/thClaws/thClaws.git
cd thClaws
```
2准备前置依赖

确认 Rust stable、Node.js 20+、pnpm 10+ 已装好；GUI 构建会在编译期嵌入前端产物，须先构建前端再执行 cargo。
3运行桌面 GUI

带 gui feature 编译并启动桌面应用，窗口内含 Files、Terminal、Chat 三个标签页。
```
cargo run --features gui
```
4运行 CLI REPL

以 CLI 交互模式启动，可在提示符下输入斜杠命令，如 /agent、/agents、/dream、/schedule。
```
cargo run -- --cli
```
5执行一次性任务

用 -p 传入单条自然语言指令，程序执行完即退出，适合脚本或快速问答。
```
cargo run -- -p "explain crates/core"
```
6首次启动选密钥后端

首次运行会提示选择密钥后端（OS 钥匙串或 .env）；API Key 不会写入任何配置文件。
```
thclaws
```

关键配置

配置项	必填	说明	示例
`.thclaws/settings.json`	否	项目级设置文件，优先级仅次于 CLI 参数	`/your/project/.thclaws/settings.json`
`~/.config/thclaws/settings.json`	否	用户级设置文件，优先级低于项目级配置	`~/.config/thclaws/settings.json`
`~/.claude/settings.json`	否	兼容 Claude Code 的兜底设置文件	`~/.claude/settings.json`
`.mcp.json`	否	MCP 服务器配置，也支持 .thclaws/mcp.json	`/your/project/.mcp.json`
`CLAUDE.md / AGENTS.md`	否	追加系统提示词，从当前工作目录向上逐级查找	`/your/project/AGENTS.md`
`.env`	否	可选的密钥存储后端，用来替代默认的 OS 钥匙串	`sk-xxxxxxxx`