注意:该视频请配合教学视频食用,视频地址: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

飞书接入详细步骤(默认支持)

第一步:创建飞书应用(机器人)

  1. 打开飞书开放平台,用飞书账号登录

  2. 点击 创建企业自建应用

  3. 填写应用名称(随意,比如“我的 AI 助手”)和描述

  4. 选一个图标(可以之后改)

第二步:启用机器人能力

  1. 进入你刚创建的应用

  2. 左侧菜单找到 应用能力 > 机器人

  3. 开启机器人能力

  4. 给机器人起个名字

第三步:配置权限

  1. 左侧菜单进入 权限管理

  2. 点击 批量导入

  3. 粘贴以下 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 网关启动后再做,否则保存会失败。先做第五、六步,回来再做这一步也可以。

  1. 左侧菜单进入 事件与回调 > 事件配置

  2. 请求方式选择:使用长连接接收事件(这是关键!不需要公网服务器)

  3. 添加事件:搜索 im.message.receive_v1(接收消息),勾选添加

第五步:记下凭证

在应用的 凭证与基础信息 页面,复制:

  • App ID(格式如 cli_xxxxxxxxxx)

  • App Secret

❗️ App Secret 很重要,请妥善保管,不要分享。

第六步:发布应用

  1. 左侧菜单 版本管理与发布

  2. 创建版本 → 填写版本说明 → 提交

  3. 等待审批(企业内部应用通常自动通过,几秒到几分钟)

第七步:添加飞书渠道

在终端运行:

openclaw channels add

选择 Feishu → 粘贴你的 App ID → 粘贴你的 App Secret

第八步:发消息测试

  1. 在飞书里搜索你的机器人名字,打开对话

  2. 发一条消息,比如“你好”

  3. 如果机器人回复了配对码,在终端运行:

openclaw pairing approve feishu <配对码>

  1. 授权后再发一条消息,收到正常回复 = 配置完成 🎉