1. 项目概述：为什么“小龙虾”在 Windows 上非得走 WSL2 这条路？

OpenClaw，圈内人戏称“小龙虾”，不是水产养殖项目，而是一个正在快速崛起的开源 AI 智能体（Agent）框架。它的核心价值不在于“聊得多好”，而在于“做得多实”——你能用自然语言告诉它“把上周五所有带‘报销’字样的邮件附件下载到桌面，重命名成‘Q2-差旅-日期’格式，再发给财务部张经理”，它真能一步步拆解、调用邮箱 API、文件系统、甚至 Outlook 客户端，把这事办妥。这种“任务自动化执行”的能力，让它和 ChatGPT、Claude 这类纯对话模型划开了本质界限。

但问题来了：OpenClaw 的底层是 Node.js，大量依赖项（比如 node-gyp 编译的原生模块、 sqlite3 、 sharp 图像处理库）在 Windows 原生环境下就是个“雷区”。我试过直接在 PowerShell 里 npm install ，光是 windows-build-tools 就能卡住半小时，最后报错 MSBUILD : error MSB4132: The tools version "17.0" is unrecognized ，查了一下午才发现是 VS Build Tools 版本和 .NET SDK 不匹配。更别提路径分隔符（ / vs \ ）、权限模型（UAC 和 Linux UID/GID 完全两套逻辑）、还有那些只在 POSIX 环境下才稳定的进程管理机制。官方文档里那句“Windows 支持有限”不是客套话，是血泪教训后的免责声明。

所以，当热搜词里反复出现 “wsl2安装”、“wsl2是啥”、“wsl1无法切换成 wsl2”，这背后是无数 Windows 用户在原生环境碰壁后集体转向的务实选择。WSL2 不是权宜之计，而是目前最干净、最稳定、最接近生产环境的方案。它本质上是在 Windows 内核上跑了一个轻量级的 Linux 虚拟机，拥有完整的 Linux 内核、独立的网络栈、标准的 /usr/bin 生态。你装的不是“兼容层”，而是一个货真价实的 Ubuntu 系统，只是它和你的 Windows 文件系统（ /mnt/c/ ）无缝打通了。这意味着：Node.js 的 npm install 不再报编译错误； openclaw gateway start 启动的服务能被正确守护； openclaw logs follow 输出的日志格式规整，没有乱码。这不是妥协，是回归技术本质——让每个组件在它最擅长的土壤里生长。如果你手头是一台 Win11 笔记本，内存 16GB，那么这套方案的成本就是零，时间成本是 45 分钟，而换来的是一个可长期维护、可随时扩展技能的本地 AI 助理。这才是“OpenClaw 小龙虾 Windows 系统安装部署完整指南”存在的全部意义。

2. 环境准备：从 BIOS 到 Ubuntu 终端，每一步都踩过坑

2.1 Windows 11 前置检查：别让 BIOS 成为第一道墙

很多人卡在第一步，不是命令不会敲，而是电脑压根没“开闸”。WSL2 依赖硬件虚拟化，这玩意儿默认是关着的。你不能指望在 Windows 设置里点几下就打开，它藏在 BIOS/UEFI 的深处。

• 系统版本 ：必须是 Windows 11 22H2 或更新版。Win10 用户请止步，不是不能装，是后续会遇到 wsl --install 命令不存在、或者装完启动失败的问题。微软对 WSL2 的支持在 Win11 上才真正成熟。
• 内存 ：8GB 是底线，但强烈建议 16GB。WSL2 默认会动态分配内存，但上限是物理内存的一半。OpenClaw 本身不占多少，但你装的 Node.js、Ubuntu 系统、以及未来可能加的 Redis、PostgreSQL 这些服务，加起来轻松吃掉 4GB。我见过太多用户装完 Ubuntu，一 apt update 就卡死，最后发现是 WSL2 因内存不足触发了 OOM Killer。
• BIOS 设置 ：这是最常被忽略的环节。重启电脑，狂按 F2 （联想）、 Del （华硕）、 F10 （惠普）或 Esc （戴尔），进 BIOS。找到 Advanced -> CPU Configuration 或 Security -> System Security ，把 Intel Virtualization Technology (VT-x) 或 AMD-V 打开。有些品牌叫 SVM Mode 。保存退出。如果你不确定，开机时看屏幕右下角闪过的厂商 Logo，按提示键进 BIOS，搜索关键词 virtualization 。这一步不做，后面所有命令都会返回 Operation not permitted 。

