记录了在 Windows 环境下通过 WSL 和 Ubuntu 安装 OpenClaw 智能体框架的完整流程。内容涵盖 WSL 环境搭建、Node.js 与 NVM 安装、OpenClaw 初始化及 Hooks 配置。重点介绍了如何接入飞书机器人，包括权限申请、Channel 配置及回调事件设置，同时演示了百炼模型的接入方法与参数调整。此外还包含 OpenAI OAuth 登录及子 Agent 创建的进阶指南，适用于开发者快速搭建本地 AI 自动化工作流。
先在 PowerShell 执行：
wsl --update
wsl --status
wsl --version
wsl --set-default-version 2
wsl --list--verbose
安装 Ubuntu 22.04：
wsl --install Ubuntu-22.04
安装完成后打开 Ubuntu 终端。
更新系统：
sudo apt update && sudo apt upgrade -y
安装基础工具：
sudo apt install -y build-essential curl git unzip zip ca-certificates jq
额外安装 1Panel（解决 docker 环境问题）：
sudo bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
保存全局设置：
source ~/.bashrc
检查：
nvm --version
nvm install 22
nvm use 22
检查：
node --version
安装：
npm install -g openclaw@latest
检查版本：
openclaw --version
初始化：
openclaw onboard --install-daemon
询问是否在本机安装，选 yes。
![图片]
初始化方式，选择快速启动（QuickStart）。
![图片]
选择大模型，百炼不在这些选项中，先选择最后一个选项 Skip for now 跳过，之后再设置。
![图片]
选择大模型提供商，先选不限提供商 All providers。
![图片]
选择默认模型，这里选第一个保持当前选项（默认）就好。
![图片]
配置 channel，这个直接跳到最下面选跳过。
![图片]
搜索提供商，我们之后用本地浏览器搞，直接跳过。配置本地浏览器。
![图片]
询问是否现在配置 skill，跳过。
![图片]
这个选项很重要，选择 openclaw 的预设动作。
![图片]
网关页面的打开方式，webui 比较方便。
随后在控制台日志中的复制整串 url（带 token）。
![图片]
复制到浏览器打开即可。
![图片]
成功打开网关页面。
推荐 官方插件。
先安装飞书 SDK：
npm install -g @larksuiteoapi/node-sdk
再安装插件：
openclaw plugins install @openclaw/feishu
删除异常插件（谨慎操作）：
rm -rf ~/.openclaw/extensions/feishu
openclaw plugins install @m1heng-clawd/feishu
安装失败可以手动安装：
curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
openclaw plugins install ./feishu-0.1.3.tgz
在 飞书开放平台 创建应用，配置机器人能力。
![图片]
导入以下权限：
{"scopes":{"tenant":["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application.self_manage","application:bot.menu:write","base:app:copy","base:app:create","base:app:read","base:app:update","bitable:app","bitable:app:readonly","contact:contact.base:readonly","contact:department.base:readonly","contact:user.base:readonly","contact:user.employee_id:readonly","corehr:file:download","event:ip_list","im:chat","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:chat:read","im:chat:update","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource","sheets:spreadsheet","sheets:spreadsheet.meta:read","sheets:spreadsheet.meta:write_only","sheets:spreadsheet:create","sheets:spreadsheet:read","sheets:spreadsheet:readonly","sheets:spreadsheet:write_only"],"user":["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]}}
最后记得发布应用。
执行：
openclaw channels add
![图片]
选择飞书。
![图片]
选择输入 app 密钥，appid 和密钥同样在飞书开放平台获取。
![图片]
并粘贴到控制台中。
接下来：
![图片]
链接方式，选择长连接（WebSocket）。
![图片]
对话模式，这里选 open（不限制对话），（真正的对话权限可以到飞书控制台设置）。
接下来还有其他的一些选项：
| 配置项 | 说明 | 选择 |
|---|---|---|
| Feishu account | 飞书账号 | 选择 default |
| domain | 域名 | 根据区域选择（国内选 feishu，国际选 lark） |
选择完后这里会再跳一个 Select a channel 选项，我们跳到最下面选 Finished 就结束了。
接下来还有对这个 channel 的一些设置：
Configure DM access policies now? → 选 Yes，再选择 open，配置所有人可对话（也可以选 no 跳过，后续修改）
Add display names for these accounts? → 给 channel 加名字，选 No
Bind configured channel accounts to agents now? → 将这个 channel 配置给某个 agent，如果你有多个 agent 可以配置一下，这里我们选 no 跳过
![图片]
开启：长连接
添加事件：接收消息 im.message.receive_v1
openclaw gateway restart
编辑：
~/.openclaw/openclaw.json
添加 models：
"models":{"mode":"merge","providers":{"bailian":{"baseUrl":"https://coding.dashscope.aliyuncs.com/v1","apiKey":"${DASHSCOPE_API_KEY}","api":"openai-completions","models":[{"id":"qwen-plus","name":"Qwen Plus","input":["text","image"]}]}}}
请注意：此处 baseUrl 填写的是百炼 Coding Plan 的 url，百炼的普通 url 为
"baseUrl":"https://dashscope.aliyuncs.com/compatible-mode/v1"
随后在 agents.defaults.model.primary 这个键内修改默认模型：
例如：
bailian/kimi-k2.5
如果需要多模型，则在 agents.models 下配置：
"models":{"bailian/kimi-k2.5":{},"openai-codex/gpt-5.4":{}}
重启网关：
openclaw gateway restart
模型配置成功。
![图片]
若想配置（或重新配置）openaiGPT 且用网页登录认证（OAuth），则使用命令直接设置：
openclaw models auth login --provider openai-codex
使用：
openclaw agents add
可以进入交互式操作页面创建子 Agent。
也可以使用非交互式命令直接创建，基础格式（注意，一定要指定子 Agent 的 workspace）：
openclaw agents add <agent_id> --workspace <workspace_dir> --non-interactive
示例：
openclaw agents add Engineer --workspace ~/.openclaw/workspace-Engineer --model openai-codex/gpt-5.4 --non-interactive
高级设定模板：
openclaw agents add <agent_id> --workspace <workspace_dir> --agent-dir <agent_dir> --model <model> --bind feishu:default --non-interactive
至此 OpenClaw + 飞书 + 百炼模型部署完成。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online