Skip to content

RunClawd/oneclaw

 
 

Repository files navigation

OneClaw Logo

🦀 OneClaw

One Minute Install, One OpenClaw.
一分钟装好,即刻开聊。零配置、零依赖的 OpenClaw 桌面客户端。

Latest Release Downloads License


🇨🇳 中文

✨ 为什么选 OneClaw?

不装 Node.js,不跑 npm install,不配环境变量。 双击安装包 → 输入 API Key → 开始对话。就这么简单。

OneClaw 把 OpenClaw 打包成一个开箱即用的桌面应用。内置 Node.js 运行时和完整的 OpenClaw Gateway,你不需要任何开发工具链。

它的目标很简单:让 AI 真正替你动手做事,而不是只会聊天。 🎯

🚀 特性 说明
一分钟安装 下载 → 双击 → 输入 Key → 开聊,全程不超过 60 秒
🖥️ 跨平台 macOS (Apple Silicon / Intel) + Windows (x64 / ARM64)
🔒 密钥本地存储 API Key 只存在你的电脑上,绝不上传任何服务器
🤖 多模型支持 Anthropic / OpenAI / Google / Kimi / 自定义接口,随时切换
🔄 自动更新 内置 CDN 更新,无需手动下载新版本
🧠 会话记忆 自动保存对话上下文,新会话延续旧记忆
🔍 Kimi 搜索 集成 Kimi Search 联网搜索能力
💬 飞书集成 支持飞书机器人频道,团队共享 AI 助手
🛡️ 安装冲突检测 自动检测已有的 OpenClaw 安装,避免端口冲突
🖋️ 终端命令 自动安装 openclaw 命令到 PATH,终端也能用
🌐 国内网络优化 预置镜像配置,国内网络环境也能顺畅使用

📦 下载安装

前往 Releases 页面 下载对应平台的安装包:

平台 架构 下载
🍎 macOS Apple Silicon (M1/M2/M3/M4) OneClaw-x.x.x-arm64.dmg
🍎 macOS Intel OneClaw-x.x.x-x64.dmg
🪟 Windows x64 OneClaw-Setup-x.x.x-x64.exe
🪟 Windows ARM64 OneClaw-Setup-x.x.x-arm64.exe

💡 快速判断:苹果 M 系列选 arm64,Intel Mac 选 x64,绝大多数 Windows 电脑选 x64。

🚀 三步上手

1️⃣  双击安装包,拖入 Applications / 点击安装
2️⃣  选择服务商,输入 API Key
3️⃣  开始对话! 🎉

就这样。不需要装 Node.js,不需要 npm,不需要配置任何环境变量。

🤖 支持的 AI 提供商

  • Anthropic (Claude)
  • OpenAI (GPT / Codex)
  • Google (Gemini)
  • Moonshot (moonshot.cn / moonshot.ai / Kimi Code)
  • 自定义 OpenAI / Anthropic 兼容接口

💡 典型使用场景

  • 🗂️ "帮我抓取某网站前 20 条内容,导出成 Excel"
  • 📊 "整理这批网页信息,输出一份摘要报告"
  • 📝 "按我给的规则批量处理表格和文本"

你负责提需求,OneClaw 负责执行。

🏗️ 架构

