Windows WSL Ubuntu 环境部署 OpenClaw 接入飞书与百炼模型

检查版本：

openclaw --version

初始化服务：

openclaw onboard --install-daemon

五、OpenClaw 初始化配置

系统会询问是否在本机安装，输入 yes 确认。

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

选择大模型时，百炼不在当前选项中，先选择最后一个选项 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

十、飞书权限配置

在飞书开放平台创建应用，配置机器人能力。

导入以下权限配置：

{"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 登录

若想配置（或重新配置）OpenAI GPT 且用网页登录认证（OAuth），则使用命令直接设置：

openclaw models auth login --provider openai-codex

十六、【进阶】创建子 Agent

使用以下命令进入交互式操作页面创建子 Agent：

openclaw agents add

也可以使用非交互式命令直接创建。基础格式（注意，一定要指定子 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