如何部署 OpenClaw：一键式 AI 助手安装

部署 OpenClaw – 终极一键 AI 助手指南\n\nOpenAI、Anthropic、Google Gemini、Groq、Mistral、Ollama 等主流 LLM 现在都能通过同一个轻量化网关与你沟通。OpenClaw 是一个基于 MIT 许可的开源项目，整合了网关、丰富的命令行界面以及可选的基于 Tauri 的桌面管理器。GitHub 上的 OpenClawInstaller 仓库提供了一个可直接运行的脚本，自动检测操作系统、安装依赖、拉取最新 OpenClaw 可执行文件、配置你喜欢的模型和聊天通道，随后启动服务。\n\n### 为什么选择 OpenClaw？\n\n* 一键在 macOS、Linux，甚至通过 WSL 在 Windows 上安装 CLI\n* Plug‑and‑play 支持 Telegram、Discord、WhatsApp、WeChat、Slack、Feishu、iMessage —— 免后端代码\n* 支持几乎任何主流 LLM，可在本地使用 Ollama 或通过 API，同时支持自定义代理\n* 持久长期记忆、定时任务、远程命令执行以及基于 Markdown 的技巧扩展\n* Docker 友好，可将网关打包至容器，便于隔离与扩展\n\n下面是从前置条件到高级配置的逐步指导。\n\n---\n\n## 1. 前置条件\n\n| 要求 | 最低 | 推荐 |

|------|------|------| | 操作系统 | macOS 12+、Ubuntu 20.04、Debian 11、CentOS 8 | — | | Node.js | v22+ | — | | RAM | 2 GB | 4 GB+ | | 磁盘空间 | 1 GB | — | | 网络 | HTTPS/HTTP | — | \n提示：如果使用托管云实例，建议选择 2‑CPU、4 GB RAM 的 VM。Docker 约占 500 MB 额外空间。\n\n## 2. 一键式命令行安装\n\nbash\ncurl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash\n\n\n脚本将：\n1. 检测操作系统并安装所需软件包（Node、Docker 如有需要）。\n2. 下载最新 OpenClaw 版本的预编译二进制文件。\n3. 通过 config‑menu.sh 向导引导你完成：\n * 选择 LLM 提供商与模型\n * 提供 API 密钥或选择本地模型（Ollama）\n * 配置消息通道\n4. 可选地将网关作为后台服务启动。\n\n安全提示：如果在 macOS 上遇到权限错误，尝试使用 sudo 或授予终端完整磁盘访问权限。\n\n## 3. 手动克隆 & 设置\n\n如果你想查看源码或使用自定义 Docker Compose，按以下命令操作：\n\nbash\n# 克隆仓库\ngit clone https://github.com/miaoxworld/OpenClawInstaller.git\ncd OpenClawInstaller\n\n# 使脚本可执行\nchmod +x install.sh config-menu.sh\n\n# 运行安装程序\n./install.sh\n\n\n可选的 Docker 部署：\n\nbash\ndocker compose up -d\n\n\nDocker 镜像会拉取 openclaw 二进制并暴露 8000 端口给网关 API。\n\n## 4. 快速启动配置\n\n安装完成后，安装程序通常会询问是否立即启动网关。如果你选择是，你会看到状态页：openclaw gateway status。如果选择否，请手动启动：\n\nbash\n# 前台调试\nopenclaw gateway\n\n# 或作为守护进程\nopenclaw gateway start\n\n\n### 配置消息渠道\n\nOpenClaw 的向导（config‑menu.sh）在 消息通道 下暴露了一个菜单：\n\n| 通道 | 设置步骤 | |------|--------| | Telegram | 通过 @BotFather 创建机器人，复制 token，使用 @userinfobot 获取用户 ID；在 OpenClaw 中输入 token 与 ID | | Discord | 创建机器人，启用 Message Content Intent，邀请机器人到服务器；复制 token 与频道 ID | | WhatsApp | 在终端扫描二维码——无需企业 API | | WeChat / iMessage | 使用 macOS Tauri 应用或在终端中操作 | | Slack / Feishu | 提供应用 token 或密钥 | \n配置完成后，重启网关：\n\nbash\nopenclaw gateway restart\n\n\n## 5. 高级设置\n\nOpenClaw 的全局配置保存在 ~/.openclaw/openclaw.json 与 .openclaw/env。大多数用户无需手动修改，但如果需要微调：\n\n- 自定义 LLM 端点：对于 Anthropic 或 OpenAI 代理，设置 ANALPHA_BASE_URL 与 OPENAI_BASE_URL。脚本随后会在 JSON 中添加 custom 提供商。\n- 内存与文件访问：默认 enable_shell_commands 与 enable_file_access 为 false。可在 security 节中开启，允许助手执行 shell 命令或读写文件。\n- 沙箱模式：设置 sandbox_mode: true 将所有外部调用限制在安全环境内。\n\n使用命令行工具调整：\n\nbash\nopenclaw config set security.enable_shell_commands true\nopenclaw config set sandbox_mode true\n\n\n## 6. 数据管理 & 备份\n\nbash\n# 导出聊天历史至 JSON\nopenclaw export --format json > conversations.json\n\n# 清除长期记忆\nopenclaw memory clear\n\n# 备份整个配置与日志\nopenclaw backup\n\n\n备份存放在 ~/.openclaw/backups/。你亦可将此目录纳入版本控制，构建审计追踪。\n\n## 7. 卸载\n\n若需清理：\n\nbash\n# 停止服务\nopenclaw gateway stop\n\n# 移除全局 npm 包\nnpm uninstall -g openclaw\n\n# 删除配置文件\nrm -rf ~/.openclaw\n\n\n## 8. 故障排除清单\n\n| 症状 | 可能原因 | 解决方案 | |------|-----------|----------| | Node.js 过旧 | node -v < 22 | 通过 nvm 或系统包管理器安装 Node 22 | | 网关无法连接 API | API 密钥错误或自定义基础 URL 错误 | 核实密钥与 URL；执行 openclaw doctor | | 聊天机器人无声 | Bot token 错误或未授权 | 重新运行通道配置，确保机器人已加入服务器 | | Docker 容器崩溃 | 资源限制过低 | 分配更多 RAM 或使用 -m 限制 | | 安装时出现 “Permission denied” | macOS Gatekeeper | 为终端授予完整磁盘访问或使用 sudo | \n---\n\n## 9. 总结\n\nOpenClawInstaller 可将裸机或启用 Docker 的 VM 变成功能齐全的 AI 助手，仅需短短几分钟。凭借一键安装、向导式配置以及对几乎所有 LLM 与通道的支持，你即可取代外部机器人平台，完全掌控数据与性能。\n\n下一步 – 试用 OpenClaw Manager 桌面应用提供 GUI 视图，或深入 OpenClaw 技能系统，在 ~/.openclaw/skills/ 中添加自定义 Markdown 文件。\n\n祝你玩得开心，享受属于自己的 AI 助手！