环境

Windows 11，PowerShell 管理员模式。

安装

运行 openclaw 进入交互式安装。

安装配置项：

  • 安装模式：QuickStart
  • 模型：deepseek/deepseek-v4-flash
  • 入口：ClickClack
  • 搜索：DuckDuckGo
  • Skills：Yes（大部分依赖 Linux/macOS 工具，Windows 上无法安装的跳过）
  • Hooks：跳过
  • Agent 启动：Hatch in Terminal（便于查看日志）

启动 Gateway

Shell
openclaw gateway run

端口被占用时加 --force：

Shell
openclaw gateway run --force

Gateway 绑定 loopback，监听 127.0.0.1:18789。Windows 上注册为计划任务运行。

Token

浏览器打开 http://127.0.0.1:18789/chat?session=main，需要输入 token。生成方式：

Shell
openclaw doctor --generate-gateway-token

命令执行后终端无输出属正常，token 已写入配置文件 C:\Users\10196\.openclaw\openclaw.json 的 gateway.auth.token 字段。

Skills

Windows 下共 65 个 Skills，可用约 20 个。openclaw doctor 会提示 14 个可用、44 个缺依赖，选择 Disable unavailable skills → Yes 禁用不可用项。

常见问题

AI 不响应：UI 能打开但 AI 无回复，日志报错：

Go
billing error — no credits

API 余额不足，充值后恢复。

搜索配置

安装时选择 DuckDuckGo，但实际配置的搜索提供者可能为 searxng（指向 localhost:8888），取决于本地是否有 searxng 实例。以 openclaw.json 中 tools.web.search.provider 字段为准。

中文界面

UI 设置 Language → zh-CN，或配置 gateway.locale 为 "zh-CN"。

注意事项

  • Gateway 起不来：旧进程未清理，加 --force。仍失败用 openclaw gateway status 查看状态。
  • Token 无输出属正常：openclaw doctor --generate-gateway-token 执行后 token 直接写入配置文件，去 openclaw.json 查看。
  • AI 不回话先查余额：billing 报错是最常见原因，openclaw configure 可随时切换模型。
  • Windows 下 Skills 少属预期：核心功能与 Skills 数量无关。
  • 搜索提供者可能不同：以 openclaw.json 的 tools.web.search.provider 为准。
  • 推荐前台运行：openclaw gateway run 前台运行便于直接查看报错。
  • 配置文件位置：C:\Users\你的用户名\.openclaw\openclaw.json，大部分配置集中于此。
  • 插件状态：openclaw plugins list 查看启用的插件。示例环境启用：deepseek、clickclack、duckduckgo、searxng、feishu。
阅读进度 0%