使用cursor在本地协助，然后在cmd中部署，链接了飞书，使用cursor的对话记录生成当前文章，最后附一份openclaw的配置json。

OpenClaw 在 Windows 上的安装与配置指导

本文档基于实际部署对话整理，面向 Windows 用户，涵盖安装、国内 Kimi、飞书、网页搜索、自带浏览器搜索及常见问题处理。

一、环境要求

• Node.js：建议 22（或当前 LTS）
• npm：随 Node 安装
• Git：已安装并可用（安装时依赖会从 GitHub 拉取）

确认版本示例：

node -v
npm -v
git --version

二、安装 OpenClaw

2.1 配置 Git 使用 HTTPS（必做）

安装时部分依赖（如 libsignal-node）会通过 Git 从 GitHub 克隆。若使用 SSH 容易失败，需改为 HTTPS：

在 PowerShell 或 Git Bash 中执行（对应当前用户）：

git config --global url."https://github.com/".insteadOf "git@github.com:"
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

2.2 全局安装

npm install -g openclaw@latest

安装成功后：

• 版本示例：OpenClaw 2026.3.13
• 命令 openclaw 应全局可用

2.3 若提示「openclaw 不是内部或外部命令」

说明 npm 全局目录不在 PATH 中：

npm config get prefix

将该命令输出路径下的 \bin 加入系统环境变量 PATH（例如 %AppData%\npm），保存后重新打开终端再试。

2.4 常用命令

三、首次配置：运行向导

在 PowerShell 或 CMD 中执行：

openclaw onboard --install-daemon

向导会依次引导：AI 模型、聊天渠道（如飞书）、网页搜索、Skills、Hooks、启动方式等。下面按步骤说明推荐选择。

四、AI 模型配置（国内用 Kimi）

4.1 选择模型

• 选 「Moonshot AI (Kimi K2.5)」。
• Moonshot AI 为 Kimi 厂商，K2.5 为当前可用模型。

4.2 API Key

• 在 Moonshot 开放平台 或 Kimi 相关页面申请 API Key。
• 输入时必须带上前缀 sk-，从平台复制的完整 Key（sk-xxxxxxxx...）原样粘贴，不要只填后半段。

4.3 修改模型 API Key（日后）

任选其一：

• 直接改文件：编辑
  C:\Users\<你的用户名>\.openclaw\agents\main\agent\auth-profiles.json
  找到对应模型（如 moonshot:default）的 key，改为新 Key（含 sk-），保存。
• 重新走向导：openclaw configure 或 openclaw onboard，重新选择模型并填写 Key。
• Web 控制台：浏览器打开 http://127.0.0.1:18789/ ，在 Config 中修改对应 API Key。

修改 API Key 后建议执行一次：openclaw gateway restart。

五、飞书插件配置

5.1 插件来源

• 选 「Use local plugin path」（使用本地插件路径）。
• 飞书插件已随 OpenClaw 安装在 node_modules\openclaw\extensions\feishu，与当前版本一致，无需再下载。

5.2 凭证方式

• 选 「Enter App Secret」：在向导中直接输入 App ID、App Secret，写入 OpenClaw 配置，适合个人本机使用。

5.3 获取 App ID、App Secret

1. 打开 飞书开放平台，登录。
2. 进入 开发者后台 → 应用开发 → 创建或打开企业自建应用。
3. 打开该应用 → 左侧 「凭证与基础信息」。
4. 复制 App ID 和 App Secret（App Secret 需点击「显示」或「重置」后复制）。
5. 在应用 权限 中开通：im:message、im:chat、contact:user.base:readonly 等所需权限，并发布应用或加入测试群。

在向导提示时，依次粘贴 App ID、App Secret（输入 App Secret 时通常不显示，属正常，粘贴后回车即可）。

5.4 连接方式

• 选 「WebSocket (default)」：本机与飞书长连接，无需公网或内网穿透，适合个人/本机。

5.5 群聊策略

• Allowlist（白名单）：只在指定群回复，可控，适合先小范围使用。
• Open：所有群可回复，需 @ 机器人触发，适合多群使用。

5.6 飞书配对（access not configured）

当飞书里机器人回复类似：

OpenClaw: access not configured.
Your Feishu user id: ou_xxxx
Pairing code: xxxx
Ask the bot owner to approve with:
openclaw pairing approve feishu xxxx

在安装 OpenClaw 的本机打开 PowerShell，执行（将 4AJYMXKN 换成机器人给出的实际配对码）：

openclaw pairing approve feishu xxxx

执行成功后，在飞书再发一条消息即可正常对话。新用户使用时同样在本机执行 openclaw pairing approve feishu <新配对码>。

六、网页搜索配置

6.1 向导中的选择

• Kimi (Moonshot)：国内可用，可复用对话的 Moonshot API Key；需在配置中设置国内 baseUrl（见下）。
• Brave Search：需到 Brave Search API 申请 Key，免费额度约 2000 次/月，稳定性较好。
• Skip for now：暂不启用，后续可在配置或命令行中再配。

6.2 国内使用 Kimi 搜索时的配置

