一、安装 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
Windows 下通过 WSL 和 Ubuntu 环境部署 OpenClaw,集成飞书机器人及阿里云百炼模型。步骤涵盖 WSL 安装、Node.js 环境配置、OpenClaw 初始化、飞书插件安装与权限设置、回调事件配置以及百炼模型接入。支持子 Agent 创建与多模型管理。
先在 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 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 的预设动作。
第一个选项是在 Gateway 启动时运行 BOOT.md,这个后期有需要自己加。 第二个是注入额外的工作区引导文件,后期再加。 第三个是把所有命令事件写到日志,这个必须开。 第四个保留对话上下文记忆,这个也要开。
网关页面的打开方式,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
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online