2.2 启用 Windows 核心功能：三个勾选框，缺一不可

别信网上说的“只开‘适用于 Linux 的 Windows 子系统’就行”。那是 WSL1，性能差、不支持 systemd、很多 OpenClaw 依赖的 Docker 工具链跑不起来。

• 按 Win + S ，搜“Windows 功能”，点开“启用或关闭 Windows 功能”。
• 必须勾选三项：
  1. 虚拟机平台 （Virtual Machine Platform）：这是 WSL2 的底层驱动，提供 Hyper-V 的轻量级虚拟化能力。
  2. Windows 虚拟机监控程序平台 （Windows Hypervisor Platform）：让第三方虚拟机（如 Docker Desktop）也能共用这个内核，避免冲突。
  3. 适用于 Linux 的 Windows 子系统 （Windows Subsystem for Linux）：这个才是你最终要操作的界面。

提示：勾完点确定，系统会提示重启。别偷懒点“稍后重启”，一定要立刻重启。我见过有用户重启后忘了进 BIOS 开 VT-x，结果 WSL2 启动报错 WslRegisterDistribution failed: 0x80370102 ，折腾半天才发现是 BIOS 没开。

2.3 安装 WSL2 与 Ubuntu：一条命令背后的玄机

重启后，右键“开始菜单”，选“Windows PowerShell（管理员）”。注意，必须是“管理员”，普通用户权限会提示 Access is denied 。

• 执行 wsl --install -d Ubuntu 。这条命令看似简单，背后做了三件事：
  1. 自动下载并安装最新版 WSL2 内核更新包（ wsl_update_x64.msi ）。
  2. 从 Microsoft Store 下载并安装 Ubuntu 发行版（默认是 Ubuntu 22.04 LTS，长期支持版，稳定性远超 24.04）。
  3. 将 Ubuntu 设为默认发行版，并完成初始化配置。

安装完成后，系统会自动弹出一个 Ubuntu 终端窗口。这时，它会要求你创建一个 Linux 用户。 关键点来了 ：用户名不要用中文，也不要叫 admin 、 root 或 administrator 。我建议就叫 claw 或 openclaw 。密码可以设简单点，因为这是你自己的本地环境，但千万别留空。这一步输错，后面所有 sudo 命令都会失败。

验证是否成功？回到 PowerShell，输入 wsl -l -v 。你会看到类似这样的输出：

  NAME      STATE           VERSION
* Ubuntu    Running         2

那个 VERSION 列的 2 ，就是你要找的金子。如果显示 1 ，说明你装的是旧版，需要手动升级： wsl --set-version Ubuntu 2 。

2.4 更新系统与基础工具：别急着装 OpenClaw，先给 Ubuntu “洗洗澡”

刚装好的 Ubuntu 是个“裸机”，软件源还是国外的， apt update 会慢得让你怀疑人生。而且，很多基础编译工具是缺失的， node-gyp 一上来就要用。

• 在 Ubuntu 终端里，先换国内源。编辑源列表： sudo nano /etc/apt/sources.list 。把里面所有 archive.ubuntu.com 和 security.ubuntu.com 替换成 mirrors.tuna.tsinghua.edu.cn/ubuntu/ 。保存退出（ Ctrl+O , Enter , Ctrl+X ）。
• 执行 sudo apt update && sudo apt upgrade -y 。这一步会下载几百 MB 更新，耐心等。完成后，装上基础编译套件： sudo apt install -y build-essential curl git python3-pip 。 build-essential 包含了 gcc 、 g++ 、 make ，是 node-gyp 的命根子； curl 是后面下载安装脚本的必备； git 是未来管理 OpenClaw 配置的利器； python3-pip 是 Python 生态的入口，虽然 OpenClaw 主要用 Node，但很多 Skill 插件（比如 PDF 解析）会调用 Python 脚本。

注意： sudo apt upgrade -y 里的 -y 参数很重要，它代表“自动确认所有 yes/no 提问”。如果不加，升级过程中会卡在“是否要删除旧内核？”这种问题上，你人在外面，回来一看终端还停在那儿，以为挂了。

3. 核心部署：Node.js、OpenClaw 与 Onboarding 的深度解析

3.1 Node.js 环境：为什么非得用 nvm，而不是官网 MSI？

OpenClaw 官方明确要求 Node.js v22 LTS（代号 Pumice ）。你去官网下载 Windows 版 MSI 安装包，装完一试 node -v ，发现是 v20，或者更糟，是 v18。这是因为 Windows 的 PATH 环境变量里可能残留着旧版本，或者 MSI 安装器默认不覆盖。手动删旧版、改 PATH，风险高、易出错。

