OpenClaw 是一款强大的 AI 助手工具，支持本地部署、多模型接入（含 GLM-4.6、Claude 等），可实现代码辅助、自动化工作流等核心能力。本文整理零基础友好、全平台兼容、可直接复制发布的安装指南，包含一键安装、手动安装、Docker 部署、GLM-4.6 模型配置及常见问题排查，新手也能 10 分钟快速上手。
OpenClaw 基于 Node.js 开发，必须先安装 Node.js v20+（推荐 v22 LTS 版本），步骤如下：
（1）安装 Node.js（全平台）
- macOS：
- Linux（Ubuntu/Debian）：
- Windows（WSL2）：
（2）验证安装
终端执行以下命令，输出版本号即成功（Node.js 版本需 ≥v20.0.0）：
（3）可选依赖（提升兼容性）
- Git：用于源码安装 / 工具更新，推荐安装：
- pnpm：替代 npm，安装速度更快、磁盘占用更小：
自动检测系统环境、安装缺失依赖（如 Node.js）、全局部署 OpenClaw 并启动配置向导，全程无需手动干预，适合零基础用户：
（1）macOS/Linux/WSL2
终端执行以下命令：
（2）Windows（PowerShell 管理员权限）
打开「管理员模式 PowerShell」，执行：
（3）跳过配置向导（仅安装 CLI，高级用户）
（1）全局安装 OpenClaw
（2）验证安装
适合服务器部署、多环境隔离场景，无需手动安装 Node.js，步骤如下：
（1）安装 Docker Desktop
官网下载：https://www.docker.com/products/docker-desktop/，安装后启动 Docker 服务（需等待服务初始化完成）。
（2）拉取并启动 OpenClaw 容器
（3）进入容器执行配置
适合二次开发、定制功能场景，步骤如下：
安装完成后，必须执行初始化向导，完成模型接入、网关配置、后台服务部署，步骤如下：
- 选择网关类型：新手推荐「Local Gateway（本地网关）」，无需额外服务器；
- 选择 AI 模型提供商：
- 接入 GLM-4.6：选择「Custom/Other」（自定义模型）；
- 接入 Claude：选择「Anthropic」，直接输入 Claude API Key；
- 配置 GLM-4.6（重点步骤）：
- 输入智谱 AI API Key（从 智谱开放平台 获取：注册→登录→API 密钥管理→创建密钥）；
- 输入 Base URL：；
- 输入模型名称：（区分大小写，不可修改）；
- 配置聊天平台（可选）：可连接 Telegram、Discord 等，新手可直接跳过；
- 安装后台守护进程：
- macOS：自动配置 launchd，支持开机自启；
- Linux/WSL2：自动配置 systemd，支持开机自启；
- Windows：自动配置系统服务，后台运行。
后续修改配置、查看日志可访问以下路径：
- 主配置目录：（Linux/macOS/WSL2）、（Windows）；
- 模型认证配置：；
- 日志文件：。
服务启动后，终端会显示 Web 控制台地址（默认：），浏览器打开后：
- 进入「模型测试」页面；
- 输入测试指令：；
- 收到包含「GLM-4.6」关键词的回复，即表示安装 + 配置成功。
在 VS Code 中直接调用 GLM-4.6 辅助开发，步骤如下：
- 打开 VS Code → 扩展面板（Ctrl+Shift+X）；
- 搜索「OpenClaw」→ 安装官方插件（Anthropic 认证）；
- 插件会自动读取 目录下的配置，无需额外设置；
- 使用方式：右键代码 → 选择「OpenClaw：代码解释 / 重构 / 补全」，或使用快捷键 调用命令。
- Linux/macOS：命令前添加 （如 ）；
- Windows：必须以「管理员身份」打开 PowerShell 执行安装脚本；
- npm 权限报错：执行 （Linux/macOS）修复权限。
- 检查 API Key：是否正确、未过期、有 GLM-4.6 调用权限；
- 确认 Base URL：必须为 （不可多斜杠 / 少斜杠）；
- 模型名称：严格为 （区分大小写）；
- 重启服务： 使配置生效。
- 查看端口占用：
- 杀死占用进程：（Linux/macOS），或在任务管理器结束对应进程（Windows）；
- 修改端口：编辑 ，修改 字段为其他端口（如 3001），重启服务。
- 删除旧配置目录，重新初始化：
- 重启终端 / 电脑，确保环境变量生效。
OpenClaw 安装核心流程：安装 Node.js → 选择安装方式（一键 / 手动 / Docker）→ 初始化配置 GLM-4.6 → 启动服务验证。
- 新手用户：优先选择「官方一键安装」，全程自动化，无需手动配置；
- 服务器部署：推荐「Docker 部署」，环境隔离，稳定不污染系统；
- 开发者：选择「源码安装」，支持二次开发与功能定制。
配置完成后，即可在本地 Web 控制台、VS Code 中高效调用 GLM-4.6，实现 AI 辅助开发、自动化工作流等场景，大幅提升效率～
到此这篇关于OpenClaw 完整安装教程详解(2026最新版,全平台通用)的文章就介绍到这了,更多相关OpenClaw安装教程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/224618.html