乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > openclaw下载安装详细教程!

openclaw下载安装详细教程!

当前时间： 2026-03-15 03:12:22 分类：办公文件 评论(0)
openclaw下载安装详细教程!

OpenClaw（昵称“小龙虾”）是2026年初爆火的一款开源AI智能体（AI Agent），由奥地利程序员彼得·斯坦伯格开发 。它并非又一个聊天机器人，而是一个能“动手干活”的数字助理 。

OpenClaw最新部署下载方法详细教程如下：

⏱️ 快速选择：哪种安装方式适合你？

你的目标/场景
推荐安装方式
一句话说明
核心门槛
数据绝对私有、完全免费、离线可用Windows本地部署 (OpenClaw + Ollama)
在你自己电脑上跑，所有数据和推理都在本地，不联网也能用。
需要**NVIDIA显卡 (显存≥8GB)**，需手动配置Ollama模型。
主力设备是Mac，或使用Linux服务器macOS / Linux 标准安装
通过官方脚本一键安装，干净利落。
需安装或升级Node.js。
不想折腾环境、需要7x24小时在线服务阿里云一键部署 (云端)
买个云服务器，镜像里都配好了，在线就能用，省心省力。
需注册阿里云账号，并获取百炼API-Key。
在国产操作系统上尝鲜银河麒麟 OS 部署
国产系统也能跑，步骤和Linux类似。
需熟悉终端基本操作。

🪟 1. Windows 11 本地部署教程 (OpenClaw + Ollama)

这是实现数据完全私有化的方案。OpenClaw负责执行任务，Ollama则作为它的“大脑”（本地大模型）。如果你的电脑没有NVIDIA显卡（显存≥8GB），运行会非常卡，不推荐此方案。

第一步：准备工作

  • 硬件：NVIDIA显卡 (显存≥8GB)，16GB以上内存。
  • 软件：以管理员身份打开PowerShell。
  • 安装Node.js：确保已安装Node.js (≥ 18.0.0)，安装时记得勾选“Add to PATH” 。

第二步：安装Ollama并定制模型

  1. 安装Ollama：去 Ollama官网 下载Windows版并安装 。
  2. 拉取基础模型（以中文友好的通义千问7B为例，约4.7GB）：
    ollama pull qwen2.5:7b
  3. 【关键步骤】定制大模型上下文窗口：OpenClaw要求模型的“记忆力”（上下文窗口）至少为16000 tokens，而默认模型只有4096，必须手动扩展 。
    • 在PowerShell中依次执行以下命令，创建一个上下文窗口为32768的定制模型（命名为qwen2.5:7b-32k）：
      cd C:\Users\<你的用户名>@"FROM qwen2.5:7bPARAMETER num_ctx 32768"@ | Out-File -Encoding ascii Modelfileollama create qwen2.5:7b-32k -f Modelfile

第三步：安装并配置OpenClaw

  1. 安装OpenClaw：
    npm install -g openclaw
  2. 运行配置向导，对接本地Ollama：
    openclaw onboard
    这是最关键的一步，请根据下表提示进行选择和输入 ：
    提示问题
    你的操作/输入
    说明
    Model/auth provider
    选择 Custom Provider
    我们要对接本地Ollama。
    API Base URL
    输入 http://127.0.0.1:11434/v1
    这是Ollama默认的本地地址。
    API Key
    输入任意字符，如 ollama
    本地部署无需真实密钥，但不能留空。
    Endpoint compatibility
    选择 OpenAI-compatible
    Ollama兼容OpenAI的API格式。
    Model ID
    输入 qwen2.5:7b-32k
    填入我们刚才创建的定制模型名称。
    后续关于Skills等配置
    全部选择 Skip for now
    新手可先跳过，以后再按需安装。
  3. 【避坑】解决“上下文窗口过小”报错：如果启动后提示“Model context window too small”，需要手动修改配置文件 C:\Users\<你的用户名>\.openclaw\openclaw.json，在对应模型下加入 "context_length": 32768，保存后重启服务 。

第四步：启动

  • 运行 openclaw start 启动服务。
  • 打开浏览器，访问 http://127.0.0.1:18789 即可开始使用 。

🍏 2. macOS & Linux 标准安装教程

如果你的主力设备是Mac，或者你有一台Linux服务器，这是最直接的安装方式。

第一步：安装Node.js

  • macOS：使用Homebrew安装 。
    brew install node@22
  • **Linux (Ubuntu)**：使用apt安装 。
    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bashsudo apt install -y nodejs git

第二步：一键安装OpenClaw

官方提供了一键安装脚本，会自动处理大部分环境配置 。

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

安装脚本执行完成后，通常会自动进入配置向导 (openclaw onboard)。如果未进入，可手动执行。

第三步：初始化配置

在配置向导中，你需要做两件核心事：

  1. 连接“大脑”：选择你的大模型提供商（如阿里云百炼、OpenAI、七牛云等），并输入对应的 API Key 。
  2. 打通“感官”：暂时可以跳过通讯软件的配置，以后再装 。

第四步：启动

  • 运行 openclaw start 启动服务。
  • 运行 openclaw dashboard，浏览器会自动打开管理后台 。

☁️ 3. 阿里云一键部署教程 (云端)

如果你不想配置本地环境，或者需要服务24小时在线，这是最快捷的选择。

第一步：购买服务器

  1. 在阿里云轻量应用服务器控制台创建实例。
  2. 镜像选择 OpenClaw专属镜像 。
  3. 在防火墙规则中，确保放行 18789端口 。

第二步：获取API密钥

登录阿里云百炼平台，在“密钥管理”中创建一个 API-Key 。

第三步：一键配置

在服务器控制台的应用详情页，找到“一键配置”，输入刚才获取的百炼API-Key，系统会自动完成所有配置 。

第四步：开始使用

配置完成后，点击“打开网站页面”，即可通过服务器的公网IP访问你的专属OpenClaw控制台。

📝 安装后的常用命令

无论哪种方式，这几个命令都很实用 ：

  • 管理服务：openclaw start/stop/restart。
  • 查看日志（出bug必备）：openclaw logs follow。
  • 健康检查：openclaw doctor，快速定位配置错误。
  • 安装技能：openclaw skills install <技能名称>，比如安装联网搜索技能 openclaw skills install search-web 。