跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

Windows WSL Ubuntu 安装 OpenClaw 配置飞书与百炼模型全流程

在 Windows 环境下通过 WSL 和 Ubuntu 系统安装 OpenClaw 智能体框架的完整步骤。内容包括 WSL 安装、基础组件与 Node.js 环境配置、OpenClaw 初始化、飞书机器人插件接入及权限设置,以及阿里云百炼模型的集成配置。最终实现基于飞书渠道的 AI 助手功能。

利刃发布于 2026/4/6更新于 2026/5/2033 浏览

一、安装 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。

图片

选择默认模型,这里选第一个保持当前选项(默认)就好。

图片

配置 channel,这个直接跳到最下面选跳过。

图片

搜索提供商,我们之后用本地浏览器搞,直接跳过。配置本地浏览器。

图片

询问是否现在配置 skill,跳过。

六、Hooks 配置(重要)

图片

这个选项很重要,选择 openclaw 的预设动作。

第一个选项是在 Gateway 启动时运行 BOOT.md,这个后期有需要自己加。 第二个是注入额外的工作区引导文件,后期再加。 第三个是把所有命令事件写到日志,这个必须开。 第四个保留对话上下文记忆,这个也要开。

七、打开 Web UI

图片

网关页面的打开方式,Web UI 较为便捷。 随后在控制台日志中的复制整串 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

十、飞书权限配置(注意先做好飞书机器人设置,再配置 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

执行:

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

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

模型配置成功。

图片

十五、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 + 飞书 + 百炼模型部署完成。

目录

  1. 一、安装 WSL
  2. 二、安装基础组件
  3. 三、安装 Node.js(通过 nvm)
  4. 1 安装 nvm
  5. 2 安装 Node
  6. 四、安装 OpenClaw
  7. 五、OpenClaw 初始化配置
  8. 六、Hooks 配置(重要)
  9. 七、打开 Web UI
  10. 八、安装飞书插件
  11. 九、第三方飞书插件(备用方案)
  12. 十、飞书权限配置(注意先做好飞书机器人设置,再配置 channel)
  13. 十一、配置飞书 channel
  14. 十二、配置飞书回调事件
  15. 十三、重启 OpenClaw
  16. 十四、配置百炼模型
  17. 十五、OpenAI OAuth 登录
  18. 十六、创建子 Agent
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • C++ 运算符重载详解:自定义类型的运算扩展
  • C++ 运算符重载:让自定义类型支持自然运算
  • C++ 运算符重载实战:让自定义类型像内置类型一样运算
  • Vue3 与 TypeScript 前端高频面试题解析
  • VR、具身智能与人形机器人:通往现实世界的智能接口
  • String 字符串的存储结构详解
  • Java 大数据在智能家居设备联动与场景化节能中的应用
  • Windows 10 部署 OpenClaw 本地 AI 助手
  • C++ 基础:auto 关键字、范围 for 循环与迭代器
  • C++26 模块化革命:GCC 如何重塑现代 C++ 开发效率
  • 2026 年主流 AI 大模型实测排名与选型指南
  • ARM Cortex R52 架构 GICv3 中断控制器详解
  • LangChain 与 LlamaIndex 大模型应用开发工具对比分析
  • 2024 人工智能大模型发展现状、应用案例与总结展望
  • B 站 PC 端视频自动开启字幕脚本(2025 适配)
  • Ollama 部署 DeepSeek-R1 本地大模型,配合 Open-WebUI 与 RagFlow 私有知识库
  • Java 多张图片合成 JPG 红色前景问题修复与列数自适应
  • 产品经理必备的 12 个核心思维模型
  • 基于 JsPDF 和 html2canvas 实现前端图表与列表数据多格式导出
  • Python 3.12 logging 模块 LogRecord 详解

相关免费在线工具

  • 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