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

初始化：

openclaw onboard --install-daemon

五、OpenClaw 初始化配置

询问是否在本机安装，选 yes。

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

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

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

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

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

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

询问是否现在配置 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

十、飞书权限配置（注意先做好飞书机器人设置，再配置 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（不限制对话），真正的对话权限可以到飞书控制台设置。

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

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