OpenClaw Windows 10 WSL2 安装与配置指南+飞书接入（使用腾讯云Coding Plan）

文章目录基础环境第一阶段安装 WSL2 环境1.1 开启 WSL21.2 迁移 WSL2 到非 C 盘推荐1.3 启用 systemd1.4 WSL 固定 DNS1.4.1 关闭 WSL 自动生成 DNS1.4.2 删除 systemd 生成的 resolv.conf1.4.3 创建新的静态 DNS 文件1.4.4 重启 WSL1.4.5 验证1.5 安装 Node.js 22第二阶段安装 OpenClaw2.1 全局安装2.2 运行 Onboarding 向导2.3 检查安装状态第三阶段配置腾讯云Coding Plan API3.1 获取 API Key3.2 配置 API Key示例3.5 重启openclaw并测试第四阶段接入飞书Feishu4.1 安装飞书插件4.2 创建飞书应用4.4 启动并测试第五阶段配置 Skills技能5.1 Skills 存放位置优先级从高到低5.2 从 ClawHub 安装 Skills5.3 手动创建自定义 Skill5.4 在配置文件中管理 Skills5.5 推荐安装的 Skills第六阶段日常操作命令常见问题排查npm 全局命令找不到飞书机器人能发消息但收不到API Key 报错从 Windows 访问 WSL 服务参考链接基础环境WSL2 Anthropic API 飞书接入 Skills 配置适用版本Windows 10 (1903) / Windows 11要求Node.js 22 · 8GB 内存 · API Key第一阶段安装 WSL2 环境WSL2 是官方推荐的 OpenClaw 运行环境。原生 PowerShell 安装虽然可行但开发者表示其不够稳定不建议用于生产环境。1.1 开启 WSL2以管理员身份打开 PowerShell执行wsl--install安装完成后重启电脑。重启后会自动打开 Ubuntu 终端设置用户名和密码。1.2 迁移 WSL2 到非 C 盘推荐WSL2 默认安装在C:\Users\用户名\AppData\Local\Packages\下。初始约 1-2 GB装完 OpenClaw 全套环境后会增长到 3-5 GB后续还会继续增长。建议在安装 OpenClaw 之前先完成迁移这样后续所有数据都在目标盘。WSL2 的虚拟磁盘ext4.vhdx有个特点文件删除后空间不会自动回收需要手动压缩所以实际占用可能比预期更大。迁移步骤以迁移到 D 盘为例# 1. 查看已安装的发行版名称应该显示为2wsl-l-v# 2. 关闭 WSLwsl--shutdown# 3. 导出为 tar 文件wsl--export Ubuntu D:\WSL\ubuntu-backup.tar# 4. 注销原来的发行版C 盘空间释放wsl--unregister Ubuntu# 5. 导入到新位置wsl--import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu-backup.tar# 6. 设置默认登录用户否则会默认 rootubuntu config--default-user 你的用户名迁移完成后D:\WSL\Ubuntu\下会有一个ext4.vhdx虚拟磁盘文件这就是 WSL2 的全部数据。较新版本 Windows 也支持安装时直接指定位置wsl--install-d Ubuntu--location D:\WSL如果你的系统版本不支持--location参数用上面的导出/导入方法。OpenClaw 的数据都在 WSL2 内部内容路径程序本体/usr/lib/node_modules/openclaw/配置和数据~/.openclaw/配置、skills、日志等工作目录~/clawd/WSL2 在哪个盘OpenClaw 就在哪个盘。1.3 启用 systemdOpenClaw 的守护进程需要 systemd 支持。进入 WSL Ubuntu 终端sudotee/etc/wsl.conf/dev/nullEOF [boot] systemdtrue EOF1.4 WSL 固定 DNS1.4.1 关闭 WSL 自动生成 DNS## vim /etc/wsl.conf[network]generateResolvConffalse1.4.2 删除 systemd 生成的 resolv.conf先确认是不是软链接ls-l/etc/resolv.conf你现在大概率会看到类似/etc/resolv.conf -../run/systemd/resolve/stub-resolv.conf删除它sudorm/etc/resolv.conf1.4.3 创建新的静态 DNS 文件sudotee/etc/resolv.conf/dev/nullEOF nameserver 1.1.1.1 nameserver 8.8.8.8 nameserver 223.5.5.5 options timeout:2 attempts:3 EOF1.4.4 重启 WSL在Windows PowerShell执行wsl--shutdown然后重新打开 Ubuntu。1.4.5 验证pingbaidu.com1.5 安装 Node.js 22更换镜像源Ubuntu24.04sudosed-is|http://archive.ubuntu.com/ubuntu/|https://mirrors.aliyun.com/ubuntu/|g/etc/apt/sources.list.d/ubuntu.sourcessudosed-is|http://security.ubuntu.com/ubuntu/|https://mirrors.aliyun.com/ubuntu/|g/etc/apt/sources.list.d/ubuntu.sourcessudoaptupdate在 WSL Ubuntu 终端中执行可以跳过安装OpenClaw时会自动安装Node等依赖这里是测试镜像源curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejs验证安装node-v# 应输出 v22.x.x第二阶段安装 OpenClaw2.1 全局安装## 一步到位curl-fsSLhttps://openclaw.ai/install.sh|bash## 或者手动安装npminstall-gopenclawlatest2.2 运行 Onboarding 向导参考链接 https://cloud.tencent.com/document/product/1772/128949openclaw onboard --install-daemon向导会引导你完成以下配置选择操作系统选 Linux选择 AI 提供商选 OpenAI输入 API Key跳过Skills全跳过配置 Hooks建议全选提示向导会询问是否安装 Homebrew在 Windows WSL 环境下选择 No 即可。2.3 检查安装状态openclaw config# 查看配置openclaw doctor# 检查配置是否有问题openclaw status# 查看网关状态openclaw dashboard# 打开浏览器 UI提示默认访问地址为http://127.0.0.1:18789/。如果浏览器显示 unauthorized运行openclaw dashboard获取带 token 的链接。第三阶段配置腾讯云Coding Plan API3.1 获取 API Key访问 https://hunyuan.cloud.tencent.com/#/app/subscription 并登录进入 Coding Plan 我的套餐点击 购买套餐首月优惠后7.9元复制生成的 Key3.2 配置 API Key示例// vim ~/.openclaw/openclaw.json## 推荐 models 配置models:{mode:merge,providers:{tencent-coding-plan:{baseUrl:https://api.lkeap.cloud.tencent.com/coding/v3,apiKey:USER_API_KEY,api:openai-completions,models:[{id:tc-code-latest,name:Auto,reasoning:false,contextWindow:196608,maxTokens:32768},{id:hunyuan-t1,name:Hunyuan-T1,reasoning:true,contextWindow:64000,maxTokens:32000},{id:hunyuan-2.0-thinking,name:Tencent HY 2.0 Think,reasoning:true,contextWindow:128000,maxTokens:32000},{id:glm-5,name:GLM-5,reasoning:true,contextWindow:202752,maxTokens:16384},{id:kimi-k2.5,name:Kimi-K2.5,reasoning:true,contextWindow:262144,maxTokens:32768}]}}}## 推荐 agents 配置agents:{defaults:{model:{primary:tencent-coding-plan/hunyuan-t1},models:{tencent-coding-plan/hunyuan-t1:{},tencent-coding-plan/glm-5:{},tencent-coding-plan/kimi-k2.5:{},tencent-coding-plan/hunyuan-2.0-thinking:{}}}}3.5 重启openclaw并测试openclaw gateway--forceopenclaw tui第四阶段接入飞书Feishu4.1 安装飞书插件openclaw pluginsinstallm1heng-clawd/feishu4.2 创建飞书应用1、访问 open.feishu.cn/app创建企业自建应用2、在凭证与基础信息中复制 App ID格式cli_xxx和 App Secret3、把这两项提供给 OpenClaw 让它完成配置4、进入权限管理→ 找到「批量导入导出权限」→ 权限配置 JSON → 粘贴导入{scopes:{tenant:[aily:file:read,aily:file:write,application:application.app_message_stats.overview:readonly,application:application:self_manage,application:bot.menu:write,contact:user.employee_id:readonly,corehr:file:download,event:ip_list,im:chat.access_event.bot_p2p_chat:read,im:chat.members:bot_access,im:message,im:message.group_at_msg:readonly,im:message.p2p_msg:readonly,im:message:readonly,im:message:send_as_bot,im:resource],user:[aily:file:read,aily:file:write,im:chat.access_event.bot_p2p_chat:read]}}5、进入“事件与回调界面”在事件订阅中选择使用长连接WebSocket 模式添加事件im.message.receive_v1通过版本管理与发布发布应用重要应用必须发布并审核通过后才能接收消息。事件订阅必须选择长连接模式这样不需要公网 IP。6、然后在飞书里找到你刚创建的机器人发送一条消息它会自动回复一个配对码复制这个配对码打开 Clawdbot 的 Web UI就是前面那个控制台把配对码发给它Clawdbot 会自动完成绑定。PS群聊使用要获取群聊 ID格式oc_xxx先将机器人加入群它一次然后查看日志openclaw logs --follow4.4 启动并测试现在你已经可以在飞书聊天框中与机器人聊天了第五阶段配置 Skills技能Skills 是 OpenClaw 的教科书——教它如何组合 Tools 来完成特定任务。每个 Skill 就是一个包含SKILL.md文件的文件夹。以下所有操作你都可以和你的AI助手通过聊天的方式完成这就是openclaw的魅力。5.1 Skills 存放位置优先级从高到低位置路径说明Workspace Skills~/.openclaw/workspace/skills/最高优先级个人定制Managed Skills~/.openclaw/skills/共享给所有 AgentBundled Skills随 OpenClaw 安装内置技能最低优先级5.2 从 ClawHub 安装 SkillsClawHub 是 OpenClaw 的公共 Skills 注册表可以在 clawhub.com 浏览。# 安装单个 skillclawhubinstallskill-slug# 示例安装常用 skillsclawhubinstallfind-skills clawhubinstallweb-research clawhubinstallsummarize5.3 手动创建自定义 Skillmkdir-p~/.openclaw/skills/my-skillnano~/.openclaw/skills/my-skill/SKILL.mdSKILL.md 文件结构示例--- name: my-custom-skill description: 描述你的 skill 功能 --- # 你的 Skill 名称 这里写具体指令教 AI 如何完成任务...5.4 在配置文件中管理 Skills在~/.openclaw/openclaw.json中精细控制 Skills{skills:{install:{nodeManager:npm},entries:{find-skills:{enabled:true},web-research:{enabled:true},summarize:{enabled:true}}}}白名单模式内置 Skills 默认自动加载。如果想精确控制哪些生效可用skills.allowBundled设置白名单模式只允许明确列出的 skills 加载。5.5 推荐安装的 SkillsSkill 名称功能说明find-skills帮助你搜索和发现新的 Skillsweb-research深度网络研究多源信息汇总summarize文档/网页摘要总结de-ai-writing去除 AI 写作痕迹让文本更自然git-commitGit 自动提交信息、PR 描述第六阶段日常操作命令命令说明openclaw gateway启动网关openclaw gateway restart重启网关openclaw doctor检查配置问题openclaw doctor --repair自动修复常见问题openclaw status查看网关状态openclaw dashboard打开 Web UIopenclaw logs --follow实时查看日志openclaw models status查看模型和认证状态npm update -g openclaw更新 OpenClawclawhub install name安装新 Skillclawhub sync --all同步所有已安装 Skills常见问题排查npm 全局命令找不到将 npm 全局路径加入 PATHechoexport PATH$(npm prefix -g)/bin:$PATH~/.bashrcsource~/.bashrc飞书机器人能发消息但收不到最常见的原因是事件订阅没配置正确。检查确认已添加im.message.receive_v1事件确认选择了长连接模式确认应用已发布并审核通过确认 gateway 正在运行长连接需要 gateway 在线API Key 报错常见提示No API key found for provider anthropic。解决方法检查环境变量echo $ANTHROPIC_API_KEY重新运行openclaw models status查看认证状态如使用多 Agent每个 Agent 需单独配置 Key从 Windows 访问 WSL 服务大多数情况下可以直接用localhost访问。如果需要从局域网其他设备访问在 PowerShell 中设置端口转发。参考链接OpenClaw 官方文档https://docs.openclaw.aiOpenClaw GitHubhttps://github.com/openclaw/openclawClawHub Skills 注册表https://clawhub.com飞书开放平台https://open.feishu.cn/app飞书插件 (m1heng)https://github.com/m1heng/clawdbot-feishu