🦞OpenClaw 接入指南

⚠️安装前须知：OpenClaw 有可能会对本数据产生威胁，目前已经发生多起OpenClaw误删本地数据的案例。不建议在生产环境或者装有重要数据的电脑上安装OpenClaw或进行相关测试。必要时可以通过备份数据和创建新用户隔离敏感数据的方式来解决。更推荐在一台专用设备上进行此操作。

万擎官网准备步骤

获取快手万擎账号，并拿到配置OpenClaw的3个必要信息：

• Base Url（调用地址）
• • 按量计费：https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints
  • Coding Plan：https://wanqing.streamlakeapi.com/api/gateway/coding/v1
• APIKey（密钥）
• model ID（模型ID）

注册快手万擎账户

1. 首先需要在快手万擎官网登陆注册（可选择微信注册、sso登陆和手机号三种方式），注册完成后点击右上角「控制台」https://www.streamlake.com/product/wanqing

2. 注册并登陆后点击进入「快手万擎」平台，初次使用需要先开通快手万擎平台服务，勾选协议后点击开通。

获取快手万擎平台 API Key

3. 在“快手万擎”顶部菜单中选择“系统管理”

4.点击左侧“API Key 管理”后，选择“创建API Key”按钮。在弹出的创建API Key窗口中可以填写描述或直接点击“确定”完成设置。

5. 至此，就成功的获取到了API Key，可复制粘贴到记事本或备忘录中，稍后需要使用。

温馨提示：明文保存的API Key在配置完成后一定要清除，随意暴露API Key给他人可能会产生账单盗刷。

创建一个可调用的模型

6. 在“快手万擎”界面中点击“模型服务” ，在左侧菜单中，选择“在线推理”

7. 在“自定义推理接入点”页签下选择“新建推理服务”

8. 在第1步“配置接入信息”中，输入推理点名称、推理点描述（选填），并点击“添加模型”

9. 选择所需模型并点击“确定”，可以按需选择不同的大模型，在此以GLM-5举例

10. 如果不需要调整模型限流，则可以直接点击“下一步”

11. 在信息确认与提交界面点击“提交”按钮，完成模型的推理点创建。

12. 在“推理点详情页”中，点击查看“OpenAI SDK”的示例代码，在这里可以获取到BaseUrl和Model ID。

如图所示 Base_Url="https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints" ，model="ep-ng6vd7-1772515553723714553"

好了！我们已经具备了万擎平台模型调用的三个信息：Base url（调用地址）、APIKey（密钥）和model ID（模型ID），可以准备部署了！

OpenClaw部署步骤

1. 运行安装脚本

打开OpenClaw官网：https://openclaw.ai/

2. 复制页面上的安装指令粘贴到个人的电脑“终端”（Terminal）并执行

⚠️注意：OpenClaw所拥有的权限可能威胁本地数据安全，安装前请一定隔离本地数据，或者在非生产环境安装。

如果无法执行命令，需要在命令前增加sudo

sudo curl -fsSL https://openclaw.ai/install.sh | bash

3. 进入安装前可能会先完成预装环境，你会看到如下过程，需要大概等待7-8分钟（受网络环境影响）

4. 成功之后会输出会看到询问你是否知道风险的选项，需要选择yes并回车

5. 选择QuickStart快速安装模式

6. 选择Model模型供应商时一直向下，直到选择Custom Provider

7. Openclaw 出现了API Base URL，粘贴刚才保存好的Base URL 地址并点击回车（如果忘了可以参考万擎官网准备步骤第12步）

8. 选择“立刻粘贴API Key”

9. 将保存好的名为OpenClaw的API Key粘贴进去（如果忘了可以参考万擎官网准备步骤第5步）

10. 选择兼容性为“OpenAI”

11. 模型ID输入快手万擎所使用的模型ID（如果忘了可以参考万擎官网准备步骤第12步）

12. Endpoint ID自动显示，可以保持不变

13. 由于在Model ID中不容易区分出模型名，可以在Model alias 中标记模型名，如glm-5

14. 在这里我们先跳过IM即时通讯工具的配置，后续再添加。

15. 选择你需要的skill （使用键盘上下键定位，点击空格选择，回车确认操作）

16. 其他需要配置的API Key根据具体情况选择

17. 选择是有要配置一个hooks，用于在OpenClaw每次启动前执行某些脚本

18. 选择一个初次与你的小龙虾沟通的方式，TUI 就像此刻配置界面在使用的文字交互界面，而非通过图形界面操作。Web UI则可以通过访问http://127.0.0.1:18789 的本地地址来访问小龙虾的控制台

