OpenClaw 是一款功能强大的 AI 代理与任务管理工具。即使没有任何 API Key,我们也可以在 Windows 上完成完整部署,使用 本地 demo 模型 测试功能。本文将一步步带你完成从安装、初始化到任务创建的全流程,并附带常见问题排查方法。
一、前提条件
- Windows 10 或 11
- 管理员权限运行 PowerShell
- 已安装 Node.js(如果没有,安装脚本会自动完成)
- 已安装 Git(用于 npm 拉取依赖)
二、检查 Node.js 与 npm
在管理员 PowerShell 中执行:
powershell
node -v
npm -v
- 如果返回版本号,说明 Node.js 与 npm 已经安装
- 如果报错 "无法识别 node",请继续执行安装脚本
三、允许 PowerShell 执行脚本
如果遇到如下错误:
无法加载文件 ... 在此系统上禁止运行脚本
请运行:
powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
- 输入
Y确认 - 这允许本地和远程签名脚本执行
四、安装 OpenClaw
运行官方安装脚本:
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
-
脚本会检查系统并安装 Node.js(如果缺失),然后安装 OpenClaw CLI
-
⚠️ 注意:
- 如果报
npm error code ENOENT→ 系统未安装 Git,请先安装 Git 并勾选 Add Git to PATH - 安装 Git 后重启 PowerShell,再执行安装脚本
- 如果报
安装完成后,验证:
powershell
openclaw --version
五、初始化 OpenClaw
启动 onboard 向导:
powershell
openclaw onboard
配置选项:
- 安全警告 → 选择 Yes,确认理解风险
- 模型/认证提供商 → 选择 Skip for now(跳过在线模型)
- 消息渠道 → 选择 Skip for now(跳过 Telegram/Discord 等)
- 技能(Skills) → 选择 No
- Hooks → 选择 Skip for now
- Gateway 服务 → 默认安装 Node.js 版本的 Gateway(脚本会创建计划任务)
完成后,OpenClaw 已初始化,workspace 和会话文件夹已创建:
~\.openclaw\workspace
~\.openclaw\agents\main\sessions
六、启动 Dashboard
powershell
openclaw dashboard
- 浏览器访问:http://localhost:18789/
- 可查看 workspace、会话、任务管理界面
七、创建本地测试任务(demo 模型)
powershell
openclaw task create --model demo --prompt "Hello OpenClaw"
demo模型是 本地测试模型,完全免费- 执行后,可查看任务状态和输出:
powershell
openclaw task list
openclaw task logs <task_id>
八、验证 Gateway 服务运行
powershell
openclaw gateway status
openclaw doctor
- 确认服务正常
- 检查依赖和配置
Gateway 已安装为 计划任务,可在后台持续运行,无需手动启动 PowerShell
九、常见问题排查
| 问题 | 解决方法 |
|---|---|
node 或 npm 未识别 |
安装 Node.js 或确认 PATH 环境变量 |
npm error code ENOENT |
系统未安装 Git → 安装 Git 并重启 PowerShell |
| PowerShell 禁止执行脚本 | 执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
openclaw 未识别 |
确认 npm 全局安装成功,可尝试 npm install -g openclaw@latest |
十、总结
- 完全免费 → 使用本地 demo 模型
- 无需 API Key → 跳过在线模型与消息渠道
- 安全 → 不启用 hooks 或技能插件
- 可扩展 → 将来可以接入真实模型或消息渠道
通过本流程,你可以完整体验 OpenClaw 的 dashboard、任务管理、日志查看和会话功能,为后续接入正式模型和外部渠道做好准备。