Windows + WSL + Ubuntu 安装 OpenClaw 及飞书百炼集成指南

初始化方式，选择快速启动（QuickStart）。

选择大模型，百炼不在这些选项中，先选择最后一个选项 Skip for now 跳过，之后再设置。

选择大模型提供商，先选不限提供商 All providers。

选择默认模型，这里选第一个保持当前选项（默认）就好。

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

搜索提供商，我们之后用本地浏览器搞，直接跳过。配置本地浏览器 –> 使用 WSLg 或本地浏览器进行可视化操作。

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

六、Hooks 配置（重要）

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

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

七、打开 Web UI

网关页面的打开方式，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"]}}

最后记得发布应用。

十一、配置飞书 channel

执行：

openclaw channels add

选择飞书。

选择输入 app 密钥，appid 和密钥同样在飞书开放平台获取。

并粘贴到控制台中。

接下来链接方式，选择长连接（WebSocket）。

对话模式，这里选 open（不限制对话），（真正的对话权限可以到飞书控制台设置）。

接下来还有其他的一些选项：

选择完后这里会再跳一个 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 + 飞书 + 百炼模型部署完成。