19. 点击回车，大功告成，这样你就可以开启与你的小龙虾的第一次对话了。

与小龙虾的第一次交流🎉

至此，我们就可以实现通过终端或者本地网页界面与小龙虾交流。

如果想要把小龙虾部署在固定地点，我们如何通过其他IM通讯工具（如飞书）跟小龙虾交流呢？

快速接入飞书

1. 首先，需要使用飞书账号登录飞书开放平台，进入飞书开发者后台，点击“创建企业自建应用”

https://open.feishu.cn/app

2. 给应用命名（如 “OpenClaw”），填写应用描述，选择应用图标，点击“创建”按钮即可进入应用管理页面

3. 创建后跳转到管理页面，在左侧找到“添加应用能力”界面，选择添加“机器人”即可

4. 点击页面左侧的“凭证与基础信息”，找到飞书的“App ID” 和 “App Secret” 两个参数，分别点击右侧 “复制” 按钮，将其保存到个人记事本或备忘录中

注意： App Secret 需妥善保管，跟API Key同样重要，一旦 App Secret 和 App ID  泄漏将可能造成数据安全隐患。

5. 打开终端输入 “openclaw channels add” 进入配置流程

6. 选择现在配置Yes并点击回车

7. 选择Channel，选择 Feishu/Lark （飞书）并点击回车

8. 安装飞书插件，会安装飞书对应的扩展，点击回车

9. 输入App Secret 和  App ID （注意不要把两个参数输反）

10. App Secret 和  App ID 两个字段输入完成后点击回车可以看到绿色的信息提示“client ready”

11. Feishu Connection mode 选择WebSocket、Feishu的Domain（域名）如果是国内版选择feishu.cn，如果是海外版根据实际情况选择。

下图中我们以开启群聊功能为例

12. 完成以上设置后，会再次出现Select a channel，直接选择最后的Finished 完成设置

13. FeiShu DM Policy 访问策略参考下图选择

14. 设置完成后执行openclaw gateway restart 配置完成，重启

15. 返回飞书开放平台继续配置

在左侧“事件与回调”中的“事件配置”，点击订阅方式旁边的图标，选择“使用 长链接 接收事件”模式，点击保存。

16. 在下方的“已添加事件”中点击“添加事件”，搜索并添加“接收消息”（版本可能随时间有变化，不一定是v2.0），并点击“确认开通权限”。

配置完成后如上图。

17. 此刻机器人获得了接收飞书信息的权限，我们可以加入更多权限，让小龙虾更好地跟飞书配合，进入侧边栏“权限管理”设置窗口，点击“批量导入/导出权限”，

拷贝并粘贴替换默认代码，将以下权限添加进去，并点击确认

{

 "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:contact.base:readonly",

     "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"]

 }

}

18. 接下来还需要为机器人设置应用版本号，在侧边栏“版本管理与发布”中输入应用版本号，可以写为1.0.0，更新说明按需填写。

19. 下滑至页面底部保存设置。

20. 返回页面上方点击“确认发布”

21. 打开飞书，你将可以在“开发者小助手”中看到已经发布的应用，点击“打开应用”，并与它完成一次对话。

22. 对话后将会获得一个“配对口令”，复制口令的部分，打开terminal

23. 粘贴口令并回车

大功告成！

Q&A 常见问题

1、和终端对话配置 OpenClaw，步骤卡住怎么办？

在终端中善用 openclaw doctor --fix 命令，直接复制并点击回车，“龙虾医生”能帮你解决大部分问题

2、初次配置后打开http://127.0.0.1:18789 显示 gateway token missing （网关口令丢失）

可以使用openclaw doctor --generate-gateway-token 重新设置网关口令。

3、安装失败再次安装后对话时报NO_REPLY

在Web UI中输入 /new ，然后在终端中执行 openclaw gateway restart即可

4.为什么在 curl -fsSL https://openclaw.ai/install.sh | bash 安装时要等很久？

因为 openclaw.ai 需要调用海外的服务器，如果你的网络环境在中国大陆地区可能需要较长的等待时间，或尝试使用其他网络环境进行加速。

加入交流群

安装中如果遇到其他问题欢迎扫码加入快手万擎OpenClaw用户交流群，和大家共同探讨OpenClaw的使用经验和各种新鲜有趣又实用的玩法。

更多Skills使用技巧

更多Skills使用技巧和其他IM通讯工具接入方式即将更新