【免费下载链接】thClawsOpen-source AI agent harness in native Rust — GUI, CLI, headless, and webapp from one binary. Multi-provider, MCP, skills, plugins, agent teams.项目地址https://gitcode.com/gh_mirrors/th/thClaws点击查看免费下载thClaws.cloud 是开源 AI Agent 框架 thClaws 的云端能力中心把一个文件夹就是一个 Agent的本地模型升级为可浏览、发布、安装的 AI Agent 目录市场可租用的托管运行时以及按量计费的 LLM 计量网关。本指南带你从零配置 Cloud 目录、发布并安装 Agent、租用托管工作区并打通计量网关调用大模型——全程无需自己运维任何后端。 核心心智本地 thClaws 里一个文件夹 一个 AgentthClaws.cloud 只是把文件夹在机器之间搬来搬去的目录 运行时 计费代理。1. 什么是 thClaws.cloud先理解folder-is-an-agentthClaws 的 Agent 模型极其简单任意目录下放三个文件它就是一个完整 Agent。文件作用AGENTS.mdAgent 的指令系统提示 人格manifest.json目录元数据slug、license、icon、tags发布时需要./.thclaws/本地状态settings、KMS、sessions、memory当你在某个文件夹里启动 thClaws就等于运行了那个 Agent。thClaws.cloud 在此之上只加了三类操作Publish发布把文件夹打包成带版本的 tarball上传到目录。Get获取下载某一行解包到目标文件夹除非agent.uuid匹配否则拒绝覆盖非空目录。Rent租用服务端起容器、装入 Agent、在/u/handle/slug/提供真实聊天 UI浏览器即可访问。换句话说它就像AI Agent 界的 git粘贴一次 CLI token之后所有目录操作/cloud get、/cloud publish、/cloud list…都变成会话内的一条斜杠命令。 与另一个市场区分thClaws.cloud目录放的是Agent 模板而 marketplace.md 描述的Marketplace/skill marketplace、/mcp marketplace、/plugin marketplace放的是Skills / MCP 服务器 / 插件两者架构相似但目录对象不同。2. 连接目录市场设置 Cloud URL 与 CLI token把你的桌面端绑定到目录服务器只需两样东西Cloud URL— 写在settings.json::cloud.url默认为公开实例https://thclaws.cloud自托管可改成你的地址。CLI token— 形如thc_…的字符串来自你的目录控制台保存在OS 钥匙串从不进settings.json。在Settings → thClaws.cloud面板里分别粘贴 URL 与 token在控制台点 New token生成保存后所有目录命令即刻可用。Token 从不经过命令行参数或环境变量——GUI 直接写入钥匙串macOS Keychain / Windows 凭据管理器 / Linux Secret Service每个目录请求都在引擎进程内以 Bearer 头发送避免ps或 shell 历史记录泄露。前端对应实现见 SettingsModal.tsx 的CloudSection组件底层 IPC 为cloud_config_get/cloud_config_set。3. 浏览与安装 AI Agent在任意 thClaws 会话REPL 或 Chat 标签内❯ /cloud status thClaws.cloud — https://thclaws.cloud (token: ✓ stored) ❯ /cloud list - hello-world v0.1.0 Hello-world demo agent (jimmy) - legal-doc-reviewer v0.4.2 Reviews contracts paragraph-by-paragraph (acme) - weekly-research v1.0.0 Saturday-morning newsletter writer (rin)/cloud get永远安装到当前会话的工作目录。典型流程先在 shell 建一个空文件夹并cd进去启动 thClaws然后/cloud get hello-world引擎下载 tarball、逐文件解包下一条/reload就能读到新的AGENTS.md。目录安全机制/cloud get拒绝覆盖非空文件夹除非它已是同一个 Agent按 UUID 匹配。目标文件夹状态行为空全新安装有匹配agent.uuid的AGENTS.md/manifest.json安全更新保留你的.thclaws/状态agent.uuid不匹配中止——文件夹属于别的 Agent其它散文件中止——请装进空文件夹 斜杠层故意不提供--force不确定时直接/cloud get进一个全新的空目录即可。4. 发布你自己的 Agent在已构建好的 Agent 文件夹会话里执行❯ /cloud publish # 上传当前目录它会做三件事Tar gzip文件夹——自动剥离 secrets、sessions、KMS 页面与./.thclaws/状态目录可放心每日重发而不泄露对话历史上传到你的目录使用 CLI token回写 Agent 身份到settings.json。manifest.json缺失或非法时publish 会以清晰报错中止最小必填字段为id、name、description、version。首次发布会分配一个uuid并写回settings.json::agent.uuid后续 publish 命中同一目录行版本号自增。想fork别人下载来的 Agent先/cloud unbind清掉agent.uuid再改id并/cloud publish即可拿到全新 UUID。可见性分三档在 Web 端 Agent 页切换非桌面命令可见性谁能看/装public所有人需超级管理员审核unlisted默认有链接的人自发布 Agent 的分享默认档private仅作者与 root其它人一律 404不可枚举5. 托管运行时租用工作区而不是安装不想把 Agent 装在本地笔记本上目录也能把它们跑成托管工作区——每个工作区一个容器、一个浏览器可打开的 URL背后是同一套本地引擎驱动的真实聊天 UI。从目录 Web UI 操作打开某 Agent 的详情页点Install on hosted选择或新建一个ready工作区目录把 Agent 装入该工作区并重定向到/u/your-handle/slug/的聊天界面handle 是稳定的每用户 id两个用户可有同名工作区而不冲突 URL。托管工作区同时支持BYOK自带密钥填在Settings → Hosted keys与计量网关按量计费代理见第 7 节在工作区创建时通过单选切换。本地文件夹 ⇄ 托管工作区双向同步托管工作区不是只能从浏览器触达的死胡同你可以把一个本地文件夹与之配对双向搬文件❯ /cloud push # 本地 → 托管 ❯ /cloud pull # 托管 → 本地 ❯ /cloud revision # 谁在哪个 revision、是否有未同步改动只读第一次push即完成配对之后的push/pull记住同一工作区用--workspace slug指定别的。/cloud revision严格只读不会唤醒休眠工作区状态查询不该让你付 pod 恢复的钱离线也能打印本地那一半。常用标志--dry-run只报告不搬、--delete删除对端多余文件、--force越过分叉保护、--force-rebind重绑到另一工作区隐含--force。⚠️ 多用户 pod 不可用这些命令按进程工作目录操作单棵树而多用户 pod 一个进程服务所有租户直接拒绝执行。共享 Agent一个公司 Agent多人共用共享 Agent是公司自有、多人同时使用的单个 Agent客服机器人、内部研究助手、入职向导。它属于托管云能力在Dashboard → Shared agents面板管理。一个只读公司大脑多个私有工作区所有者上传大脑AGENTS.md、公司 KMS、skills、斜杠命令、mcp.json——只有工具配置、从不带凭据每个成员工作区把它只读挂载成员各自的聊天记录、文件、增量 KMS、MCP 登录彼此不可见。锁定公司配置共享模式下引擎只认公司AGENTS.md模型可被所有者固定。仅网关、所有者付费共享 Agent 无 BYOK、无.env所有推理走计量网关、计入所有者可设每成员每日消费上限防止一人吃光账单。只读即要改请 fork成员无法编辑共享大脑可将其 fork 成自己私有的 Agent 再自由修改。6. 计量网关按量计费的 LLM 代理不想自己管理 Anthropic / OpenAI / Gemini 账号thClaws.cloud 提供计量网关一次性充值 credit然后用gw_v1_…token 调用任意模型网关转发到上游、对响应计量并扣减余额。从桌面端启用在目录 UI 生成网关 key/gateway/keys→Mint new gateway key→ 复制gw_v1_…。充值/credit选档位$5 / $20 / $100大额有赠送。让 thClaws 指向网关GUI Settings → Providers或环境变量export ANTHROPIC_API_KEYgw_v1_… export ANTHROPIC_BASE_URLhttps://thclaws.cloud/gateway/anthropic export OPENAI_API_KEYgw_v1_… export OPENAI_BASE_URLhttps://thclaws.cloud/gateway/openai/v1 # GEMINI_* / OPENROUTER_* 同理正常跑 thClaws调用经网关转发消费落在/credit/usage。桌面端网关实现是一个透明 overlay它不是新的 Provider而是在build_provider内部改写 Base URL 与 auth 值。Provider 保持原生协议OpenAI 仍走 Chat CompletionsAnthropic 仍走/v1/messages网关只做改地址 换凭据。源码见 thclaws_gateway.rs 与 provider-thclaws-gateway.md。Credit 是唯一门槛没有模型档位阶梯——旧版starter/pro/enterprise已取消。余额为正即可调用任意可用模型只有余额为 0 才返回402 Payment Required。价格差自己发挥作用一次重量级 Opus 调用天然比 Haiku 更费 credit。媒体路由按单元计量视频按秒、TTS 按字符、图像按张、Whisper 按秒。网关固定主机为gateway.thclaws.cloud覆盖 OpenAI / Anthropic / Gemini / OpenRouter 及一批 OpenAI 兼容上游dashscope、deepseek、minimax、xai、moonshot 等。7. 命令与概念速查命令位置作用Settings →thClaws.cloudGUI设置 Cloud URL CLI token唯一登录/登出路径/cloud status会话斜杠显示解析后的 URL token 状态/cloud list [--mine]会话斜杠浏览目录/cloud get slug会话斜杠装到会话 cwd非空/不匹配则中止/cloud publish会话斜杠上传会话 cwd/cloud unbind会话斜杠清掉agent.uuid下次 publish 建新行/cloud push//cloud pull会话斜杠与托管工作区同步文件/cloud revision会话斜杠本地 vs 云端同步版本 是否 dirty/credit·/gateway/keys·/credit/usageWeb UI充值 · 生成gw_v1_…· 查看每笔消费8. thClaws.cloud 不是什么预期管理不是模型托管目录 Agent 仍调用 Anthropic / OpenAI / Gemini 做推理BYOK 或网关计费代理thClaws.cloud 不训练/托管 LLM。不是会话存储对话历史留在运行机上./.thclaws/state/sessions/云端存的是 Agent 文件不是会话。非必需前面的所有章节都能离线工作。云是增量能力——装好 thClaws、写好AGENTS.md不注册也能拥有可用 Agent。9. 参考资料想深入源码与文档可看这些相对路径客户端全貌thclaws-technical-manual/thclaws-cloud-client.md用户手册第 27 章user-manual/ch27-thclaws-cloud.md网关 overlay 详解thclaws-technical-manual/provider-thclaws-gateway.mdSkills/MCP/插件市场thclaws-technical-manual/marketplace.md目录客户端源码crates/core/src/cloud/mod.rs网关 overlay 源码crates/core/src/providers/thclaws_gateway.rsGUI 云/网关设置面板frontend/src/components/SettingsModal.tsx赞分享【免费下载链接】thClawsOpen-source AI agent harness in native Rust — GUI, CLI, headless, and webapp from one binary. Multi-provider, MCP, skills, plugins, agent teams.项目地址https://gitcode.com/gh_mirrors/th/thClaws点击查看免费下载相关推荐AI Agent Handbook 新手完整入门企业级 AI Agent 构建、运行、治理与调优一站式指南AI Agent Handbook 新手完整入门企业级 AI Agent 构建、运行、治理与调优一站式指南 如果你正在寻找一本系统讲解 企业级 AI Agen文档教程人工智能AI AgentZotero插件市场一站式插件管理神器完全指南一、项目核心价值深度解析 Zotero插件市场是什么 Zotero插件市场是一款革命性的Zotero扩展工具它彻底改变了传统插件安装方式将插件管理体插件系统桌面应用OpenSquilla 快速上手指南从安装、配置到运行本地 AI Agent 网关OpenSquilla 快速上手指南从安装、配置到运行本地 AI Agent 网关 本篇指南面向希望在本地完整跑通 OpenSquilla 标准产品体验的开发人工智能大模型AI Agent交互助手工具调用MCP 服务Agent 记忆RAG本地部署创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考