跳到主要内容Windows + WSL + Ubuntu 安装 OpenClaw 及配置飞书与百炼模型 | 极客日志Shell / BashNode.jsAI
Windows + WSL + Ubuntu 安装 OpenClaw 及配置飞书与百炼模型
Windows 下通过 WSL 和 Ubuntu 环境部署 OpenClaw，集成飞书机器人及阿里云百炼模型。步骤涵盖 WSL 安装、Node.js 环境配置、OpenClaw 初始化、飞书插件安装与权限设置、回调事件配置以及百炼模型接入。支持子 Agent 创建与多模型管理。
一、安装 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 终端。
二、安装基础组件
更新系统：
apt update && apt upgrade -y
sudo
sudo
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
2 安装 Node
nvm install 22
nvm use 22
四、安装 OpenClaw
npm install -g openclaw@latest
openclaw onboard --install-daemon
五、OpenClaw 初始化配置
初始化方式，选择快速启动（QuickStart）。
选择大模型，百炼不在这些选项中，先选择最后一个选项 Skip for now 跳过，之后再设置。
选择大模型提供商，先选不限提供商 All providers。
选择默认模型，这里选第一个保持当前选项（默认）就好。
搜索提供商，我们之后用本地浏览器搞，直接跳过。配置本地浏览器。
六、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
十、飞书权限配置（注意先做好飞书机器人设置，再配置 channel）
{"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 和密钥同样在飞书开放平台获取。
对话模式，这里选 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 这个键内修改默认模型：
例如：
如果需要多模型，则在 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
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
- Markdown转HTML
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
- HTML转Markdown
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
