波波技术栈
article
AI

OpenClaw 安装详细教程

本文是一份 OpenClaw 完整安装教程，覆盖 Windows、macOS 与 Linux 三大平台，详细讲解系统要求、命令行与 npm、源码等多种安装方式，并逐步说明新手引导中的模型提供商选择、DeepSeek 模型配置、Web 搜索与 Skills 技能设置。文中还包含安装验证、TUI 终端界面使用、常用快捷键与斜杠命令，以及常见问题排查、更新卸载等参考内容。

#Deepseek#OpenClaw#AI工具

OpenClaw 安装教程

本教程涵盖 Windows、macOS、Linux 的完整安装流程，包含 DeepSeek 模型配置、Web 搜索设置、Skills 技能配置和常见问题排查。

目录

  1. 系统要求
  2. 安装 OpenClaw
  3. 新手引导配置
  4. 验证安装
  5. 开始使用
  6. 常见问题排查
  7. 更新与卸载
  8. 快速参考

一、系统要求

项目 要求
操作系统 Windows（推荐 WSL2）、macOS 12+、Linux
Node.js 22 LTS 或更高版本
内存 建议 ≥ 8GB
磁盘 ≥ 20GB 可用空间

二、安装 OpenClaw

Windows（PowerShell）

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

官方强烈推荐 Windows 用户通过 WSL2 使用，以获得更稳定体验。先安装 WSL2：

wsl --install -d Ubuntu

然后在 WSL2 的 Ubuntu 终端里，按下面的 macOS / Linux 方式安装。

macOS / Linux / WSL2

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

只想安装、不运行新手引导

Windows：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

macOS / Linux：

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

方式二：npm 手动安装

适用于已自行管理 Node.js 环境的用户：

npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemon

注意：npm 12 默认阻止未批准的包生命周期脚本，--allow-scripts=openclaw 用于显式允许 OpenClaw 的 preinstall / postinstall 步骤。npm 11.15 及更早版本需省略此选项。

方式三：从源码安装

适用于贡献者：

git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install && pnpm build && pnpm ui:build pnpm link --global openclaw onboard --install-daemon

三、新手引导配置

安装完成后向导自动启动，按以下顺序配置。

3.1 选择启动模式

How would you like to start?

Quick start (recommended) Custom setup

选 Quick start。它会自动使用默认值（端口 18789、本地回环绑定、自动生成 Token），你只需选模型和填 API Key。之后随时可用 openclaw configure 修改。

3.2 选择模型提供商

Model/auth provider

Detected on this machine (Claude Code) OpenAI OpenRouter xAI (Grok) Google Anthropic More… Skip for now

你的情况 应该选
已安装并登录 Claude Code Detected on this machine (Claude Code)
有 OpenAI API 或 ChatGPT 订阅 OpenAI
想用 DeepSeek More… 找到 DeepSeek，或稍后单独配置

3.3 配置 DeepSeek 模型（如需要）

第一步，安装 DeepSeek 插件：

openclaw plugins install @openclaw/deepseek-provider openclaw gateway restart

第二步，前往 platform.deepseek.com 创建 API Key。

第三步，运行配置向导：

openclaw onboard --auth-choice deepseek-api-key

向导会提示输入 API Key，并将 deepseek/deepseek-v4-pro 设为默认模型。

第四步，验证模型可用：

openclaw models list --provider deepseek

3.4 配置 Web 搜索

类型 代表 Provider 特点
需要 API Key Brave、Exa、Tavily、Perplexity、Gemini、Grok、Kimi、MiniMax、Parallel 效果更好、更稳定
免 Key（免费） DuckDuckGo (experimental)、Firecrawl Search (Free)、Parallel Search (Free)、SearXNG、Ollama Web Search 开箱即用，可能限速

新手建议：选 DuckDuckGo Search (experimental) 或 Firecrawl Search (Free)，无需申请 Key，回车继续。之后如需更好质量，运行 openclaw configure 更换。

3.5 配置 Skills（技能）

Install missing skill dependencies

[ ] Skip for now [•] 🔐 1password [ ] 📰 blogwatcher [ ] 🐙 github ...

新手建议：直接选 Skip for now，先完成安装流程。技能可之后单独安装：

openclaw skills list openclaw skills install github

四、验证安装

openclaw --version openclaw doctor openclaw gateway status

五、开始使用

5.1 启动 TUI（终端界面）

openclaw tui

如果遇到发消息后卡住，尝试：

openclaw tui --deliver

成功连接后界面示例：

openclaw tui - ws://127.0.0.1:18789 - agent main (main) - session main session agent:main:main gateway connected | idle agent main (main) | session main | deepseek-v4-pro high | deliver:off | tokens ?/1.0m

界面说明：

  • gateway connected：网关已连接
  • idle：当前空闲，等待输入
  • deepseek-v4-pro high：当前使用的模型
  • tokens ?/1.0m：上下文用量，上限 100 万 token

常用快捷键：

快捷键 作用
Enter 发送消息
Esc 中止正在进行的运行
Ctrl+C 清除输入（按两次退出）
Ctrl+L 模型选择器
Ctrl+G 智能体选择器

常用斜杠命令：

命令 作用
/help 查看所有可用命令
/model 切换模型
/new 开新会话
/status 显示会话/模型摘要

5.2 访问 Web 仪表盘

浏览器打开 http://localhost:18789 即可使用 Web 界面。

六、常见问题排查

问题 1：openclaw 命令找不到

PATH 问题：npm 的全局二进制目录不在 shell 的 PATH 中。

Windows 下查看 npm 全局路径：

npm config get prefix

然后将该路径添加到系统环境变量 PATH。

问题 2：插件安装卡在 "Linked peerDependency"

这是安装插件时的已知现象，与镜像源关系不大。

Windows PowerShell 使用国内镜像源：

$env:NPM_CONFIG_REGISTRY="https://registry.npmmirror.com" openclaw plugins install @openclaw/deepseek-provider

如果仍卡住，进入插件目录手动安装依赖：

cd ~/.openclaw/extensions/deepseek-provider Remove-Item -Recurse -Force node_modules, package-lock.json $env:NPM_CONFIG_REGISTRY="https://registry.npmmirror.com" npm install

问题 3：1Password 技能显示"已阻止"

表示系统缺少 op 命令行工具。

安装 1Password CLI：

winget install AgileBits.1Password.CLI

重新打开 PowerShell 验证：

op --version

然后在 1Password 桌面应用中开启 CLI 集成：设置 > 开发者 > 勾选 Integrate with 1Password CLI。

问题 4：onboarding 卡在健康检查

openclaw onboard --skip-health openclaw gateway start

问题 5：gateway restart 在容器中无效

容器内没有 systemd，restart 可能失败。可用：

pkill -f openclaw openclaw gateway --force

七、更新与卸载

更新

openclaw update --channel stable openclaw update --channel beta openclaw update --channel dev

卸载

npm uninstall -g openclaw rm -rf ~/.openclaw

八、快速参考

操作 命令
安装（Windows） iwr -usebhttps://openclaw.ai/install.ps1 | iex
安装（macOS/Linux） curl -fsSLhttps://openclaw.ai/install.sh | bash
新手引导 openclaw onboard --install-daemon
启动 TUI openclaw tui
查看状态 openclaw gateway status
诊断问题 openclaw doctor
安装插件 openclaw plugins install <插件名>
重启网关 openclaw gateway restart

一句话总结：Windows 用户可用 PowerShell 脚本安装（官方推荐 WSL2），macOS/Linux 用户运行 curl 脚本，然后按向导完成模型配置即可。遇到问题优先运行 openclaw doctor 诊断。