[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-miaoxworld--OpenClawInstaller":3,"tool-miaoxworld--OpenClawInstaller":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",145895,2,"2026-04-08T11:32:59",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":74,"owner_company":74,"owner_location":74,"owner_email":74,"owner_twitter":74,"owner_website":74,"owner_url":76,"languages":77,"stars":86,"forks":87,"last_commit_at":88,"license":74,"difficulty_score":32,"env_os":89,"env_gpu":90,"env_ram":91,"env_deps":92,"category_tags":101,"github_topics":102,"view_count":32,"oss_zip_url":74,"oss_zip_packed_at":74,"status":17,"created_at":105,"updated_at":106,"faqs":107,"releases":138},5531,"miaoxworld\u002FOpenClawInstaller","OpenClawInstaller","ClawdBot 一键部署工具","OpenClawInstaller 是专为 ClawdBot 私人 AI 助手打造的一键部署工具，旨在让用户在 macOS 或 Linux 系统上轻松搭建属于自己的智能助理。它解决了传统 AI 服务部署流程繁琐、环境配置复杂以及多模型切换困难的问题，通过自动化脚本自动检测依赖、安装核心组件并引导完成关键配置，极大降低了技术门槛。\n\n这款工具非常适合希望拥有个性化 AI 助手的普通用户、开发者及技术研究者。无论是想通过 Telegram、微信或 Discord 等渠道接入智能对话，还是需要整合 Claude、GPT-4、Gemini 等多种大模型能力，OpenClawInstaller 都能提供直观的配置菜单和图形化管理界面（OpenClaw Manager）来辅助操作。\n\n其技术亮点在于强大的多模型网关支持，允许用户通过自定义 API 地址灵活接入各类中转服务，并具备持久记忆、主动消息推送及基于 Markdown 的技能扩展系统。此外，它还支持本地 Ollama 部署，确保在无网络或隐私敏感场景下也能稳定运行。只需一条命令，即可启动包含实时监控与诊断功能的完整 AI 服务，让私有化大模","OpenClawInstaller 是专为 ClawdBot 私人 AI 助手打造的一键部署工具，旨在让用户在 macOS 或 Linux 系统上轻松搭建属于自己的智能助理。它解决了传统 AI 服务部署流程繁琐、环境配置复杂以及多模型切换困难的问题，通过自动化脚本自动检测依赖、安装核心组件并引导完成关键配置，极大降低了技术门槛。\n\n这款工具非常适合希望拥有个性化 AI 助手的普通用户、开发者及技术研究者。无论是想通过 Telegram、微信或 Discord 等渠道接入智能对话，还是需要整合 Claude、GPT-4、Gemini 等多种大模型能力，OpenClawInstaller 都能提供直观的配置菜单和图形化管理界面（OpenClaw Manager）来辅助操作。\n\n其技术亮点在于强大的多模型网关支持，允许用户通过自定义 API 地址灵活接入各类中转服务，并具备持久记忆、主动消息推送及基于 Markdown 的技能扩展系统。此外，它还支持本地 Ollama 部署，确保在无网络或隐私敏感场景下也能稳定运行。只需一条命令，即可启动包含实时监控与诊断功能的完整 AI 服务，让私有化大模型应用变得简单高效。","# 🦞 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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_fc27de1b5d28.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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_c0af58b98b84.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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_be23ec4ff30e.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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_a06237e97b95.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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_c0af58b98b84.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","# 🦞 OpenClaw 一键部署工具\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVersion-1.0.0-blue.svg\" alt=\"版本\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPlatform-macOS%20%7C%20Linux-green.svg\" alt=\"平台\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg\" alt=\"许可证\">\n\u003C\u002Fp>\n\n> 🚀 一键部署你的私人 AI 助手 OpenClaw，支持多平台多模型配置\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_fc27de1b5d28.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=\"下载\">\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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_c0af58b98b84.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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_be23ec4ff30e.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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_a06237e97b95.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=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_readme_c0af58b98b84.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>","# OpenClaw 快速上手指南\n\nOpenClaw 是一款支持多模型、多渠道接入的私人 AI 助手部署工具。本指南将帮助你在几分钟内完成环境准备、安装及基础配置。\n\n## 1. 环境准备\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如果尚未安装 Node.js v22，请使用以下命令安装：\n\n**macOS:**\n```bash\nbrew install node@22\nbrew link --overwrite node@22\n```\n\n**Ubuntu\u002FDebian:**\n```bash\ncurl -fsSL https:\u002F\u002Fdeb.nodesource.com\u002Fsetup_22.x | sudo -E bash -\nsudo apt-get install -y nodejs\n```\n\n## 2. 安装步骤\n\n你可以选择**一键脚本安装**（推荐）或**手动安装**。\n\n### 方式一：一键安装（推荐）\n运行以下命令，脚本将自动检测环境、安装依赖、部署 OpenClaw 并引导核心配置：\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fmain\u002Finstall.sh | bash\n```\n\n安装过程中脚本会：\n1. 自动安装所需依赖。\n2. 引导你输入 AI 模型 API Key 和身份信息。\n3. 测试 API 连接。\n4. **自动启动服务**。\n\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# 注：若 macOS 遇到权限问题，可先手动安装核心包\nnpm install -g openclaw\n```\n\n## 3. 基本使用\n\n安装完成后，服务通常会自动启动。以下是日常管理和配置的核心操作。\n\n### 启动与管理服务\n```bash\n# 后台启动服务\nopenclaw gateway start\n\n# 查看服务状态\nopenclaw gateway status\n\n# 查看实时日志（调试用）\nopenclaw logs --follow\n\n# 停止服务\nopenclaw gateway stop\n```\n\n### 配置 AI 模型与消息渠道\n运行交互式配置菜单进行可视化设置：\n\n```bash\nbash ~\u002F.openclaw\u002Fconfig-menu.sh\n# 或者直接从网络运行\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fmain\u002Fconfig-menu.sh | bash\n```\n\n**配置流程示例：**\n1. 在菜单中选择 `[2] AI 模型配置`。\n   - 选择提供商（如 Anthropic Claude, OpenAI GPT, Ollama 等）。\n   - 输入 API Key（若使用国内中转服务，可先输入自定义 API 地址）。\n   - *注意：若使用自定义 OpenAI 地址，需确保支持 `v1\u002Fresponses` 接口。*\n2. 在菜单中选择 `[3] 消息渠道配置`。\n   - 根据提示填入 Telegram Token、Discord Token 或扫描 WhatsApp 二维码。\n3. 配置完成后重启服务使配置生效：\n   ```bash\n   openclaw gateway restart\n   ```\n\n### 验证运行\n配置完成后，直接在已绑定的聊天软件（如 Telegram）中发送消息，即可与你的私人 AI 助手互动。\n\n> 💡 **提示**：对于图形界面爱好者，也可下载 [OpenClaw Manager 桌面版](https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002Fopenclaw-manager) 进行可视化的监控与配置。","某独立开发者希望在个人 macOS 笔记本上快速搭建一个能同时响应 Telegram 消息和飞书告警的私人 AI 助手，以便在外出时远程监控系统状态。\n\n### 没有 OpenClawInstaller 时\n- **环境配置繁琐**：需手动安装 Node.js v22、配置全局权限及依赖库，极易因版本不兼容导致报错，耗时数小时。\n- **多模型接入困难**：想要切换 Claude 3.5 或本地 Ollama 模型，需分别查阅不同厂商的 API 文档并编写复杂的适配代码。\n- **渠道集成割裂**：连接 Telegram 和飞书需要单独编写 Bot 对接逻辑，缺乏统一的身份记忆管理，导致对话上下文断裂。\n- **部署维护高风险**：手动启动服务容易遗漏环境变量配置，一旦终端关闭服务即停止，无法实现稳定的后台常驻运行。\n\n### 使用 OpenClawInstaller 后\n- **一键自动就绪**：运行单行命令即可自动检测系统、安装依赖并完成核心配置，5 分钟内完成从零基础到服务启动。\n- **可视化模型切换**：通过内置配置菜单可直观选择 Anthropic、OpenAI 或本地模型，支持自定义 API 地址，无缝切换推理引擎。\n- **全渠道统一纳管**：在图形化界面中一次性配置 Telegram 和飞书机器人，自动同步“持久记忆”，确保跨平台对话连贯一致。\n- **稳定后台守护**：安装脚本自动将 OpenClaw Gateway 注册为后台服务，无需担心进程意外终止，开箱即用且易于监控。\n\nOpenClawInstaller 将原本需要半天的高门槛全栈开发工作，简化为一次简单的命令行操作，让开发者能立即专注于 AI 助手的能力构建而非底层运维。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmiaoxworld_OpenClawInstaller_c0af58b9.png","miaoxworld",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fmiaoxworld_6e1e0935.png","https:\u002F\u002Fgithub.com\u002Fmiaoxworld",[78,82],{"name":79,"color":80,"percentage":81},"Shell","#89e051",99.6,{"name":83,"color":84,"percentage":85},"Dockerfile","#384d54",0.4,3332,465,"2026-04-08T02:33:26","macOS, Linux","未说明","最低 2GB，推荐 4GB+",{"notes":93,"python":90,"dependencies":94},"1. 该工具主要基于 Node.js 运行，需安装 v22 或更高版本，无需 Python 环境。\n2. 支持 macOS 12+、Ubuntu 20.04+、Debian 11+、CentOS 8+，README 中桌面版提及支持 Windows，但命令行安装脚本主要针对 Unix-like 系统。\n3. 若使用本地模型（如 Ollama），需额外满足对应模型的硬件要求。\n4. 配置 OpenAI 自定义中转地址时，必须支持 v1\u002Fresponses 接口。\n5. WhatsApp 渠道通过扫码登录，会踢掉原设备的 WhatsApp Web 会话。",[95,96,97,98,99,100],"Node.js v22+","openclaw (npm 包)","Tauri 2.0 (桌面版可选)","React (桌面版可选)","TypeScript (桌面版可选)","Rust (桌面版可选)",[35,13,52],[103,104,6],"clawdbot","moltbot","2026-03-27T02:49:30.150509","2026-04-08T21:10:47.227731",[108,113,118,123,128,133],{"id":109,"question_zh":110,"answer_zh":111,"source_url":112},25108,"Gemini 模型不支持第三方 API 或中转站吗？","默认情况下可能不支持 newapi 的 Gemini 格式请求。如果使用中转发报错（如 Invalid input），请尝试在配置中选择 'openai' 格式。此外，确保你的中转站服务支持相应的 response 格式。","https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fissues\u002F1",{"id":114,"question_zh":115,"answer_zh":116,"source_url":117},25109,"安装飞书插件时提示 'package.json missing clawdbot.extensions' 且卡住怎么办？","自动安装失败后，系统通常会尝试手动安装，但可能需要等待一段时间。如果一直卡住或配置无法写入，请参考官方更新的飞书说明文档进行手动配置。","https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fissues\u002F4",{"id":119,"question_zh":120,"answer_zh":121,"source_url":122},25110,"不小心关闭了配置中心菜单，如何重新打开？","可以通过运行以下脚本命令重新调出配置菜单：\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fmain\u002Fconfig-menu.sh | bash","https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fissues\u002F10",{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},25111,"项目是否支持 QQ 渠道？","目前不支持。维护者明确表示 QQ 不提供相关渠道接口。","https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fissues\u002F6",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},25112,"执行安装脚本时出现 404 错误怎么办？","这通常是因为项目名称变更导致的链接失效（原 ClawdBot 已更名为 OpenClaw）。请确保使用最新的安装地址，或者将仓库名改为 'OpenClawInstaller' 再次尝试。维护者已更新相关资源链接。","https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fissues\u002F9",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},25113,"部署后的界面是中文版还是英文版？","根据社区讨论，项目原名已从 ClawdBot 更改为 OpenClaw。关于语言版本，通常取决于初始配置或环境变量，建议在配置菜单中查看语言设置选项，或关注官方后续关于多语言支持的更新。","https:\u002F\u002Fgithub.com\u002Fmiaoxworld\u002FOpenClawInstaller\u002Fissues\u002F3",[]]