30分钟快速使用OpenClaw(新手入门必看)

官方介绍如下，为什么火，懂得都懂。

Clears your inbox, sends emails, manages your calendar, checks you in for flights.

All from WhatsApp, Telegram, or any chat app you already use.

使用官方脚本进行Windows一键安装，具体教程可以查看快速开始。

修改策略

使用管理员权限，打开Windows PowerShell。

先查看PowerShell执行策略，只要不是 AllSigned(所有脚本必须有签名) 就行，RemoteSigned(本地脚本不受签名限制，远程脚本必须有签名) 与 Restricted(受限)。

Get-ExecutionPolicy

若需要修改策略，可以执行Set-ExecutionPolicy。

Set-ExecutionPolicy Restricted

输出如下：

执行策略更改

执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170

中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?

[Y] 是(Y) [A] 全是(A) [N] 否(N) [L] 全否(L) [S] 暂停(S) [?] 帮助 (默认值为“N”): Y

环境依赖

准备环境。

Node.js 建议使用v22+。

node --version

当前版本号输出如下：

v22.22.0

Git 也需要安装。

git --version

当前版本号输出如下：

git version 2.23.0.windows.1

脚本安装

执行脚本。

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

输出结果如下：

  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 completeOpenClaw 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。

o  Generate and configure a gateway token now?|  Yes

启用zsh脚本命令。

*  Enable zsh shell completion for openclaw?|  Yes

服务自启

安装gateway 服务。

o  Install gateway service now?|  Yes

配置服务运行时。

o  Gateway service runtime|  Node (recommended)Installed Scheduled Task: OpenClaw GatewayTask script: C:Usersllr.openclawgateway.cmdUpdated ~.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

引导面板模式快速开始。

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

配置处理，使用已经存在的值。

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

模型和验证模型供应商，选择跳过。

o  Model/auth provider|  Skip for now

过滤模型提供商模型，选择所有模型。

o  Filter models by provider|  All providers

默认模型，可以先展示使用手动输入，这个时候模型还无法正常使用，只是先用于在配置文件中占位，可以先配置默认。

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 nowo  Web search ----------------------------------------++-----------------------------------------------------+

搜索提供器，可以考虑先跳过。

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

配置skills。

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

配置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.

页面展示如下：

环境变量

如果手抖关闭掉了，又不想注销账户，可以直接执行命令行。

openclaw gateway --port 18789

直接修改配置文件C:Users.openclawopenclaw.json，修改自己的提供商和模型，详细可以参考链接。以deepseek 为例，DEEPSEEK_API_KEY 为环境变量。

配置模型

配置自定义的模型服务提供商models 与 agents 平级。

{       "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/，尝试进行问答测试，本地环境则搭建成功。

如果要进行卸载，可以使用uninstall。

openclaw uninstall