nvm（Node Version Manager）是 Linux/macOS 下的标准解法，它把不同版本的 Node.js 安装在 $HOME/.nvm/versions/node/ 下，通过软链接 node 指向当前激活版本。好处是：

• 隔离性 ： nvm use 22 只影响当前终端，不影响全局。
• 可逆性 ： nvm uninstall 20 一键清理，不留垃圾。
• 灵活性 ：未来 OpenClaw 升级要求 v24， nvm install 24 一行搞定。

安装步骤：

# 下载并执行安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 让 nvm 立即生效（这行命令必须执行，否则下一步会报 command not found）
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# 安装 v22 LTS 并设为默认
nvm install --lts
nvm alias default 'lts/*'

# 验证
node -v  # 应输出 v22.x.x
npm -v   # 应输出 10.x.x

实操心得： curl 命令如果报 command not found ，说明你没装 curl ，回退到 2.4 节补装。 nvm install --lts 如果卡住，大概率是网络问题，此时执行 npm config set registry https://registry.npmmirror.com 换淘宝镜像，再重试。 nvm alias default 这一步不能省，否则新开一个终端， node -v 还是找不到。

3.2 一键安装 OpenClaw：脚本背后的安全与信任

curl -fsSL https://openclaw.ai/install.sh | bash 这条命令，是整个部署流程的“心脏”。 -f 表示失败不静默， -s 是静默模式（不显示下载进度）， -S 是即使静默也显示错误， L 是跟随重定向。它把远程脚本下载下来，直接喂给 bash 执行。

这个脚本干了什么？

• 检查系统是否满足最低要求（Node.js 版本、磁盘空间）。
• 创建 ~/.openclaw 目录，作为所有配置、数据、插件的家。
• 从 GitHub Releases 下载预编译的 openclaw CLI 二进制文件（Linux x64），放在 /usr/local/bin/ 下，这样 openclaw 命令才能全局使用。
• 安装核心依赖包（ @openclaw/core 、 @openclaw/gateway ）到 ~/.openclaw/node_modules 。
• 最后，它会尝试运行 openclaw onboard 。

注意： | bash 是高危操作，意味着你完全信任这个脚本的内容。所以，务必确认 URL 是 https://openclaw.ai/ （官方域名），而不是某个钓鱼网站。你可以先 curl -fsSL https://openclaw.ai/install.sh 把脚本内容拉下来，用 less 命令看看里面有没有可疑的 rm -rf / 或 curl http://xxx/malware.sh | bash 。安全第一。

3.3 Onboarding 初始化：每一个选项背后的业务逻辑

openclaw onboard 不是填空游戏，而是一次架构设计。它问的每个问题，都在为你未来的使用方式埋下伏笔。

• “I understand this is powerful and inherently risky. Continue?”
  这不是废话。OpenClaw 一旦拿到你的 API Key，就能以你的名义调用所有付费 API，产生真实费用。它还能读写你的文件系统（ /home/claw/ 下的所有内容）。所以，这里必须打 Yes ，表示你已知悉风险。

• 选择 AI 模型提供商 ：
  这决定了你的“大脑”在哪。 glm （智谱）和 dashscope （阿里云百炼）是国产首选，延迟低、合规性好。 openai 和 anthropic 需要科学上网，且 Key 申请流程复杂。如果你选了 openai ，但网络不通， openclaw gateway start 会一直卡在 Connecting to LLM provider... 。新手强烈建议从 dashscope 开始。获取 Key 的路径：登录阿里云控制台 -> 百炼 -> 密钥管理 -> 创建 AccessKey ID/Secret。

• 输入 API Key ：
  这里粘贴的是 Secret Key，不是 AccessKey ID。Key 会以明文形式存入 ~/.openclaw/config.json 。所以，确保你的 Ubuntu 用户（ claw ）权限是 700 （ chmod 700 ~/.openclaw ），防止其他用户窃取。

• 选择消息渠道 ：
  Skip 是最稳妥的选择。 onboard 流程里提供的 Slack、Discord 配置，都是针对公网服务器的。你在 WSL2 里跑，没有公网 IP，配了也收不到消息。飞书、钉钉这些国内 IM，官方有专门的插件，后面单独配置更可靠。