在配置文件 C:\Users\<你的用户名>\.openclaw\openclaw.json 的 tools.web.search 中需包含：

• provider: "kimi"
• kimi.apiKey: 你的 Moonshot API Key（完整，含 sk-）
• kimi.baseUrl: "https://api.moonshot.cn/v1"（国内必须，否则易 401）

若 Kimi 搜索长期出现 401，可改用 Brave Search 或改用「自带浏览器」做搜索（见第八节）。

6.3 用命令行配置 web_search

openclaw configure --section web

按提示选择提供商（Kimi、Brave、Perplexity、Gemini、Grok 等）并填写 API Key，保存后执行：

openclaw gateway restart

6.4 只使用本地浏览器搜索、不用 API 搜索

若希望搜索只走本地 Chrome 浏览器、不走 Kimi/Brave 等 API，可在 openclaw.json 的 tools.web.search 中设置：

"search": {
  "enabled": false,
  ...
}

保存后 openclaw gateway restart。此时智能体做搜索时会使用 browser 工具（需先按第八节启动托管浏览器）。

七、Skills 与 Hooks

7.1 是否配置 Skills

建议选 Yes，便于后续使用代码、API、笔记等能力。

7.2 代码相关推荐技能

建议勾选：

• github：GitHub 仓库、Issue、PR 等。
• xurl：发 HTTP 请求、调 API、测接口。
• 1password：密码/密钥管理。
• obsidian：本地 Markdown 笔记。
• summarize：文本摘要，看长文档时有用。

按需可加：openai-whisper（语音）、oracle、gemini、video-frames、nano-pdf 等。

7.3 技能依赖与 goplaces

• Install missing skill dependencies：若只有 Skip，可先选 Skip for now，需要时再装。
• Set GOOGLE_PLACES_API_KEY for goplaces：仅在做地图/地点相关功能时需要；一般开发选 No 即可。

7.4 Hooks

• 首次可选 Skip for now。
• 若希望 /new、/reset 时自动保存会话记忆，可勾选 session-memory。

7.5 启动方式

• Hatch in TUI (recommended)：在当前终端以文字界面与机器人对话。
• Open the Web UI：在浏览器中聊天与管理。
• Do this later：暂不启动，稍后手动启动。

八、关闭、重启与日常命令

8.1 关闭

• 前台运行（如 TUI）：在运行 OpenClaw 的终端按 Ctrl+C。
• 后台网关：在 PowerShell 中执行
  openclaw gateway stop

8.2 重启

openclaw gateway restart

或先 openclaw gateway stop，再 openclaw gateway start。调试时可用 openclaw gateway run，用 Ctrl+C 结束。

8.3 修改配置后是否要重启

• 修改 API Key（如 auth-profiles.json 或 openclaw.json 中的 key）：建议执行一次 openclaw gateway restart。
• 仅改 openclaw.json 中部分项：有的会热重载，但不保证全部生效，拿不准时同样建议 restart。

8.4 常用命令速查

九、自带浏览器搜索（本地 Chrome）

若希望用本机 Chrome 做「打开网页再搜索」、而不依赖或补充 web_search API，可按本节配置。

9.1 配置文件位置

C:\Users\<你的用户名>\.openclaw\openclaw.json

9.2 browser 配置示例

"browser": {
  "enabled": true,
  "defaultProfile": "openclaw",
  "headless": false,
  "executablePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
  "profiles": {
    "openclaw": {
      "cdpPort": 18800,
      "color": "#FF4500"
    }
  }
}

• executablePath：本机 Chrome 路径，常见为 C:\Program Files\Google\Chrome\Application\chrome.exe，若安装在其他盘请改为实际路径（JSON 中反斜杠写为 \\）。
• defaultProfile：使用名为 openclaw 的托管浏览器配置。

9.3 允许智能体使用浏览器工具

在 openclaw.json 的 tools 中确保有：

"alsoAllow": ["browser"]

这样在保持 profile: "coding" 等配置时，智能体也能使用 browser 工具。

9.4 启动托管浏览器（重要）

在 OpenClaw 2026.3.13 中，CLI 命令 openclaw browser --browser-profile openclaw start 可能因 WebSocket 问题报 gateway closed (1000)。推荐用 HTTP 方式 启动：

在 PowerShell 中执行（将 <token> 换成你 openclaw.json 里 gateway.auth.token 的值）：

Invoke-RestMethod -Uri "http://127.0.0.1:18791/start?profile=openclaw" -Method POST -Headers @{ "Authorization" = "Bearer <token>" }

若在 CMD 中：

• 要么先打开 PowerShell 再执行上述命令；
• 要么在 CMD 中执行：
  powershell -Command "Invoke-RestMethod -Uri 'http://127.0.0.1:18791/start?profile=openclaw' -Method POST -Headers @{ 'Authorization' = 'Bearer <token>' }"
• 若本机有 curl：
  curl -X POST -H "Authorization: Bearer <token>" "http://127.0.0.1:18791/start?profile=openclaw"

执行成功后，会弹出由 OpenClaw 控制的 Chrome 窗口（橙色主题），智能体即可用该窗口进行「用浏览器搜索」类任务。

9.5 使用方式

