文章总结： OpenClaw是一个开源本地化AI智能体框架，以后台守护进程形式运行，可接入通讯软件并执行自然语言指令。文章详细介绍了在MacOS和Windows系统上的安装流程，包括硬件环境准备、软件要求、文件与权限配置等。还提供了技能安装方法和常见问题排查方案，帮助用户构建完整的本地AI运行环境。 综合评分： 70 文章分类： AI安全,安全工具,安全开发,解决方案,其他

OpenClaw保姆级安装指南

原创

CIO之家 CIO之家

CIO之家

2026年3月10日 07:05 广东

OpenClaw 目标是让 AI 不只是给建议，而是直接完成完整工程任务。OpenClaw因其轻量化与可扩展特性逐渐受到大家关注，且近期的热度居高不下。本文将从环境准备、依赖安装、程序运行与常见问题排查四个层面，提供一套可复现的OpenClaw安装流程，实现智能对话系统的本地部署，构建完整的本地AI运行环境。

1. OpenClaw 是什么？

OpenClaw（曾用名 ClawdBot 或 MoltBot）是一款开源的本地化个人 AI 智能体（Agent）框架。它以一种永远在线的后台守护进程（Daemon）形式运行在你的设备上。

通过极简的内核和代理编程（Agentic Programming）理念，OpenClaw 可以直接接入你常用的通讯软件（如 Telegram、Discord、WhatsApp、Slack 等）并接受自然语言指令。它不仅擅长读写代码、执行 Bash 脚本，还能通过模型驱动自我迭代和编写工具，甚至借助扩展自动操控浏览器完成复杂的工作流。

2. 在 MacOS 安装 OpenClaw

#

硬件环境准备

• 设备类型：Mac（Intel 芯片或 Apple Silicon 芯片均可）。
• 内存建议：基础网关运行需至少 1GB RAM，建议 4GB 及以上以确保稳定的 NPM 构建和扩展运行。

软件要求

• 操作系统：macOS 12.0 或更高版本。
• 核心依赖：Node.js 22.0 或更高版本。
• 模型配置：需要提前准备好 Anthropic Claude、OpenAI 或 OpenRouter 的 API Key。

文件与权限配置

• 系统权限：确保你使用的终端（Terminal / iTerm2）在系统设置中拥有“完全磁盘访问权限”（Full Disk Access）。
• 目录结构：所有配置、密钥和状态均默认存储在 ~/.openclaw 目录下，沙盒工作区位于 ~/openclaw/workspace。

安装步骤

1. 打开终端，安装或更新 Node.js 22（推荐使用 Homebrew）：brew install node@22。
2. 输入 node --version 验证版本是否满足要求。
3. 通过 NPM 全局安装 OpenClaw 最新版：npm install -g openclaw@latest。
4. 运行初始化向导并注册后台守护进程：openclaw onboard --install-daemon。
5. 在交互式向导中，选择你的大模型提供商，粘贴对应的 API Key，并配置你要接入的第一个通讯频道（如 Telegram Bot Token）。
6. 运行 openclaw dashboard，在浏览器中打开 http://127.0.0.1:18789/ 进入可视化的控制面板。

3. 在 Windows 安装 OpenClaw

#

硬件环境准备

• 设备类型：支持虚拟化技术的 64 位 Windows PC。
• 内存建议：建议 8GB 及以上（主要用于为 WSL2 分配充足内存）。

软件要求

• 操作系统：Windows 10 或 Windows 11。强烈建议通过 WSL2（Windows Subsystem for Linux）进行隔离部署，而非直接使用原生 Windows 环境。
• 核心依赖：Node.js 22.0 或更高版本。

文件与权限配置

• 网络安全：Gateway 默认绑定 127.0.0.1:18789。切勿在未经授权的情况下将配置修改为暴露到公网（0.0.0.0），建议结合 Tailscale 或 SSH 隧道进行远程访问。
• 沙盒权限：若在 Docker / WSL 混合环境下遇到权限被拒（EACCES），需在宿主机修正挂载目录权限：sudo chown -R 1000:1000 ~/.openclaw。

安装步骤

1. 以管理员身份打开 PowerShell，运行 wsl --install 安装 WSL2，然后重启电脑。
2. 进入 Ubuntu/WSL 终端，运行环境配置命令：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -。
3. 安装 Node.js：运行 sudo apt-get install -y nodejs。
4. 全局安装 OpenClaw：运行 npm install -g openclaw@latest。
5. 初始化配置服务：执行 openclaw onboard --install-daemon，录入你的 API 密钥与偏好。
6. 验证运行状态：输入 openclaw gateway status 检查后台服务是否成功拉起。

4. 安装常用技能 Skills

OpenClaw 强大的扩展能力来源于它的技能集（Skills）。你可以通过其内置的技能市场 Clawhub 快速赋能 Agent。

安装方法

交互式安装（推荐）：在你接入的聊天软件（如 Telegram）中，直接向 OpenClaw 发送自然语言指令，例如：“Please install a skill for me using Clawhub; its name is mcd.”。Agent 会自行联网拉取、配置并热重载该技能，无需你手动改代码。

手动配置：你可以通过修改 ~/.openclaw/TOOLS.md 和 AGENTS.md 文件来直接注入自定义的能力脚本。

5.常见问题排查

问题1：编译失败 通常由编译器版本不匹配导致，建议更新工具链。

问题2：程序无法启动 重点检查依赖库路径与配置文件格式。

问题3：对话响应缓慢 可降低模型规模或调整推理参数。

通过规范的环境配置与构建流程，OpenClaw能够稳定运行于本地系统之中。

| | | | | — | — | — | | 回复任意关键词获取更多内容 | | |

OpenClaw

| | | | | — | — | — | | 推荐的文章 | | | | Claude Code Skills 完全指南 企业花重金学搞流程，反而被“套死”了？ IT 圈生存图鉴：那些扎心的“潜规则”与神梗 崩崩崩！元宝崩了千问崩！AI角逐哪家强？ 零故障过年！节前IT系统运维全量检查清单 Saas的这条老命，就快续到头了？ 数字化转型，IT与业务如何从互怼到共赢 数字化转型,最大路障居然是IT部? Agent Skills没热几天,Moltbot迎面来袭！ | | |

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：CIO之家 CIO之家 CIO之家《OpenClaw保姆级安装指南》