跳到主要内容Windows + WSL + Ubuntu 安装 OpenClaw 及飞书百炼集成指南 | 极客日志JavaScriptNode.jsAI
Windows + WSL + Ubuntu 安装 OpenClaw 及飞书百炼集成指南
综述由AI生成详细记录了在 Windows 环境下通过 WSL 和 Ubuntu 安装 OpenClaw 智能体框架的完整流程。内容涵盖 WSL 环境搭建、Node.js 与 NVM 安装、OpenClaw 初始化配置、飞书机器人插件接入与权限设置、以及阿里云百炼模型的集成方法。此外还包括 Hooks 配置、Web UI 访问、飞书回调事件设置及子 Agent 创建等进阶步骤,旨在帮助用户快速构建基于飞书和百炼模型的自动化 AI 代理系统。
深海蔚蓝21 浏览 一、安装 WSL
先在 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)"
三、安装 Node.js(通过 nvm)
1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
保存全局设置:
source ~/.bashrc
检查:
nvm --version
2. 安装 Node
nvm install 22
nvm use 22
检查:
node --version
四、安装 OpenClaw
安装:
npm install -g openclaw@latest
检查版本:
openclaw --version
初始化:
openclaw onboard --install-daemon
五、OpenClaw 初始化配置
询问是否在本机安装,选 yes。

初始化方式,选择快速启动(QuickStart)。
选择大模型,百炼不在这些选项中,先选择最后一个选项 Skip for now 跳过,之后再设置。
选择大模型提供商,先选不限提供商 All providers。
选择默认模型,这里选第一个保持当前选项(默认)就好。
搜索提供商,我们之后用本地浏览器搞,直接跳过。配置本地浏览器 –> 使用 WSLg 或本地浏览器进行可视化操作。
六、Hooks 配置(重要)
这个选项很重要,选择 openclaw 的预设动作。
- 第一个选项是在 Gateway 启动时运行 BOOT.md,这个后期有需要自己加。
- 第二个是注入额外的工作区引导文件,后期再加。
- 第三个是把所有命令事件写到日志,这个必须开。
- 第四个保留对话上下文记忆,这个也要开。
七、打开 Web UI
网关页面的打开方式,webui 比较方便。
随后在控制台日志中的复制整串 url(带 token)。
八、安装飞书插件
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"]}}
十一、配置飞书 channel
选择输入 app 密钥,appid 和密钥同样在飞书开放平台获取。
接下来链接方式,选择长连接(WebSocket)。
对话模式,这里选 open(不限制对话),(真正的对话权限可以到飞书控制台设置)。
| 配置项 | 说明 | 选择 |
|---|
| Feishu account | 飞书账号 | 选择 default |
| domain | 域名 | 根据区域选择(国内选 feishu,国际选 lark) |
选择完后这里会再跳一个 Select a channel 选项,我们跳到最下面选 Finished 就结束了。
- 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
十四、配置百炼模型
~/.openclaw/openclaw.json
"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":{}}
十五、OpenAI OAuth 登录
若想配置(或重新配置)openaiGPT 且用网页登录认证(OAuth),则使用命令直接设置:
openclaw models auth login --provider openai-codex
十六、创建子 Agent
使用 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 + 飞书 + 百炼模型部署完成。
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- 随机西班牙地址生成器
随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
- Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
- Escape 与 Native 编解码
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
- JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online