OpenClaw新手入门指南：30分钟快速上手必看教程

2026-06-02阅读 0热度 0

OpenClaw

官方介绍已经说得很直白了，为什么它能火，懂的都懂。简单总结就是：清空你的收件箱、发送邮件、管理日历、甚至连航班值机都能搞定——而且这一切，直接在 WhatsApp、Telegram 或者任何你日常在用的聊天应用里完成。不需要学新工具，不需要打开新网页。

说回正题，这篇文章主要讲的是如何在 Windows 上通过官方脚本，一键把 OpenClaw 装起来。整个过程其实很简单，跟着步骤走就行。

修改策略

先提醒一句：整个安装过程需要管理员权限。打开 Windows PowerShell，确保你有足够的权限来做后续操作。

第一步，先检查一下 PowerShell 的执行策略。只要不是 AllSigned（也就是所有脚本都必须有签名才能运行）就行，RemoteSigned 或者 Restricted 都是可以的。

Get-ExecutionPolicy

如果发现策略不符合要求，需要修改的话，执行下面这个命令就行：

Set-ExecutionPolicy Restricted

系统会弹出一个确认提示，这时候选 Y 确认即可。

执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y) [A] 全是(A) [N] 否(N) [L] 全否(L) [S] 暂停(S) [?] 帮助 (默认值为“N”): Y

环境依赖

接下来准备环境。这里需要两个东西：Node.js 和 Git。Node.js 建议用 v22+ 版本，太老的版本可能跑不起来。

node --version

如果已经安装好了，输出应该类似这样：

v22.22.0

Git 也别落下：

git --version

git version 2.23.0.windows.1

工具都备齐了，就可以正式执行安装脚本了。

脚本安装

这一步最关键，直接在 PowerShell 里执行下面这一行：

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

安装过程会输出一大堆信息，看起来可能有点眼花，但不用慌。正常跑下来会看到类似下面的结果，只要最后出现“OpenClaw installed successfully”就说明搞定了。

  OpenClaw Installer
[OK] Windows detected
[*] Existing OpenClaw installation detected
[OK] Node.js v22.22.0 found
[*] Installing OpenClaw (openclaw@latest)...
[OK] OpenClaw installed
[*] Running doctor to migrate settings...
? OpenClaw 2026.3.8 (3caab92) — I've seen your commit messages. We'll work on that together.
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  ? OPENCLAW ?
T  OpenClaw doctor
|
o  Gateway ----------------------------------------------------------+
+--------------------------------------------------------------------+
|
o  Gateway auth -----------------------------------------------------+
+--------------------------------------------------------------------+
|
o  State integrity --------------------------------------------------+
+--------------------------------------------------------------------+
|
o  Security ---------------------------------+
+--------------------------------------------+
|
o  Skills status ------------+
+----------------------------+
|
o  Plugins ------+
+----------------+
|
o  Shell completion -------------------------------------------------+
+--------------------------------------------------------------------+
|
o  Shell completion -------------------------------------------------+
+--------------------------------------------------------------------+
o  Gateway --------------+
+------------------------+
|
o  Gateway connection ---------------------------+
|                                                |
|  Gateway target: ws://127.0.0.1:18789          |
|  Source: local loopback                        |
|  Config: C:Usersxxx.openclawopenclaw.json  |
|  Bind: loopback                                |
|                                                |
+------------------------------------------------+
|
o  Gateway ------------------------+
|                                  |
|  Gateway service not installed.  |
|                                  |
+----------------------------------+
Run "openclaw doctor --fix" to apply changes.
—  Doctor complete.
[OK] Migration complete
OpenClaw installed successfully (OpenClaw 2026.3.8 (3caab92))!

验证命令

安装完之后，先确认一下 openclaw 这个命令能不能正常找到：

whereis openclaw

输出类似下面这样，就说明基础环境已经就绪了：

openclaw: /xxx/v22.22.0/openclaw /xxx/v22.22.0/openclaw.cmd /xxx/v22.22.0/openclaw.ps1

验证安装

用管理员权限单独开一个 cmd 窗口，然后执行 doctor 命令来确认安装是否完整：

openclaw doctor

过程中会询问是否要生成 gateway 对应的 token，选 Yes 就行：

o  Generate and configure a gateway token now?
|  Yes

接着它会问是否启用 zsh 脚本命令，同样选 Yes：

*  Enable zsh shell completion for openclaw?
|  Yes

服务自启

为了保证 OpenClaw 能开机自启，需要安装 gateway 服务：

o  Install gateway service now?
|  Yes

然后配置服务的运行环境，建议选 Node：

