小龙虾（OpenClaw）本地安装部署教程

1. 部署前环境准备

在开始之前，请确保您的设备满足以下基础要求，这是安装成功的关键：

• 操作系统：
  • Windows：Windows 10/11（推荐使用 WSL2 环境以获得最佳稳定性，或直接使用 PowerShell）〔1〕〔31〕。
  • macOS：macOS 12 (Monterey) 及以上版本〔20〕。
  • Linux：Ubuntu 20.04+、Debian 11+ 等发行版〔24〕。
• 核心依赖软件：
  • Node.js：必须版本 ≥ v22（推荐 v24 LTS）。这是最常见的报错原因，请务必检查版本〔5〕〔32〕。
  • Git：用于拉取项目代码和依赖〔13〕。
  • Python：建议 Python 3.10+（部分插件依赖）〔1〕。

2. OpenClaw 安装步骤

根据您的操作系统，选择以下一种方式进行安装。

方案 A：Windows 一键安装（PowerShell）

1. 解锁脚本权限：以管理员身份打开 PowerShell，执行以下命令并输入 Y 确认，以允许运行脚本：

   powershell复制

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

   〔15〕
2. 执行安装脚本：在 PowerShell 中粘贴并运行以下命令：

   powershell复制

   iwr -useb https://openclaw.ai/install.ps1 | iex

   等待终端显示 “OpenClaw installed successfully” 即表示安装成功〔13〕〔31〕。

方案 B：macOS / Linux 一键安装

在终端（Terminal）中执行以下命令：

bash复制

curl -fsSL https://openclaw.ai/install.sh | bash

该脚本会自动检测环境、安装依赖并配置路径〔15〕〔26〕。

方案 C：通用 NPM 安装（适用于已安装 Node.js 的环境）

如果您熟悉前端开发环境，可以直接通过 npm 全局安装：

bash复制

npm install -g openclaw@latest

安装完成后，可通过 openclaw --version 验证是否成功〔5〕〔25〕。

3. 初始化配置 (Onboarding)

安装完成后，必须运行初始化向导来生成密钥和配置文件。

1. 启动向导：
   在终端输入以下命令：

   bash复制

   openclaw onboard

   〔12〕〔33〕

2. 配置流程指引：

   • 安全风险确认：系统会提示 AI 具有文件读写权限，选择 Yes 确认继续〔28〕。
   • 模式选择：新手推荐选择 QuickStart（快速启动模式）〔12〕。
   • 选择模型提供商 (Provider)：
     • 国内用户：推荐选择 Qwen (通义千问) 或 Ollama (本地模型)，网络连接更稳定且成本较低〔12〕〔32〕。
     • 海外用户：可选择 OpenAI、Anthropic 等。
   • 通信渠道 (Channels)：如果暂不需要接入 Telegram 或飞书，选择 Skip for now（稍后可在配置文件中修改）〔12〕。
   • 技能安装 (Skills)：建议选择 No 跳过，后续按需安装，避免依赖冲突〔28〕。

3. 启动服务：
   配置完成后，向导通常会自动启动服务。如果未启动，可手动运行：

   bash复制

   openclaw gateway start

   〔10〕

4. 验证与使用

1. 访问 Web 界面：
   打开浏览器访问 http://127.0.0.1:18789。首次访问可能需要 Token，Token 位于终端输出日志或配置文件 ~/.openclaw/openclaw.json 中〔10〕〔37〕。

2. 常用管理命令：

   • openclaw status：查看运行状态。
   • openclaw doctor：系统健康检查（排查问题必用）。
   • openclaw dashboard：直接打开 Web 控制面板。
   • openclaw gateway restart：重启服务。
     〔26〕〔6〕

5. 进阶配置（可选）

• 接入本地大模型 (Ollama)：
  如果您希望完全离线运行，可以安装 Ollama 并下载模型（如 ollama run glm-4.7-flash），然后在 OpenClaw 中配置 Provider 为 Ollama〔32〕。
• 接入飞书/钉钉：
  OpenClaw 支持接入飞书等企业通讯工具。需在飞书开放平台创建应用，获取 App ID 和 App Secret，然后通过命令 openclaw config set channels.feishu... 进行配置〔5〕〔14〕。
• 开启局域网访问：
  默认情况下仅本机可访问（Bind: Loopback）。如需局域网其他设备访问，需修改配置将 Bind 改为 lan〔37〕。

注意事项：OpenClaw 拥有对您电脑文件系统的操作权限，请勿在生产环境的根目录运行，建议为其设置专门的工作目录（Workspace）以确保安全〔5〕。