• Skills 和 Hooks ：
  Skills 是 OpenClaw 的“手脚”，比如 file-manager （管理文件）、 web-search （联网搜索）。新手选 No ，因为每个 Skill 都要额外配置（API Key、权限），装多了反而让系统变慢。 Hooks 是“记忆”， session-memory 是必选，它让 AI 记住你上一句话问了什么，实现连贯对话。 redis Hook 更强大，但需要额外装 Redis 服务，对新手是负担。

完成所有步骤，它会自动启动 gateway 服务，并尝试打开浏览器。如果失败，别慌，这是 WSL2 的网络特性导致的。

4. 服务管理与 Web 控制台：如何让 localhost 在 Windows 里“活”过来

4.1 访问 Web 控制台：127.0.0.1 的迷思与破局之道

openclaw dashboard 命令生成的链接通常是 http://127.0.0.1:18789 。这个地址在 WSL2 里是通的，但在 Windows 的 Chrome 里打不开，因为 127.0.0.1 对 Windows 来说，指的是 Windows 自己的回环地址，不是 WSL2 的。WSL2 有自己的虚拟网卡，IP 是动态分配的，比如 172.28.128.100 。

解决方法有两个，我推荐后者，因为它一劳永逸：

• 临时方案（适合调试） ：在 WSL2 终端里，执行 ip addr show eth0 | grep "inet " | awk '{print $2}' | cut -d/ -f1 。这会输出 WSL2 的 IP 地址。然后在 Windows 浏览器里访问 http://172.28.128.100:18789 。但问题是，每次重启 WSL2，这个 IP 都会变，你得重新查。

• 永久方案（推荐） ：利用 Windows 的端口转发功能，把 Windows 的 127.0.0.1:18789 映射到 WSL2 的对应端口。在 PowerShell（管理员） 里执行：

  # 先查 WSL2 的 IP
  $wslIp = wsl hostname -I | ForEach-Object {$_.Trim()}
  # 添加端口转发
  netsh interface portproxy add v4tov4 listenport=18789 listenaddress=127.0.0.1 connectport=18789 connectaddress=$wslIp
  

  这样，以后无论 WSL2 IP 怎么变，你在 Windows 浏览器里永远只需访问 http://127.0.0.1:18789 。为了确保开机自启，可以把上面的命令保存为 wsl-portforward.ps1 ，然后在 Windows 启动文件夹里放个快捷方式。

4.2 管理 OpenClaw 服务：不只是 start/stop，而是理解生命周期

OpenClaw 的核心服务叫 gateway ，它是个后台守护进程，负责接收消息、调度 Skills、调用 LLM。你不能把它当成一个普通的 Node.js 脚本。

• openclaw status ：这是你的“健康检查仪”。它会告诉你 gateway 是 running 还是 stopped ，以及它监听的端口、PID（进程 ID）。如果状态是 unknown ，说明服务根本没启动，或者配置文件损坏。

• openclaw gateway start ：启动服务。它会在后台运行，不会占用当前终端。启动后， openclaw status 会显示 PID。

• openclaw gateway restart ：这是最常用的命令。当你修改了 ~/.openclaw/config.json ，或者安装了新插件，必须重启才能生效。它会先 stop ，再 start ，确保干净。

• openclaw logs follow ：这是排错神器。它会实时输出 gateway 的日志流。如果服务启动失败，日志里第一行通常就是错误原因，比如 Error: Cannot find module 'sqlite3' （缺少 SQLite3 模块）或 Error: getaddrinfo ENOTFOUND api.dashscope.aliyuncs.com （网络不通）。按 Ctrl+C 可以退出日志流。

实操心得： openclaw logs follow 的输出里，如果看到 Gateway started on http://localhost:18789 ，说明服务已就绪。如果看到 LLM provider initialized ，说明 API Key 验证通过。这两行是成功的黄金标志。

5. 高级集成：飞书机器人接入的全流程与避坑指南

5.1 安装飞书插件： @m1heng-clawd/feishu 的来历

openclaw plugins install @m1heng-clawd/feishu 这条命令，是从 npm 官方仓库安装一个由社区开发者 m1heng 维护的飞书适配器。它不是一个官方插件，但经过了大量用户验证，是目前最稳定的方案。

这个插件的作用，是把飞书开放平台的事件回调协议，翻译成 OpenClaw 内部能理解的 message 事件。它处理了签名验证、消息解密、事件路由等所有底层细节，你只需要关心“收到消息后，AI 怎么回复”。

安装过程会自动下载依赖，并在 ~/.openclaw/plugins/ 下创建一个 feishu 目录。安装完成后， openclaw plugins list 会显示它已启用。

