一、安装 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
网关页面的打开方式，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（不限制对话），（真正的对话权限可以到飞书控制台设置）
接下来还有其他的一些选项
| 配置项 | 说明 | 选择 |
|---|---|---|
| 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
