注意:该视频请配合教学视频食用,视频地址:https://www.bilibili.com/video/BV1DqfnBREgP/?vd_source=24640fe95de694d392b5498459a166a6
1. 必备:安装Node.JS
2. 打开终端
程序坞中搜索“终端”
2.5(可选)配置 npm 镜像源 or 配置 proxy
配置镜像源粘贴命令:
1、命令
npm config set registry <http://mirrors.cloud.tencent.com/npm/>
2、验证命令
npm config get registry
如果返回 http://mirrors.cloud.tencent.com/npm/,说明镜像配置成功
导入 proxy 配置
export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897
3. 开始安装
官方文档参考地址:
https://docs.openclaw.ai/zh-CN
输入命令:
sudo npm install -g openclaw@latest
然后输入你电脑的密码,提示:密码是看不见的
新人小技巧:从这一步开始,后面可能会遇到各种问题,有个小技巧是,你可以把官方文档发给Gemini/GPT等你可以用到的最好的模型,让他们帮你答疑排错(如果你会用ClaudeCode更好,他可以直接帮你操作)
4. 进入新手引导功能
输入命令:
openclaw onboard --install-daemon
5. 大模型能力接入
海外模型
优点: 能力强
缺点: 网络问题,贵!
优先级 1:各种包月计划
GPT 会员
Claude 会员
Gemini 会员
优先级 2:直接用 API(不推荐,钱跟流水一样)
例如:OpenRouteh或者各官方API
国内模型
优点: 稳定,实惠
缺点: 能力稍弱
优先级 1:各种包月计划
Minimax
Kimi Code
优先级 2:各种中转站
6. channel 接入
海外 channel
优点: 接入方便,无用量上限
缺点: 网络问题
支持: telegram, discord
国内 channel
优点: 无网络问题,下载 APP 方便
缺点: 接入较麻烦,有用量上限
支持: 飞书(默认支持), 钉钉(需要安装插件)
钉钉插件安装地址:https://github.com/BytePioneer-AI/openclaw-china/tree/main
钉钉配置文档:https://github.com/BytePioneer-AI/openclaw-china/blob/main/doc/guides/dingtalk/configuration.md
飞书接入详细步骤(默认支持)
第一步:创建飞书应用(机器人)
打开飞书开放平台,用飞书账号登录
点击 创建企业自建应用
填写应用名称(随意,比如“我的 AI 助手”)和描述
选一个图标(可以之后改)
第二步:启用机器人能力
进入你刚创建的应用
左侧菜单找到 应用能力 > 机器人
开启机器人能力
给机器人起个名字
第三步:配置权限
左侧菜单进入 权限管理
点击 批量导入
粘贴以下 JSON(一键导入所有需要的权限):
{ "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:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } }
第四步:配置事件订阅
⚠️ 这一步必须在 OpenClaw 网关启动后再做,否则保存会失败。先做第五、六步,回来再做这一步也可以。
左侧菜单进入 事件与回调 > 事件配置
请求方式选择:使用长连接接收事件(这是关键!不需要公网服务器)
添加事件:搜索 im.message.receive_v1(接收消息),勾选添加
第五步:记下凭证
在应用的 凭证与基础信息 页面,复制:
App ID(格式如 cli_xxxxxxxxxx)
App Secret
❗️ App Secret 很重要,请妥善保管,不要分享。
第六步:发布应用
左侧菜单 版本管理与发布
创建版本 → 填写版本说明 → 提交
等待审批(企业内部应用通常自动通过,几秒到几分钟)
第七步:添加飞书渠道
在终端运行:
openclaw channels add
选择 Feishu → 粘贴你的 App ID → 粘贴你的 App Secret。
第八步:发消息测试
在飞书里搜索你的机器人名字,打开对话
发一条消息,比如“你好”
如果机器人回复了配对码,在终端运行:
openclaw pairing approve feishu <配对码>
授权后再发一条消息,收到正常回复 = 配置完成 🎉