在飞书或 TUI 中对机器人说例如：

• 「用浏览器打开百度，搜索最新的 AI 新闻」
• 「用 Chrome 打开谷歌搜索 xxx」

确保：网关已运行，且已按上一步启动托管浏览器。

十、故障排查

10.1 API rate limit reached

• 含义：Moonshot/Kimi API 被限流，不是程序错误。
• 处理：等几分钟再试；到 Moonshot 控制台 查看用量/配额；减少请求频率；必要时升级套餐或换 Key。

10.2 无法访问网络 / 搜索 401

• 先确认本机网络：在 PowerShell 中测试
  Invoke-WebRequest -Uri "https://api.moonshot.cn/v1/models" -Headers @{ "Authorization" = "Bearer sk-你的Key" } -UseBasicParsing
• 需要代理时：在启动 OpenClaw 之前在同一终端设置（端口按实际修改）：
  $env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
• Kimi 搜索 401：确认 kimi.baseUrl 为 https://api.moonshot.cn/v1，且 apiKey 完整含 sk-；若仍 401，可改用 Brave Search 或关闭 web_search、改用自带浏览器搜索。

10.3 重启时报错

• 「不识别 agents.defaults.tools」：当前版本可能不支持该段，从 openclaw.json 中删除 agents.defaults.tools 整段；web 相关由顶层 tools.web 控制即可。
• 「plugin not found: moonshot」：删除 openclaw.json 中的 plugins.entries.moonshot 整段；Kimi 网页搜索使用 tools.web.search.kimi 配置即可。
• Port 18789 is already in use：先执行 openclaw gateway stop，等几秒再 openclaw gateway start。若仍占用，可：
  netstat -ano | findstr :18789
  记下 PID 后：
  taskkill /PID <PID> /F
  再执行 openclaw gateway start。

10.4 apply_patch、cron allowlist 等警告

多为 coding 配置引用了本环境未安装的工具，一般可忽略；若想减少警告，可将 tools.profile 改为 minimal（会减少部分高级工具）。

10.5 网络与防火墙

• 若公司/学校网络限制访问外网，需管理员放行或使用允许的出口。
• Windows 防火墙可尝试为 Node.js 或运行 openclaw 的进程放行出站（「允许应用通过防火墙」）。

十一、配置路径与 web_search 速查

十二、推荐安装与配置顺序小结

1. 安装 Node.js、npm、Git，并配置 Git 使用 HTTPS（见 2.1）。
2. 执行 npm install -g openclaw@latest，确认 openclaw 可用。
3. 执行 openclaw onboard --install-daemon，按向导：
   • 模型选 Moonshot AI (Kimi K2.5)，API Key 带 sk-；
   • 飞书选 Use local plugin path → Enter App Secret → WebSocket → Allowlist 或 Open；
   • 网页搜索选 Kimi 或 Brave 或 Skip（国内 Kimi 务必配 baseUrl）；
   • Skills 按需勾选（代码相关建议 github、xurl、1password、obsidian、summarize）；
   • Hooks 可 Skip 或选 session-memory；
   • 启动方式选 Hatch in TUI 或 Web UI。
4. 飞书若出现 pairing 提示，在本机执行 openclaw pairing approve feishu <配对码>。
5. 若用自带浏览器搜索：在 openclaw.json 配好 browser 与 tools.alsoAllow: ["browser"]，用 PowerShell 通过 HTTP 启动托管浏览器；若只走浏览器搜索，将 tools.web.search.enabled 设为 false。
6. 修改 API Key 或重要配置后执行 openclaw gateway restart。

按以上顺序操作，即可在 Windows 上完成 OpenClaw 的安装与常用配置。遇到具体报错时，可对照「十、故障排查」和「十一、配置路径与 web_search 速查」逐项检查。

十三、json配置

{
  "meta": {
    "lastTouchedVersion": "2026.3.13",
    "lastTouchedAt": "2026-03-18T06:15:18.848Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-18T06:15:18.792Z",
    "lastRunVersion": "2026.3.13",
    "lastRunCommand": "configure",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {
      "moonshot:default": {
        "provider": "moonshot",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 256000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      },
      "models": {
        "moonshot/kimi-k2.5": {
          "alias": "Kimi"
        }
      },
      "workspace": "C:\\Users\\user\\.openclaw\\workspace"
    }
  },
  "tools": {
    "profile": "coding",
    "alsoAllow": ["browser"],
    "web": {
      "search": {
        "enabled": false,
        "provider": "kimi",
        "kimi": {
          "apiKey": "sk-xxxx...",
          "baseUrl": "https://api.moonshot.cn/v1"
        }
      },
      "fetch": {
        "enabled": true
      }
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxx",
      "appSecret": "xxxx",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open"
    }
  },
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "headless": false,
    "executablePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      }
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "xxxx"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "contacts.add",
        "calendar.add",
        "reminders.add",
        "sms.send"
      ]
    }
  },
  "plugins": {
    "load": {
      "paths": [
        "C:\\Users\\user\\AppData\\Roaming\\nvm\\v22.19.0\\node_modules\\openclaw\\extensions\\feishu"
      ]
    },
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}