OneClaw (Electron)
  ├── 🔧 Gateway 子进程  (内置 Node.js 22 + OpenClaw)
  └── 💬 聊天窗口        (Lit 3 SPA,本地 file:// 加载)

❓ 常见问题

Q: 我完全不会编程,可以用吗? A: 当然可以!OneClaw 就是为非技术用户设计的 😊

Q: 需要自己安装 Node.js 或 Git 吗? A: 不需要。应用已内置所有运行环境。

Q: Setup 之后可以换 Provider 吗? A: 可以。在托盘菜单点「设置」(或 macOS Cmd+,)即可修改。

Q: 飞书频道是什么? A: 你可以把 OneClaw 连接到飞书,让它作为飞书工作区中的聊天机器人工作。


⭐ 觉得有用?给个 Star 吧!

如果 OneClaw 帮到了你,请给个 ⭐ Star 支持一下!你的每一颗 Star 都是我们持续改进的动力 💪❤️

Star History Chart


🇬🇧 English

✨ Why OneClaw?

No Node.js. No npm install. No environment variables. Download → double-click → enter API Key → start chatting. That's it.

OneClaw wraps OpenClaw into a ready-to-use desktop app. It bundles a Node.js runtime and the full OpenClaw Gateway — zero dev tooling required.

Its goal is simple: AI that gets things done, not just chats. 🎯

🚀 Feature Description
One-Minute Install Download → install → enter Key → chat, under 60 seconds
🖥️ Cross-Platform macOS (Apple Silicon / Intel) + Windows (x64 / ARM64)
🔒 Keys Stay Local API keys are stored on your machine, never uploaded anywhere
🤖 Multi-Provider Anthropic / OpenAI / Google / Kimi / Custom endpoints
🔄 Auto-Update Built-in CDN updates, no manual downloads needed
🧠 Session Memory Automatically saves conversation context across sessions
🔍 Kimi Search Integrated web search via Kimi Search
💬 Chat Integrations Built-in Feishu and QQ bot access for chatting with OneClaw from messaging apps
🛡️ Conflict Detection Auto-detects existing OpenClaw installations to avoid port conflicts
🖋️ Terminal Command Auto-installs openclaw command to PATH
🌐 China-Friendly Pre-configured mirror defaults for smoother experience in China

📦 Download

Head to the Releases page and grab the installer for your platform:

Platform Architecture File
🍎 macOS Apple Silicon (M1/M2/M3/M4) OneClaw-x.x.x-arm64.dmg
🍎 macOS Intel OneClaw-x.x.x-x64.dmg
🪟 Windows x64 OneClaw-Setup-x.x.x-x64.exe
🪟 Windows ARM64 OneClaw-Setup-x.x.x-arm64.exe

💡 Quick tip: Apple M-series → arm64, Intel Mac → x64, most Windows PCs → x64.

🚀 Get Started in 3 Steps

1️⃣  Install — drag to Applications / click the installer
2️⃣  Configure — pick a provider, enter your API Key
3️⃣  Chat! 🎉

No Node.js, no npm, no environment setup. Just works.

🤖 Supported AI Providers

  • Anthropic (Claude)
  • OpenAI (GPT / Codex)
  • Google (Gemini)
  • Moonshot (moonshot.cn / moonshot.ai / Kimi Code)
  • Custom OpenAI / Anthropic-compatible API

💡 Typical Use Cases

  • 🗂️ "Scrape the top 20 posts from a website and export to Excel"
  • 📊 "Summarize a batch of webpages into a report"
  • 📝 "Process text and spreadsheets in bulk with my rules"

You define the goal, OneClaw executes.

🏗️ Architecture

OneClaw (Electron)
  ├── 🔧 Gateway subprocess  (bundled Node.js 22 + OpenClaw)
  └── 💬 Chat window         (Lit 3 SPA, loaded via file://)

❓ FAQ

Q: Can I use this if I don't code at all? A: Absolutely! OneClaw is designed for non-technical users 😊

Q: Do I need to install Node.js or Git myself? A: No. The app includes everything it needs.

Q: Can I change the provider after setup? A: Yes. Open Settings from the tray menu (or Cmd+, on macOS) to change anytime.

Q: What is the Feishu channel? A: You can connect OneClaw to Feishu (Lark) so it works as a chat bot in your Feishu workspace.


⭐ Like it? Give us a Star!

If OneClaw saves you time, drop a ⭐ Star — it means a lot and keeps us going! 💪❤️


📄 License

GNU Affero General Public License v3.0 (AGPL-3.0-only).

Commercial use is allowed, but if you modify and distribute this software, or provide a modified version over a network, you must provide the corresponding source code under AGPL v3.

About

OneClaw

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 69.3%
  • JavaScript 17.1%
  • CSS 9.9%
  • HTML 3.6%
  • Other 0.1%