o  Gateway service runtime
|  Node (recommended)
Installed Scheduled Task: OpenClaw Gateway
Task script: C:Usersllr.openclawgateway.cmd
Updated ~.openclawopenclaw.json
|
—  Doctor complete.

实际上这步就是创建了一个计划任务。只要用户登录，服务就会自动启动。如果不想立刻注销账户，也可以先继续执行后续的命令，等一切就绪再说。

新手引导

接下来执行新手引导，它会帮你完成基础的配置：

openclaw onboard --install-daemon

系统会提示这个配置默认是个人使用的，如果要在多用户环境下使用，需要额外锁定。直接确认继续：

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
|   Yes

进入引导模式，选择 QuickStart 快速开始：

o  Onboarding mode
|  QuickStart
|
o  Existing config detected ---------+
+------------------------------------+

如果检测到已有配置文件，选择用已有的值就行：

o  Config handling
|  Use existing values
|
o  QuickStart -----------------------------+
+------------------------------------------+

模型和验证供应商这里，如果暂时没有 API Key，可以先跳过，后面再补：

o  Model/auth provider
|  Skip for now

模型提供商过滤，选所有模型即可：

o  Filter models by provider
|  All providers

默认模型这里，可以手动输入一个模型 ID 用于占位，系统目前还不会真正校验：

o  Default model
|  Enter model manually
|
o  Default model
|  anthropic/claude-opus-4-6
|
o  Model check -----------------------------------+
|  No auth configured for provider "anthropic". The agent may fail until credentials are  |
|  added.                                                                  
+---------------------------------------------+

频道配置也一样，不确认就先跳过，后续可以再替换：

o  Channel status ----------------------------+
+---------------------------------------------+
|
o  Select channel (QuickStart)
|  Skip for now
o  Web search ----------------------------------------+
+-----------------------------------------------------+

搜索提供器，同样先跳过：

o  Search provider
|  Skip for now
o  Skills status -------------+
+-----------------------------+

接下来配置 skills，这一步建议选择 Yes，走一遍流程：

o  Configure skills now? (recommended)
|  Yes
|
o  Install missing skill dependencies
|  Skip for now
|
o  Set GOOGLE_PLACES_API_KEY for goplaces?
|  No
|
o  Set GEMINI_API_KEY for nano-banana-pro?
|  No
|
o  Set NOTION_API_KEY for notion?
|  No
|
o  Set ELEVENLABS_API_KEY for sag?
|  No

然后是 Hooks 配置。这里用空格键进行选中和取消，带 [+] 标记的就是选中的。可以把几个默认的 hook 都加上，然后回车提交：

o  Hooks ------------------------------------------------------------------+
+--------------------------------------------------------------------------+
|
o  Enable hooks?
|  ? boot-md, ? bootstrap-extra-files, ? command-logger, ? session-memory
|
o  Hooks Configured ------------------------------------------------------+
+-------------------------------------------------------------------------+

最后一步，可以选择重启 gateway 服务。它会弹出一个新的命令行窗口，这个窗口是前台运行的，不能关闭——关了服务就退出了：

o  Gateway service already installed
|  Restart

服务访问

引导完成后，选择打开 Web UI，系统会自动在默认浏览器中打开：

o  Optional apps ------------------------+
+----------------------------------------+
o  How do you want to hatch your bot?
|  Open the Web UI
|
+----------------------------------------------------------------------+
—  Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.

页面打开后的效果如下：

环境变量

万一不小心把服务窗口关掉了，又不想注销账户重新来，可以直接在命令行里重新启动 gateway：

openclaw gateway --port 18789

直接修改配置文件 C:Users.openclawopenclaw.json，设置自己的模型提供商和模型。以 deepseek 为例，需要用 DEEPSEEK_API_KEY 作为环境变量。

配置模型

在配置文件中，models 和 agents 是平级的。下面是一个完整的示例，以 deepseek 为例：

{      
 "models": {
   "mode":"merge",
   "providers": {
	  "deepseek": { 
	    "baseUrl": "https://api.deepseek.com/v1", 
	    "apiKey": "${DEEPSEEK_API_KEY}", 
	    "api": "openai-completions", 
	    "models": [
	    { 
		  "id": "deepseek-chat", 
		  "name": "Deepseek-Chat" 
	    }]
	 },
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      },
      "workspace": "C:\Users\\.openclaw\workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "tools": {
    "profile": "coding"
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {},
  "session": {},
  "hooks": {},
  "gateway": {}
}

配置完成后，先退出当前的服务窗口，单独开一个 cmd 窗口，重新启动服务：

openclaw gateway --port 18789

然后在浏览器中访问 http://127.0.0.1:18789/，随便发一条消息试试看，如果能正常回复，就说明本地环境搭建成功了。

如果需要卸载，直接用这个命令就行：

openclaw uninstall