推荐订阅源

安装 Git

https://git-scm.com/install/windows

安装 Node.js

https://nodejs.org/zh-cn/download/current/

安装 Python（推荐 python v3.11）

https://www.python.org/ftp/python/3.11.9/python-3.11.9-amd64.exe

安装 OpenClaw
参考：https://docs.openclaw.ai/zh-CN/install#windows-powershell

# 解锁 PowerShell 执行权限
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 使用 SSH 协议的请求
git config --global url."https://".insteadOf ssh://git@
git config --global url."https://github.com/".insteadOf git@github.com:

# 设置 npm 源为淘宝镜像
npm config set registry https://registry.npmmirror.com

# 清缓存（可选）
npm cache clean --force

# 快速安装
iwr -useb https://openclaw.ai/install.ps1 | iex

配置

方法一：新手引导 - 示例：连接到百炼

openclaw onboard --install-daemon

T  OpenClaw onboarding
|
o  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
|  Yes
|
o  Onboarding mode
|  QuickStart
|
o  Model/auth provider
|  Custom Provider
|
o  API Base URL
|  https://dashscope.aliyuncs.com/compatible-mode/v1
|
o  How do you want to provide this API key?
|  Paste API key now
|
o  API Key (leave blank if not required)
|  # API 密钥
|
o  Endpoint compatibility
|  OpenAI-compatible
|
o  Model ID
|  # 在百炼后台查看ID
|
o  Verification successful.
|
o  Endpoint ID
|  # 建议用Model ID
|
o  Model alias (optional)
|  # 选填
|
Configured custom provider: custom-dashscope-aliyuncs-com/qwen-plus
|
o  Select channel (QuickStart)
|  # 晚点再配置飞书
|  Skip for now
|
o  Search provider
|  Skip for now
|
o  Configure skills now? (recommended)
|  # 可选
|  No
|
o  Enable hooks?
|  # 可选
|  [+] 🚀 boot-md
|  [+] 📎 bootstrap-extra-files
|  [+] 📝 command-logger
|  [+] 💾 session-memory
|
o  How do you want to hatch your bot?
|  # 如没有打开后台，用openclaw dashboard命令打开
|  # 或者端口被iphlpsvc服务占用，查看下面方法
|  Open the Web UI
|
—  Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.

方法二：配置 - 示例：连接到千问

openclaw configure

T  OpenClaw configure
|
o  Where will the Gateway run?
|  Local (this machine)
|
o  Select sections to configure
|  Model
|
o  Model/auth provider
|  Qwen
|
•  Starting Qwen OAuth…
o  Qwen OAuth complete
|
o  Models in /model picker (multi-select)
|  [+] qwen-portal/coder-model
|  [+] qwen-portal/vision-model
|
—  Configure complete.

如千问授权失败，可以重新发起

openclaw models auth login --provider qwen-portal

网关

# 启动
openclaw gateway start
# 停止
openclaw gateway stop
# 重启
openclaw gateway restart
# 检查状态
openclaw gateway status

查看实时日志

openclaw logs --follow

打开面板

openclaw dashboard

卸载

openclaw gateway stop

openclaw uninstall --all --yes --non-interactive

# 删除主目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Remove-Item -Recurse -Force "$env:APPDATA\OpenClaw"
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\OpenClaw"

# 删除历史版本目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot"
Remove-Item -Recurse -Force "$env:USERPROFILE\.moltbot"

# 卸载 npm 包
npm rm -g openclaw

解决端口占用

# 1. 停止当前服务
openclaw gateway stop

# 2. 卸载服务（会删除计划任务）
openclaw gateway uninstall

# 3. 修改端口为 18788
notepad $env:USERPROFILE\.openclaw\openclaw.json

{
  "gateway": {
    "port": 18788
  }
}

# 4. 重新安装服务（读取新配置生成计划任务）
# PS：会自动启动网关
openclaw gateway install

# 5. 验证状态
openclaw gateway status

常用工具

# Office套件（主要）
pip install python-docx openpyxl python-pptx pandas
# 图片库
pip install pillow matplotlib

从 ClawHub 安装技能

加载优先级：

1. 工作区：<workspace>/skills（<workspace>默认是~/.openclaw/workspace）
2. 本地管理：~/.openclaw/skills（所有 Agent 都能使用）
3. 额外配置：~/.openclaw/openclaw.json 中 skills.load.extraDirs
4. 内置捆绑：npm 包或 OpenClaw.app

# ClawHub -> 账号 -> Settings，点击Create token获取
clawhub login --token <token>

# 安装/更新/删除技能
npx clawhub install <slug>
npx clawhub update <slug>
npx clawhub uninstall <slug>

npx clawhub install self-improving-agent    # 自我改进
npx clawhub install word-docx               # word
npx clawhub install excel-xlsx              # excel
npx clawhub install powerpoint-pptx         # powerpoint
npx clawhub install nano-pdf                # PDF
npx clawhub install content-writer          # 自媒体内容生成器

npm install -g @openai/codex                # AI 编码助手

# 退出（不建议）
clawhub logout

# 查看技能
openclaw skills check