Windows OpenClaw 完整安装与配置全攻略

OpenClaw 完整安装与配置全攻略

一、 系统环境初始化

在 Windows 上安装 OpenClaw 前,必须先配置 PowerShell 的执行权限和编码格式,否则后续安装脚本会因权限或乱码问题中断。

    1. 解锁 PowerShell 执行策略:
code__pre 复制代码
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
    1. 解决中文乱码,强制使用 UTF-8 编码:
code__pre 复制代码
$OutputEncoding = [Console]::InputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
    1. 切换活动代码页:
code__pre 复制代码
chcp 65001

二、 基础依赖工具安装

使用 Windows 自带的包管理器 winget 安装 Git 和 Node.js 环境。

    1. 安装 Git 工具:
code__pre 复制代码
winget install --id Git.Git -e --source winget
    1. 安装 Node.js (LTS 版):
code__pre 复制代码
winget install --id OpenJS.NodeJS.LTS -e --source winget
    1. 配置 Git 用户信息 (以用户 leo 为例):
code__pre 复制代码
git config --global user.name "leo"
git config --global user.email "leo@example.com"

图一:Windows依赖安装界面


三、 OpenClaw 安装与 QuickStart 详细配置过程

图二:OpenClaw配置界面

1. 进入 QuickStart 交互配置

注:在终端界面请使用 ↑ ↓ ← → 切换选项,空格 选中,回车确定。

    1. 执行 OpenClaw 安装脚本:
code__pre 复制代码
iwr -useb https://openclaw.ai/install.ps1 | iex
    1. 进入 QuickStart 交互配置(以下为你需要点击/选择的选项):
  • • 确认隐私协议 :I understand this is personal-by-default... Continue? -> Yes
  • • 选择模式 :Onboarding mode -> QuickStart
  • • 网关配置(无需改动):
  • • Gateway port: 18789
  • • Gateway bind: Loopback (127.0.0.1)
  • • Tailscale exposure: Off

四、 核心 API 配置与获取

这是 Agent 能够运行的关键,你需要为它提供"大脑"和"眼睛",大家可以按照图二配置进行选择。

1. 模型配置 (LLM)

API 获取链接 :MiniMax 开放平台

  • • Model/auth provider -> MiniMax
  • • MiniMax auth method -> MiniMax M2.5 (CN)
  • • How do you want to provide this API key? -> Paste API key now
  • • Enter MiniMax China API key -> 粘贴你从上方链接获取的 Key
  • • Default model -> Keep current (minimax-cn/MiniMax-M2.5)

2. 联网搜索配置 (Search)

API 获取链接 :Moonshot (Kimi) 开放平台

  • • Search provider -> Kimi (Moonshot)
  • • Kimi (Moonshot) API key -> 粘贴你从上方链接获取的 Key

五、 技能、依赖与自动化钩子

1. 技能安装 (Skills)

  • • Configure skills now? -> Yes
  • • Install missing skill dependencies -> 🧩 clawhub
  • • Preferred node manager for skill installs -> npm
  • • 以下 API 环境变量均选择跳过:
  • • Set GOOGLE_PLACES_API_KEY? -> No
  • • Set GEMINI_API_KEY? -> No
  • • Set NOTION_API_KEY? -> No
  • • Set OPENAI_API_KEY? -> No
  • • Set ELEVENLABS_API_KEY? -> No

2. 自动化钩子 (Hooks)

  • • Enable hooks? -> 🚀 boot-md, 📎 bootstrap-extra-files, 📝 command-logger, 💾 session-memory

图三:OpenClaw启动成功界面


3. 进入交互界面 (Hatch)

  • • How do you want to hatch your bot? -> Open the Web UI

图四:OpenClaw对话界面


4. 安装 Chrome 浏览器扩展 (Browser Relay)

为了让 OpenClaw 能够直接与你的浏览器交互(如读取网页内容、实现网页自动化操作),必须安装并配置对应的 Chrome 插件。

1. 安装插件

图五:Chrome插件页面

访问 Chrome 应用商店 - OpenClaw 搜索页面,在搜索结果中找到并点击安装 OpenClaw Browser Relay for Windows。

2. 获取 Gateway Token

图六:OpenClaw Token获取配置

插件需要身份验证才能连接到你的本地网关。请在 PowerShell 中运行以下命令来获取你的唯一令牌:

code__pre 复制代码
(Get-Content "$HOME\.openclaw\openclaw.json" | ConvertFrom-Json).gateway.auth.token
3. 配置插件

图七:OpenClaw Browser Relay配置界面

安装完成后,点击浏览器右上角的扩展程序图标(小红螃蟹图标),进入配置界面进行如下设置:

  • • Port (端口) :默认填入 18792 。 注意:这是 Relay 的默认通信端口。计算逻辑通常为:网关端口 。
  • • Gateway token :填入你刚才通过上述命令获取到的 Token 字符串。
  • • 保存连接 :点击 Save 按钮。

如何判断连接成功?
观察浏览器工具栏的插件图标:如果图标由红色 变为绿色,说明插件已成功识别到本地服务并完成握手。


六、 电脑重启后的运维操作

1. 启动服务

如果你重启了电脑,OpenClaw 网关服务通常会通过 Windows 计划任务自动运行。如果需要手动启动:

code__pre 复制代码
openclaw gateway

或者直接运行安装生成的脚本:

code__pre 复制代码
C:\Users\leo\.openclaw\gateway.cmd

2. 管理与调试命令

  • • 打开 Web UI/控制面板:
code__pre 复制代码
openclaw dashboard
  • • 查看网关认证 Token:
code__pre 复制代码
(Get-Content "$HOME\.openclaw\openclaw.json" | ConvertFrom-Json).gateway.auth.token
  • • 系统状态诊断:
code__pre 复制代码
openclaw doctor

相关推荐
Starry-sky(jing)21 分钟前
Hermes Agent 升级 v0.23.2:先辨更新渠道,再看 CLI 退出残留修复
人工智能·python·ai agent
codigger1 小时前
AI 三分钟写完的代码,你凭什么敢直接上线?
ai·程序员·编程·ai编程·#人工智能
wflynn18 小时前
Google 观察到首个全自动化网络攻击,AI 框架已能独立完成漏洞利用
ai·技术
zdr尽职尽责19 小时前
终端工具凭空消失:Codex + GPT-6 的一次完整排障复盘
数据库·gpt·学习·ai
goehou20 小时前
Kafka 的默认配置适合演示,不适合生产
kafka·消息队列·幂等·ai agent
佛系18921 小时前
从服务端日志精确分离搜索抓取、监控探测与真实流量的实操清单
ai·大模型·seo·geo·结构化数据·indexnow
一起学安全技术1 天前
拆大模型 11|大模型面试拷问:12 问逐层拆
人工智能·ai·语言模型·面试·职场和发展·求职招聘
TomEval2 天前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
cpolar技术支持2 天前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
wy_hhxx2 天前
《Agent设计模式 图解可复用智能体架构》下篇内容整理
人工智能·ai agent