跳到主要内容JavaScriptNode.jsAI
Windows WSL Ubuntu 安装 OpenClaw 配置飞书与百炼模型全流程
在 Windows 环境下通过 WSL 和 Ubuntu 系统安装 OpenClaw 智能体框架的完整步骤。内容包括 WSL 安装、基础组件与 Node.js 环境配置、OpenClaw 初始化、飞书机器人插件接入及权限设置,以及阿里云百炼模型的集成配置。最终实现基于飞书渠道的 AI 助手功能。
利刃33 浏览 一、安装 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 初始化配置
初始化方式,选择快速启动(QuickStart)。
选择大模型,百炼不在这些选项中,先选择最后一个选项 Skip for now 跳过,之后再设置。
选择大模型提供商,先选不限提供商 All providers。
选择默认模型,这里选第一个保持当前选项(默认)就好。
搜索提供商,我们之后用本地浏览器搞,直接跳过。配置本地浏览器。
六、Hooks 配置(重要)
这个选项很重要,选择 openclaw 的预设动作。
第一个选项是在 Gateway 启动时运行 BOOT.md,这个后期有需要自己加。
第二个是注入额外的工作区引导文件,后期再加。
第三个是把所有命令事件写到日志,这个必须开。
第四个保留对话上下文记忆,这个也要开。
七、打开 Web UI
网关页面的打开方式,Web UI 较为便捷。
随后在控制台日志中的复制整串 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 和密钥同样在飞书开放平台获取。
接下来链接方式,选择长连接(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