OpenClaw（江湖昵称“小龙虾”）是一款开源的AI代理框架，支持本地私有化部署，用户可在自有设备上运行该框架，实现数据主权控制、零服务器成本使用及隐私安全保障。无论是个人测试、敏感数据处理还是开发调试，OpenClaw均能提供灵活的解决方案。本文将详细介绍其本地安装部署流程，涵盖环境配置、安装步骤及常见问题解决方案。
📢提示：文章排版原因，资源教程链接地址放在图片下面👇👇，往下翻就行
📢提示：文章排版原因，资源教程链接地址放在图片下面👇👇，往下翻就行
《快速部署OpenClaw(Clawdbot)极简部署教程》资源(尽快保存，随时失效)
https://pan.quark.cn/s/76138901bb76
提示（建议复制后浏览器搜索打开即可,手机用户长按复制打开）保存后下载速度很快
资源完全免费，不会收取您任何费用，资源搜集于互联网公开分享资源，如有侵权，联系立删。
一、部署前准备
1. 系统与硬件要求
操作系统：支持Windows 10/11、macOS 12+、Linux（Ubuntu 20.04+/Debian 11+等主流发行版）。
硬件配置：
内存：最低2GB，推荐4GB以上；若需本地运行大模型，建议8GB+。
磁盘空间：预留至少500MB可用空间，推荐1GB以上。
CPU：多核2.0GHz+，支持x86-64架构（ARM64需验证兼容性）。
2. 软件依赖
Node.js：必须安装v22.x及以上版本（推荐v24 LTS），作为OpenClaw的运行基础。
Git：用于版本控制与代码管理，Windows用户需勾选“Add to PATH”选项。
Python：建议安装Python 3.9+，部分技能插件依赖Python环境。
网络环境：需稳定联网以下载依赖包；若需调用云端大模型，需保持网络畅通。
3. 权限与路径
管理员权限：Windows用户需以管理员身份运行PowerShell，避免权限不足导致安装失败。
安装路径：避免使用中文、空格或特殊符号（如“我的文档”“Open Claw”），防止路径解析错误。
二、安装步骤
1. 安装Node.js与Git
Node.js：从Node.js官网下载v22.x+安装包，安装时勾选“Add to PATH”。
Git：
Windows：下载Git for Windows，安装时选择默认配置。
macOS：通过Homebrew安装（brew install git）。
Linux：使用包管理器安装（如Ubuntu的sudo apt install git）。
2. 配置npm镜像（可选）
若网络连接较慢，可配置npm镜像加速依赖下载：
bash
1npm config set registry https://registry.npmmirror.com2
3. 安装OpenClaw
一键安装脚本（推荐）：
Windows：以管理员身份运行PowerShell，执行以下命令：
powershell
1iwr -useb https://openclaw.ai/install.ps1 | iex2
若下载失败，可使用国内镜像：
powershell
1iwr -useb https://clawd.org.cn/install.ps1 | iex2
macOS/Linux：在终端执行：
bash
1curl -fsSL https://openclaw.ai/install.sh | bash2
NPM全局安装：若已安装Node.js，可直接通过npm安装：
bash
1npm install -g openclaw@latest2
4. 初始化配置
运行初始化向导生成密钥与配置文件：
bash
1openclaw onboard --install-daemon2
按提示操作：
设置Agent名称：自定义AI代理的名称。
配置大模型API Key：
国内用户推荐选择阿里云百炼（DashScope）或通义千问（Qwen），新用户可获免费Token额度。
海外用户可选择OpenAI、Anthropic等模型，需自行准备API Key。
若需本地模型，可跳过此步骤，后续通过配置文件接入Ollama等本地大模型。
设置工作目录：默认~/.openclaw/，可根据需求修改。
安装系统服务：选择是否将OpenClaw注册为系统服务（如launchd或systemd）。
配置通信平台：如需接入Telegram、飞书等，按提示填写App ID与密钥；暂不需要可跳过。
5. 启动服务
启动网关：
bash
1openclaw gateway start2
验证状态：
bash
1openclaw gateway status2
若显示“Running”，则服务启动成功。
6. 访问控制台
打开浏览器，输入以下地址：
1http://localhost:187892
首次访问需使用Token认证，Token可在配置文件~/.openclaw/openclaw.json中查找，或通过命令生成带Token的链接：
bash
1openclaw dashboard2
三、进阶配置
1. 接入本地大模型（如Ollama）
若需完全离线运行，可配置OpenClaw使用本地大模型：
安装Ollama：从Ollama官网下载并安装。
拉取模型：
bash
1ollama pull qwen2.5 # 以Qwen2.5为例2
修改OpenClaw配置：在config/models.json中添加本地模型配置：
json
1{2 "ollama": {3 "base_url": "http://localhost:11434",4 "model": "qwen2.5",5 "temperature": 0.76 }7}8
重启服务：
bash
1openclaw gateway restart2
2. 配置企业IM平台（如飞书）
创建飞书应用：在飞书开放平台创建应用，获取App ID与App Secret。
配置权限：在飞书开放平台配置应用权限，包括消息收发、用户信息读取等。
修改OpenClaw配置：在config/channels.json中添加飞书配置：
json
1{2 "feishu": {3 "app_id": "your_app_id",4 "app_secret": "your_app_secret",5 "bot_token": "your_bot_token"6 }7}8
重启服务：
bash
1openclaw gateway restart2
四、常见问题解决方案
1. 安装失败或速度慢
配置npm镜像：
bash
1npm config set registry https://registry.npmmirror.com2
使用国内安装脚本：
powershell
1iwr -useb https://clawd.org.cn/install.ps1 | iex2
2. 权限问题
Windows：以管理员身份运行PowerShell，避免权限不足。
Linux：修复全局包安装权限：
bash
1sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}2
3. 服务启动失败
检查端口占用：
bash
1netstat -tulnp | grep 187892
若端口被占用，修改OpenClaw配置中的端口号或终止占用进程。
查看日志：
bash
1openclaw gateway logs2
根据日志信息排查问题。
4. 模型调用失败
检查API Key：确保大模型API Key有效且未过期。
验证模型配置：确认config/models.json中的模型名称与接口地址正确。
测试本地模型：若使用本地模型，通过ollama list验证模型是否已拉取成功。
五、总结
OpenClaw的本地部署流程涵盖环境准备、安装、初始化配置、服务启动及进阶功能配置。通过本文的详细指南，用户可快速完成部署，并根据需求接入本地或云端大模型、企业IM平台等。若遇问题，可优先检查日志与配置文件，或参考官方文档获取更多支持。