5.2 飞书开放平台配置：长连接是唯一可行之路

飞书机器人的接入，核心在于“怎么让飞书的消息，送到你本地的 WSL2 里”。传统方案是“公网回调”，即你得有个公网 IP 和域名，把 https://yourdomain.com/webhook 填到飞书后台。这对个人用户不现实。

飞书提供了“长连接”方案，这是为本地开发量身定做的。它的工作原理是：OpenClaw 的 feishu 插件会主动连接飞书的长连接服务器，建立一个持久化的 WebSocket 连接。所有飞书消息，都通过这个连接推送给你的本地服务。

配置步骤：

• 登录 飞书开放平台 ，点击“创建企业自建应用”。
• 应用名称随意，比如“我的AI助理”。
• 进入“应用能力” -> “添加应用能力” -> “机器人”，开启机器人。
• 进入“权限管理” -> “批量导入权限”，粘贴官方文档提供的 JSON（包含 im:message 等权限）。
• 进入“事件与回调”，订阅 im.message.receive_v1 事件。
• 最关键的一步 ：在“事件与回调”页面，把“接收方式”从默认的“HTTP 回调”改成“使用长连接接收事件”。这个选项藏得很深，就在“HTTP 回调”开关的旁边，是个小按钮。

注意：订阅事件后，必须点击右上角的“发布”按钮。不发布，所有配置都是草稿，飞书不会推送任何消息。我见过太多用户卡在这一步，反复检查代码，最后发现是没点“发布”。

5.3 连接与测试：配对码机制的精妙设计

openclaw channels add 命令会引导你输入飞书应用的 App ID 和 App Secret 。这两个值在“凭证与基础信息”页面里， App Secret 是灰色的，需要点击“显示”才能看到。

输入完成后，执行 openclaw gateway restart 。重启后， openclaw logs follow 里会看到 Feishu plugin connected successfully 的日志。

测试：

• 在飞书客户端，搜索你的应用名称，进入聊天窗口。
• 发送任意消息，比如“你好”。
• 机器人会立刻回复一个 6 位数字的“配对码”（Pairing Code）。
• 打开 http://127.0.0.1:18789 ，在 Web 控制台的“Channels”页面，找到飞书渠道，点击“Bind”，输入这个配对码。
• 点击“Confirm”，绑定完成。

实操心得：配对码有 5 分钟有效期。如果超时，飞书会再发一个。绑定成功后，在 Web 控制台的“Channels”页面，状态会变成 Connected ，并且显示当前在线的飞书用户。这时，你就可以在飞书里直接问“今天北京天气怎么样？”，OpenClaw 会调用天气 Skill，给你一个图文并茂的回复。

6. 常见问题与排查技巧实录：那些没写在文档里的真相

6.1 “openclaw: command not found” —— PATH 的幽灵

这是新手遇到的第一大拦路虎。明明 install.sh 脚本说安装成功了，但一敲 openclaw 就报错。

根本原因 ： install.sh 把 openclaw 二进制文件放到了 /usr/local/bin/ ，但你的 Ubuntu 用户的 PATH 环境变量里没有包含这个路径。 /usr/local/bin 是 Linux 的标准位置，但某些精简版 Ubuntu 镜像会把它去掉。

解决方案 ：

1. 检查 PATH ： echo $PATH ，看输出里有没有 /usr/local/bin 。
2. 如果没有，把它加进去： echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc 。
3. 重新加载： source ~/.bashrc 。
4. 验证： which openclaw ，应该输出 /usr/local/bin/openclaw 。

注意： source ~/.bashrc 只对当前终端生效。新开一个终端，还得再执行一次。一劳永逸的办法是把 export PATH=... 这行加到 ~/.profile 里，它会在每次登录时自动加载。

6.2 WSL2 网络不稳定，DashScope API 调用超时

openclaw logs follow 里反复出现 Request timeout 或 getaddrinfo ENOTFOUND 。

排查思路 ：

• 先确认网络：在 WSL2 终端里 ping api.dashscope.aliyuncs.com 。如果 ping 不通，说明是 DNS 问题。
• 检查 DNS： cat /etc/resolv.conf 。如果 nameserver 是 172.x.x.x （WSL2 的 DNS），把它改成 8.8.8.8 或 114.114.114.114 。
• 如果 ping 通但 API 还是超时，可能是 TLS 证书问题。执行 curl -v https://api.dashscope.aliyuncs.com ，看是否卡在 SSL handshake 。如果是，执行 sudo apt install ca-certificates 更新证书库。

