[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74878":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},74878,"OpenClawInstaller","miaoxworld\u002FOpenClawInstaller","miaoxworld","ClawdBot 一键部署工具","",null,"Shell",3432,469,17,24,0,3,14,30.02,false,"main",true,[24,25,26],"clawdbot","moltbot","openclaw","2026-06-12 02:03:29","# 🦞 OpenClaw 一键部署工具\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVersion-1.0.0-blue.svg\" alt=\"Version\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPlatform-macOS%20%7C%20Linux-green.svg\" alt=\"Platform\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg\" alt=\"License\">\n\u003C\u002Fp>\n\n> 🚀 一键部署你的私人 AI 助手 OpenClaw，支持多平台多模型配置\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"photo\u002Fmenu.png\" alt=\"OpenClaw 配置中心\" width=\"600\">\n\u003C\u002Fp>\n\n## 📖 目录\n\n- [系统要求](#-系统要求)\n- [快速开始](#-快速开始)\n- [功能特性](#-功能特性)\n- [详细配置](#-详细配置)\n- [常用命令](#-常用命令)\n- [配置说明](#-配置说明)\n- [安全建议](#-安全建议)\n- [常见问题](#-常见问题)\n- [更新日志](#-更新日志)\n\n## 💻 系统要求\n\n| 项目 | 要求 |\n|------|------|\n| 操作系统 | macOS 12+ \u002F Ubuntu 20.04+ \u002F Debian 11+ \u002F CentOS 8+ |\n| Node.js | v22 或更高版本 |\n| 内存 | 最低 2GB，推荐 4GB+ |\n| 磁盘空间 | 最低 1GB |\n\n## 🚀 快速开始\n\n### 🖥️ 桌面版 OpenClaw Manager（推荐）\n\n如果你更喜欢图形界面，推荐使用 **OpenClaw Manager** 桌面应用：\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002Fopenclaw-manager\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F下载桌面版-OpenClaw%20Manager-blue?style=for-the-badge&logo=github\" alt=\"Download\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n- 🎨 **现代化 UI** - 基于 Tauri 2.0 + React + TypeScript + Rust 构建\n- 📊 **实时监控** - 仪表盘查看服务状态、内存、运行时间\n- 🔧 **可视化配置** - AI 模型、消息渠道一键配置\n- 💻 **跨平台** - 支持 macOS、Windows、Linux\n\n👉 **下载地址**: [github.com\u002Fmiaoxworld\u002Fopenclaw-manager](https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002Fopenclaw-manager)\n\n---\n\n### 方式一：一键安装（命令行版）\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fmain\u002Finstall.sh | bash\n```\n\n安装脚本会自动：\n1. 检测系统环境并安装依赖\n2. 安装 OpenClaw\n3. 引导完成核心配置（AI模型、身份信息）\n4. 测试 API 连接\n5. **自动启动 OpenClaw 服务**\n6. 可选打开配置菜单进行详细配置（渠道等）\n\n### 方式二：手动安装\n\n```bash\n# 1. 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller.git\ncd OpenClawInstaller\n\n# 2. 添加执行权限\nchmod +x install.sh config-menu.sh\n\n# 3. 运行安装脚本\n.\u002Finstall.sh\n\n#如果mac有权限问题，可以手动安装clawbot之后再运行install\nnpm install -g openclaw\n```\n\n### 安装完成后\n\n安装完成后脚本会：\n1. **自动询问是否启动服务**（推荐选择 Y）\n2. 后台启动 OpenClaw Gateway\n3. 可选打开配置菜单进行渠道配置\n\n如果需要后续管理：\n\n```bash\n# 手动启动服务\nsource ~\u002F.openclaw\u002Fenv && openclaw gateway\n\n# 后台启动服务\nopenclaw gateway start\n\n# 运行配置菜单进行详细配置\nbash ~\u002F.openclaw\u002Fconfig-menu.sh\n\n# 或从 GitHub 下载运行\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fmain\u002Fconfig-menu.sh | bash\n```\n\n## ✨ 功能特性\n\n### 🤖 多模型支持\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"photo\u002Fllm.png\" alt=\"AI 模型配置\" width=\"600\">\n\u003C\u002Fp>\n\n**主流服务商:**\n- **Anthropic Claude** - claude-sonnet-4-5 \u002F claude-opus-4-5 \u002F claude-haiku-4-5 *(支持自定义 API 地址)*\n- **OpenAI GPT** - gpt-4o \u002F gpt-4o-mini \u002F gpt-4-turbo *(支持自定义 API 地址，需支持 v1\u002Fresponses)*\n- **Google Gemini** - gemini-2.0-flash \u002F gemini-1.5-pro \u002F gemini-1.5-flash\n\n**多模型网关:**\n- **OpenRouter** - 多模型网关，一个 Key 用遍所有模型 (claude-sonnet-4 \u002F gpt-4o \u002F gemini-pro-1.5)\n\n**快速推理:**\n- **Groq** - 超快推理，llama-3.3-70b-versatile \u002F llama-3.1-8b-instant \u002F mixtral-8x7b\n- **Mistral AI** - mistral-large-latest \u002F mistral-small-latest \u002F codestral-latest\n\n**本地部署:**\n- **Ollama** - 本地部署，无需 API Key (llama3 \u002F llama3:70b \u002F mistral)\n\n> 💡 **自定义 API 地址**: Anthropic Claude 和 OpenAI GPT 都支持自定义 API 地址，可接入 OneAPI\u002FNewAPI\u002FAPI 代理等服务。配置时先输入自定义地址，再输入 API Key。\n>\n> ⚠️ **OpenAI 中转要求**: 自定义 OpenAI API 地址必须支持 `v1\u002Fresponses` 路径（OpenAI Responses API），不仅仅是传统的 `v1\u002Fchat\u002Fcompletions`。请确认您的中转服务已支持此接口。\n\n### 📱 多渠道接入\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"photo\u002Fsocial.png\" alt=\"消息渠道配置\" width=\"600\">\n\u003C\u002Fp>\n\n- Telegram Bot\n- Discord Bot\n- WhatsApp\n- Slack\n- 微信 (WeChat)\n- iMessage (仅 macOS)\n- 飞书 (Feishu)\n\n### 🧪 快速测试\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"photo\u002Fmessages.png\" alt=\"快速测试\" width=\"600\">\n\u003C\u002Fp>\n\n- API 连接测试\n- 渠道连接验证\n- OpenClaw 诊断工具\n\n### 🧠 核心能力\n- **持久记忆** - 跨对话、跨平台的长期记忆\n- **主动推送** - 定时提醒、晨报、告警通知\n- **技能系统** - 通过 Markdown 文件定义自定义能力\n- **远程控制** - 可执行系统命令、读写文件、浏览网络\n\n## ⚙️ 详细配置\n\n### 配置 AI 模型\n\n运行配置菜单后选择 `[2] AI 模型配置`，可选择多种 AI 提供商：\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"photo\u002Fllm.png\" alt=\"AI 模型配置界面\" width=\"600\">\n\u003C\u002Fp>\n\n#### Anthropic Claude 配置\n\n1. 在配置菜单中选择 Anthropic Claude\n2. **先输入自定义 API 地址**（留空使用官方 API）\n3. 输入 API Key（官方 Key 从 [Anthropic Console](https:\u002F\u002Fconsole.anthropic.com\u002F) 获取）\n4. 选择模型（推荐 claude-sonnet-4-5-20250929）\n\n> 💡 支持 OneAPI\u002FNewAPI 等第三方代理服务，只需填入对应的 API 地址和 Key\n\n#### OpenAI GPT 配置\n\n1. 在配置菜单中选择 OpenAI GPT\n2. **先输入自定义 API 地址**（留空使用官方 API）\n3. 输入 API Key（官方 Key 从 [OpenAI Platform](https:\u002F\u002Fplatform.openai.com\u002F) 获取）\n4. 选择模型\n\n> ⚠️ **中转服务要求**: 如使用自定义 API 地址，中转服务必须支持 OpenAI 的 **Responses API** (`v1\u002Fresponses` 路径)，而非仅支持传统的 Chat Completions API (`v1\u002Fchat\u002Fcompletions`)。部分老旧或功能不全的中转服务可能不支持此接口，请提前确认。\n\n> 💡 **其他模型**: 配置菜单还支持 Google Gemini、OpenRouter、Groq、Mistral AI、Ollama 等，按菜单提示操作即可。\n\n### 配置 Telegram 机器人\n\n1. 在 Telegram 中搜索 `@BotFather`\n2. 发送 `\u002Fnewbot` 创建新机器人\n3. 设置机器人名称和用户名\n4. 复制获得的 **Bot Token**\n5. 搜索 `@userinfobot` 获取你的 **User ID**\n6. 在配置菜单中选择 Telegram，输入以上信息\n\n### 配置 Discord 机器人\n\n**第一步：创建 Discord 应用和机器人**\n\n1. 访问 [Discord Developer Portal](https:\u002F\u002Fdiscord.com\u002Fdevelopers\u002Fapplications)\n2. 点击 \"New Application\" 创建新应用\n3. 进入应用后，点击左侧 \"Bot\" 菜单\n4. 点击 \"Reset Token\" 生成并复制 **Bot Token**\n5. ⚠️ **开启 \"Message Content Intent\"**（重要！否则无法读取消息内容）\n\n**第二步：邀请机器人到服务器**\n\n1. 点击左侧 \"OAuth2\" → \"URL Generator\"\n2. Scopes 勾选：`bot`\n3. Bot Permissions 至少勾选：\n   - View Channels（查看频道）\n   - Send Messages（发送消息）\n   - Read Message History（读取消息历史）\n4. 复制生成的 URL，在浏览器打开并选择服务器\n5. 确保机器人在目标频道有权限\n\n**第三步：获取频道 ID**\n\n1. 打开 Discord 客户端，进入 \"用户设置\" → \"高级\"\n2. 开启 \"开发者模式\"\n3. 右键点击你想让机器人响应的频道\n4. 点击 \"复制频道 ID\"\n\n**第四步：在配置菜单中配置**\n\n在配置菜单中选择 Discord，输入 Bot Token 和 Channel ID\n\n### 配置飞书机器人\n\n> 📖 **详细文档**: 查看 [飞书机器人配置指南](docs\u002Ffeishu-setup.md) 获取完整的配置说明和常见问题解答。\n\n> 💡 **无需公网服务器**：OpenClaw 使用飞书的 WebSocket 长连接模式接收事件，无需配置 Webhook 地址。\n\n1. 访问 [飞书开放平台](https:\u002F\u002Fopen.feishu.cn\u002F)\n2. 创建企业自建应用（个人账号即可，无需企业认证）\n3. **添加机器人能力**：\n   - 进入路径：开发者后台 → 应用详情 → 添加应用能力\n   - 确认：确保\"机器人\"开关是打开状态\n4. 获取 **App ID** 和 **App Secret**\n5. 在\"权限管理\"中添加权限：\n   - `im:message` (收发消息)\n   - `im:message:send_as_bot` (发送消息)\n   - `im:chat:readonly` (读取会话信息)\n6. 发布应用：版本管理与发布 → 创建版本 → 发布\n7. **在配置菜单中配置飞书**：输入 App ID 和 App Secret，启动 OpenClaw 服务\n8. 配置\"事件订阅\"（使用长连接）：\n   - 进入：事件与回调 → 选择「**使用长连接接收事件**」\n   - 添加事件：`im.message.receive_v1`（接收消息）\n   - **无需填写 Webhook 地址**\n   - ⚠️ **注意**：需要 OpenClaw 服务已启动，才能保存长连接设置\n9. 添加机器人到群组：群设置 → 群机器人 → 添加机器人\n\n### 配置 WhatsApp\n\n> 💡 **无需 Business API**：OpenClaw 通过扫码登录你的 WhatsApp 账号，无需申请 Business API。\n\n1. 在配置菜单中选择 `[3] 消息渠道配置` → `[3] WhatsApp`\n2. 系统会自动启用 WhatsApp 插件\n3. 扫描终端显示的二维码完成登录\n4. 登录成功后重启 Gateway 使配置生效\n5. **测试**：用自己的 WhatsApp 给自己发消息即可触发机器人回复\n\n> ⚠️ **注意**：WhatsApp 账号只能在一个设备上登录 Web 版，配置后原有的 WhatsApp Web 会被踢下线。\n\n## 📝 常用命令\n\n### 服务管理\n\n```bash\n# 启动服务（后台守护进程）\nopenclaw gateway start\n\n# 停止服务\nopenclaw gateway stop\n\n# 重启服务\nopenclaw gateway restart\n\n# 查看服务状态\nopenclaw gateway status\n\n# 前台运行（用于调试）\nopenclaw gateway\n\n# 查看日志\nopenclaw logs\n\n# 实时日志\nopenclaw logs --follow\n```\n\n### 配置管理\n\n```bash\n# 打开配置文件\nopenclaw config\n\n# 运行配置向导\nopenclaw onboard\n\n# 诊断配置问题\nopenclaw doctor\n\n# 健康检查\nopenclaw health\n```\n\n### 数据管理\n\n```bash\n# 导出对话历史\nopenclaw export --format json\n\n# 清理记忆\nopenclaw memory clear\n\n# 备份数据\nopenclaw backup\n```\n\n## 📋 配置说明\n\nOpenClaw 使用以下配置方式：\n\n- **环境变量**: `~\u002F.openclaw\u002Fenv` - 存储 API Key 和 Base URL\n- **OpenClaw 配置**: `~\u002F.openclaw\u002Fopenclaw.json` - OpenClaw 内部配置（自动管理）\n- **命令行工具**: `openclaw config set` \u002F `openclaw models set` 等\n\n> 💡 **注意**：配置主要通过安装向导或 `config-menu.sh` 完成，无需手动编辑配置文件\n\n### 环境变量配置示例\n\n`~\u002F.openclaw\u002Fenv` 文件内容：\n\n```bash\n# OpenClaw 环境变量配置\nexport ANTHROPIC_API_KEY=sk-ant-xxxxx\nexport ANTHROPIC_BASE_URL=https:\u002F\u002Fyour-api-proxy.com  # 可选，自定义 API 地址\n\n# 或者 OpenAI\nexport OPENAI_API_KEY=sk-xxxxx\nexport OPENAI_BASE_URL=https:\u002F\u002Fyour-api-proxy.com\u002Fv1  # 可选\n```\n\n### 自定义 Provider 配置\n\n当使用自定义 API 地址时，安装脚本会自动在 `~\u002F.openclaw\u002Fopenclaw.json` 中配置自定义 Provider：\n\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic-custom\": {\n        \"baseUrl\": \"https:\u002F\u002Fyour-api-proxy.com\",\n        \"apiKey\": \"your-api-key\",\n        \"models\": [\n          {\n            \"id\": \"claude-sonnet-4-5-20250929\",\n            \"name\": \"claude-sonnet-4-5-20250929\",\n            \"api\": \"anthropic-messages\",\n            \"input\": [\"text\"],\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n### 目录结构\n\n```\n~\u002F.openclaw\u002F\n├── openclaw.json        # OpenClaw 核心配置\n├── env                  # 环境变量 (API Key 等)\n├── backups\u002F             # 配置备份\n└── logs\u002F                # 日志文件 (由 OpenClaw 管理)\n```\n\n## 🛡️ 安全建议\n\n> ⚠️ **重要警告**：OpenClaw 需要完全的计算机权限，请务必注意安全！\n\n### 部署建议\n\n1. **不要在主工作电脑上部署** - 建议使用专用服务器或虚拟机\n2. **使用 AWS\u002FGCP\u002FAzure 免费实例** - 隔离环境更安全\n3. **Docker 部署** - 提供额外的隔离层\n\n### 权限控制\n\n1. **禁用危险功能**（默认已禁用）\n   ```yaml\n   security:\n     enable_shell_commands: false\n     enable_file_access: false\n   ```\n\n2. **启用沙箱模式**\n   ```yaml\n   security:\n     sandbox_mode: true\n   ```\n\n3. **限制允许的用户**\n   ```yaml\n   channels:\n     telegram:\n       allowed_users:\n         - \"only-your-user-id\"\n   ```\n\n### API Key 安全\n\n- 定期轮换 API Key\n- 不要在公开仓库中提交配置文件\n- 使用环境变量存储敏感信息\n\n```bash\n# 使用环境变量\nexport ANTHROPIC_API_KEY=\"sk-ant-xxx\"\nexport TELEGRAM_BOT_TOKEN=\"xxx\"\n```\n\n## ❓ 常见问题\n\n### Q: 安装时提示 Node.js 版本过低？\n\n```bash\n# macOS\nbrew install node@22\nbrew link --overwrite node@22\n\n# Ubuntu\u002FDebian\ncurl -fsSL https:\u002F\u002Fdeb.nodesource.com\u002Fsetup_22.x | sudo -E bash -\nsudo apt-get install -y nodejs\n```\n\n### Q: 启动后无法连接？\n\n1. 检查配置文件是否正确\n2. 运行诊断命令：`openclaw doctor`\n3. 查看日志：`openclaw logs`\n\n### Q: Telegram 机器人没有响应？\n\n1. 确认 Bot Token 正确\n2. 确认 User ID 在 allowed_users 列表中\n3. 检查网络连接（可能需要代理）\n\n### Q: 如何更新到最新版本？\n\n```bash\n# 使用 npm 更新\nnpm update -g openclaw\n\n# 或使用配置菜单\n.\u002Fconfig-menu.sh\n# 选择 [7] 高级设置 → [7] 更新 OpenClaw\n```\n\n### Q: 如何备份数据？\n\n```bash\n# 手动备份\ncp -r ~\u002F.openclaw ~\u002Fopenclaw_backup_$(date +%Y%m%d)\n\n# 使用命令备份\nopenclaw backup\n```\n\n### Q: 如何完全卸载？\n\n```bash\n# 停止服务\nopenclaw gateway stop\n\n# 卸载程序\nnpm uninstall -g openclaw\n\n# 删除配置（可选）\nrm -rf ~\u002F.openclaw\n```\n\n## 📜 更新日志\n\n### v1.0.0 (2026-01-29)\n- 🎉 首次发布\n- ✨ 支持一键安装部署\n- ✨ 交互式配置菜单\n- ✨ 多模型支持 (Claude\u002FGPT\u002FOllama)\n- ✨ 多渠道支持 (Telegram\u002FDiscord\u002FWhatsApp)\n- ✨ 技能系统\n- ✨ 安全配置\n\n## 📄 许可证\n\n本项目基于 MIT 许可证开源。\n\n## 🔗 相关链接\n\n- [OpenClaw 官网](https:\u002F\u002Fclawd.bot)\n- [官方文档](https:\u002F\u002Fclawd.bot\u002Fdocs)\n- [🖥️ OpenClaw Manager 桌面版](https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002Fopenclaw-manager) - 图形界面管理工具\n- [安装工具仓库](https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller) - 命令行版本\n- [OpenClaw 主仓库](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw)\n- [社区讨论](https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fdiscussions)\n\n---\n\n\u003Cp align=\"center\">\n  Made with ❤️ by \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmiaoxworld\">miaoxworld\u003C\u002Fa>\n\u003C\u002Fp>\n","OpenClawInstaller 是一个用于一键部署 ClawdBot 的工具。它通过 Shell 脚本实现自动化安装，支持多平台（macOS 12+、Ubuntu 20.04+、Debian 11+ 和 CentOS 8+），并且能够自动检测系统环境、安装依赖项以及引导完成核心配置。该工具还提供了图形界面版本 OpenClaw Manager，基于 Tauri 2.0 + React + TypeScript + Rust 构建，具有现代化 UI 和实时监控功能。此外，OpenClaw 支持多种 AI 模型，包括 Anthropic Claude、OpenAI GPT 和 Google Gemini 等，并且可以通过 OpenRouter 多模型网关使用单一 API Key 访问多个模型。适合需要快速搭建和管理个人 AI 助手的开发者或用户在桌面端或命令行环境下使用。",2,"2026-06-11 03:51:15","high_star"]