第一步、安装 Nodejs
-
为减少后续报错,建议先安装 Node.js。下载地址:https://nodejs.org/zh-cn/download,选择对应操作系统版本。24 版本较新可能存在依赖不适配问题,本文推荐选择 22.22.0 版本(node-v22.22.0-x64.msi),直接双击安装即可。
-
安装完成后,使用管理员权限打开 Windows PowerShell 查看版本信息。
-
执行命令验证:
node -v
第二步、安装 Git
-
访问 https://git-scm.com/install/windows 下载安装文件 Git-2.53.0-64-bit.exe。
-
选择默认选项安装,完成后检查版本信息是否生效。
第三步、安装 OpenClaw
- 设置脚本执行权限,依次执行以下命令,键盘输入 y 确认:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
- 以管理员权限打开 PowerShell,执行一键安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex
等待安装完成无报错提示。
-
进行新手设置,执行命令
openclaw onboard --install-daemon,选择 QuickStart。默认 gateway 端口为 18789,bind 地址为 127.0.0.1。下一步选择模型,此处选择 Qwen,随后弹出千问登录认证页面。注册登录成功后继续。 -
远程控制渠道选择飞书,选择下载安装 plugin。
-
登录飞书开放平台:https://open.feishu.cn/app/cli_a93a790fdeb89cc9/baseinfo
获取 Secret,复制后在 cmd 中右键粘贴 Enter,再输入 App ID。provider、skills、hooks 可跳过,后续单独配置。之后会弹出 gateway 的 cmd 前台信息。
找到默认安装路径 C:\Users\xxx.openclaw 中的 openclaw.json 文件,查找 token 用于验证登录。在 json 中找到 gateway 模块下的 token。
OpenClaw 界面访问:输入访问地址 http://127.0.0.1:18789#token=你的 token 即可查看后台界面。
打开 OpenClaw 后台可以进行对话,使用千问模型。如需重新配置大模型 token,可使用命令 openclaw onboard,输入对应的 API key 即可。
若未配置大模型 API,可输入命令 openclaw configure 进行配置。使用 openclaw models list 查看已配置模型。登录国内大厂获取免费 token 额度或付费订阅。
常用检查命令:
# 检查 OpenClaw 版本
openclaw --version
# 检查系统健康状态
openclaw doctor
# 检查 Gateway 状态
openclaw gateway status
配置本地大模型
在 openclaw.json 中配置 Ollama 的地址(例如 192.168.113.66:9095):
"models":{"mode":"merge","providers":{"ollama":{"baseUrl":"http://192.168.113.66:9095/v1","api":"openai-completions","models":[{"id":"qwen3:235b","name":"Qwen3-235B","reasoning":false,"input":["text"],"contextWindow":32768,"maxTokens":8192}]}}}
Agent 配置示例:
"agents":{"defaults":{"model":{"primary":"ollama/qwen3:235b","fallbacks":[]},"models":{"ollama/qwen3":{"alias":"Qwen3-235B"}},"workspace":"C:\\Users\\ywh\\.openclaw\\workspace","compaction":{"mode":"safeguard"},"maxConcurrent":4,"subagents":{"maxConcurrent":8}}}
在 agent 路径 C:\Users\ywh.openclaw\agents\main\agent 下替换 auth-profiles.json 内容:
{"version":1,"profiles":{"ollama:default":{"provider":"ollama","type":"api_key","key":"ollama-local"}},"usageStats":{"ollama:default":{"errorCount":0,"lastUsed":1773295358877}}}
同路径添加 models.json 文件:
{"providers":{"ollama":{"baseUrl":"http://192.168.113.66:9095/v1","api":"openai-completions","models":[{"id":"qwen3:235b","name":"Qwen3-235B","reasoning":false,"input":["text"],"contextWindow":32768,"maxTokens":8192,"cost":{"input":0,"output":0,"cacheRead":0,"cacheWrite"
重启网关:openclaw gateway restart
第四步、配置飞书
此前通过 channel 创建过飞书连接,需在飞书开放平台创建机器人并发布。
在左侧添加应用能力 -> 机器人。
开通权限,批量开通权限脚本如下:
{"scopes":{"tenant":["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application.self_manage","application:bot.menu:write","cardkit:card:read","cardkit:card: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"]}
添加事件:
- im.message.receive_v1 - 接收消息
- im.message.message_read_v1 - 消息已读回执
- im.chat.member.bot.added_v1 - 机器人进群
- im.chat.member.bot.deleted_v1 - 机器人被移出群
修改完成后发布。
重启 OpenClaw 的 gateway,直接运行 openclaw gateway。
登录电脑端飞书,创建群组,在群组设置中添加机器人。
搜索之前发布的应用名称,确认后即可完成配置,实现通过飞书群组调用 AI 模型。