6.3 飞书机器人“已上线”但无任何回复

日志里能看到 Feishu plugin connected successfully ，但飞书发消息，OpenClaw 完全没反应。

终极排查清单 ：

1. 检查飞书后台 ：是否“发布”了应用？是否订阅了 im.message.receive_v1 ？是否开启了“长连接”？
2. 检查 OpenClaw 日志 ： openclaw logs follow 里，发送消息后，是否有 Received message from Feishu 这样的日志？没有，说明长连接根本没收到消息，问题在飞书侧。
3. 检查配对状态 ：Web 控制台里，飞书渠道的状态是 Connected 还是 Pending ？ Pending 说明配对码没输对，或者超时了。
4. 检查 Skill 状态 ：在 Web 控制台的 “Skills” 页面， text-generation （文本生成）这个核心 Skill 是否是 Enabled ？如果被禁用了，AI 就不会思考，只会沉默。

6.4 WSL2 启动慢、占用内存高

每次 wsl 命令都要等 10 秒， htop 一看，内存占了 3GB。

优化方案 ：

• 编辑 WSL2 配置文件： sudo nano /etc/wsl.conf ，添加：

  [wsl2]
  memory=2GB   # 限制最大内存
  processors=2 # 限制 CPU 核数
  swap=0       # 关闭 swap，避免硬盘狂转
  localhostForwarding=true
  

• 重启 WSL2：在 PowerShell 里执行 wsl --shutdown ，然后重新打开 Ubuntu 终端。

个人体会：我在一台 16GB 内存的 Win11 笔记本上，把 WSL2 内存限制在 2GB，OpenClaw + 飞书插件 + Redis（后续加的）一起跑，系统响应依然流畅。关键是， wsl --shutdown 这个命令要养成习惯，不用的时候关掉，它不会自动释放内存。

7. 后续演进与技能扩展：从“能用”到“好用”的跃迁

装完 OpenClaw，只是万里长征第一步。它的真正价值，在于“可编程性”。官方文档里提到的 openclaw skill ，指的就是这个。

• 安装一个实用 Skill ：比如 @openclaw/skill-file-manager ，它能让 AI 理解“把桌面上的合同.pdf 发给我”。安装命令： openclaw skills install @openclaw/skill-file-manager 。安装后，在 Web 控制台的 “Skills” 页面启用它。这个 Skill 会自动扫描你的 ~/Downloads 和 ~/Desktop 目录，建立索引。

• 自定义一个 Skill ：OpenClaw 的 Skill 是用 TypeScript 写的。你可以新建一个目录 my-skill ，写一个 index.ts ，导出一个 execute 函数，里面写 console.log("Hello from my custom skill!") 。然后 openclaw skills link ./my-skill ，它就会被加载。这是你打造专属工作流的起点。

• 对接本地服务 ：OpenClaw 的 gateway 本身就是一个 HTTP 服务。你可以用 curl 直接调用它： curl -X POST http://127.0.0.1:18789/api/v1/chat/completions -H "Content-Type: application/json" -d '{"messages": [{"role": "user", "content": "你好"}]}' 。这意味着，你可以把它嵌入到你自己的 Electron 桌面应用、或者用 Python Flask 写一个 Web 前端。

最后分享一个小技巧：OpenClaw 的配置文件 ~/.openclaw/config.json 是纯文本。你可以用 nano 或 vim 直接编辑它，比如把 llm.provider 从 dashscope 改成 glm ，把 llm.model 从 qwen-max 改成 glm-4-flash ，改完 openclaw gateway restart 就生效。不需要重跑 onboard 。这种“所见即所得”的配置方式，让它比那些动辄要改 YAML、重启整个 Docker Compose 的方案，友好太多了。

我在实际使用中发现，OpenClaw 最大的魅力，不是它现在能做什么，而是它为你铺平了通往“自动化工作流”的道路。它不强迫你学 Python 或写 Shell 脚本，而是用你最熟悉的语言——中文，去指挥一个越来越聪明的助手。从“帮我查一下邮箱里有没有未读的报销邮件”，到“把这封邮件的附件转成 Markdown，总结重点，发到飞书群”，再到“根据这份会议纪要，生成下周的待办清单，并同步到我的 Notion 数据库”，每一步，都只需要你动动嘴。而这一切，都始于你在 WSL2 里敲下的那第一条 wsl --install 命令。