【养虾活动】openclaw虚拟机部署不入门教程

玩了几天🦞了，遇到了一些坑，现在openclaw gateway restart命令打的贼熟练了。

其他openclaw系列教程：

• 为 OpenClaw 添加超能力：Skill不入门教程
• openclaw配置企业微信Bot
  

建议大家使用还是多看看官方文档：https://docs.openclaw.ai/zh-CN
我是部署在Ubuntu 22.04 LTS系统上。
如果使用飞书渠道可以先准备好飞书应用，不用就先跳过飞书部分，直接跳转到部署部分。

1、飞书准备

1、打开飞书开放平台，注册或登录账号。

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

填写应用名称和描述，选择应用图标后点击创建

3、配置应用权限
在【权限管理】页面，点击 【批量导入】 按钮

粘贴以下 JSON 配置一键导入所需权限，如果有额外需要可以自己进行修改：

1. {
   
2.   "scopes": {
   
3.     "tenant": [
   
4.       "aily:file:read",
   
5.       "aily:file:write",
   
6.       "application:application.app_message_stats.overview:readonly",
   
7.       "application:application:self_manage",
   
8.       "application:bot.menu:write",
   
9.       "cardkit:card:write",
   
10.       "contact:user.employee_id:readonly",
    
11.       "corehr:file:download",
    
12.       "docs:document.content:read",
    
13.       "event:ip_list",
    
14.       "im:chat",
    
15.       "im:chat.access_event.bot_p2p_chat:read",
    
16.       "im:chat.members:bot_access",
    
17.       "im:message",
    
18.       "im:message.group_at_msg:readonly",
    
19.       "im:message.group_msg",
    
20.       "im:message.p2p_msg:readonly",
    
21.       "im:message:readonly",
    
22.       "im:message:send_as_bot",
    
23.       "im:resource",
    
24.       "sheets:spreadsheet",
    
25.       "wiki:wiki:readonly"
    
26.     ],
    
27.     "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
    
28.   }
    
29. }

复制代码

确认所填写的权限：

4、创建机器人
在应用能力 > 机器人页面，配置机器人名称开启机器人能力

5、发布应用
在【版本管理与发布】页面点击创建版本，提交审核并发布，或者点应用名称后面的创建版本。

按需配置应用版本号、默认能力及更新说明等信息。等待管理员审批（企业自建应用一般自动通过）


6、获取App ID 和 App Secret
在应用的【凭证与基础信息】 页面，复制：App ID（格式如 cli_xxx）和App Secret（格式如 cli_xxx_secret），留好备用


安装openclaw

使用 CLI 安装器安装，注意需要Node>=22，没有的提前安装好

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

复制代码

1、安装完成后会弹出安装指引。一步一步跟着来就行。在 OpenClaw 交互中常用按键：

• ↑↓：上下选择选项
• ←`→：左右切换选项
• 空格键：选择选项
• 回车键：确认选项
  

2、首先提醒你默认配置适合个人使用，如果服务器有多人使用，需要额外安全配置！选Yes


3、配置方式，这里选默认的QuickStart就行。


1、模型选择
1、有以下的模型服务商，我这选择的是自定义的。没有的可以先跳过后面再设也可以。


2、然后有以下一些选项，自己看着设。

实在没有模型，就去美团模型获取下key吧，它有些免费Token。

2、配置消息渠道
1、有以下的渠道可以选择，先按主流选飞书吧


2、设置步骤：

• 选择了飞书渠道
• 是否选择安装飞书插件
• 输入飞书的应用密钥和ID
• 连接模式：WebSocket (default)，用长连接模式接收飞书事件
• 环境：国内的飞书开放平台选Feishu (feishu.cn) - China即可
• 群聊策略：可以选中间的Open
  

其中群聊策略选项意义：

• allowlist：仅允许 groupAllowFrom 中的群组
• Open：允许群组中所有人（默认）
• Disabled：禁用群组消息
  

3、设置私聊访问，dmPolicy策略说明：

• "pairing"：默认。新用户收到配对码，管理员批准后可对话
• "allowlist"：仅 allowFrom 白名单用户可对话
• "open"：允许所有人对话（如果有 allowFrom ，加 "*"）
• "disabled"：禁止私聊
  

3、web搜索
选择搜索服务提供商，都需要有token，先跳过吧。

4、安装Skills
1、一共有如下skills可以安装，我们先选择跳过，后续安装成功了也可以直接让openclaw安装这些Skills。


2、额外的功能插件，每个都需要对应的 API Key，所以全部选 No/skip就好

• GOOGLE_PLACES_API_KEY：地图/地点搜索（Google地图），需要Google Cloud API Key
• GEMINI_API_KEY：用 Gemini AI 模型，需要Google AI Studio Key
• NOTION_API_KEY：连接你的 Notion 笔记，需要Notion集成Token
• OPENAI_API_KEY (image-gen)：AI 生成图片（DALL-E），需要OpenAI API Key
• OPENAI_API_KEY (whisper)：语音转文字，需要OpenAI API Key
• ELEVENLABS_API_KEY：AI 语音合成（文字转语音），需要ElevenLabs Key
  

5、安装hooks
按空格键选择要安装的hooks，也可以先跳过后面再说。

• boot-md：启动时自动加载某些指令/提示词
• bootstrap-extra-files：启动时自动加载额外文件
• command-logger：记录所有操作日志
• session-memory：发 /new 或 /reset 时自动保存当前对话记忆
  

6、网关启动
1、基本配置都配置完后，他会自动安装网关启动服务，在这个过程里在ControlUI里会有个带token的链接，点击进去可以访问UI。

如果是第一次打开UI的话，必须是这种带token的链接。

2、网关启动完成后它会问你想用哪种方式来启动和使用你的机器人？

• Hatch in TUI：在终端里直接用，命令行界面
• Open the Web UI：在浏览器里打开网页界面
• Do this later：先跳过，以后再弄
  

2、如果选择第一个Hatch in TUI就会在终端进入机器人对话页面，可以在这继续和他对话，看看模型是否能被使用。

TUI页面键盘快捷键：

• Enter：发送消息
• Esc：中止活动运行
• Ctrl+C：清除输入（按两次退出）
• Ctrl+D：退出
• Ctrl+L：模型选择器
• Ctrl+G：智能体选择器
• Ctrl+P：会话选择器
  

7、检查网关状态
我们可以使用openclaw gateway status命令来查看网关状态。

8、匹配飞书
1、配置事件订阅
在配置事件订阅前，请务必确保已完成以下步骤：

• 运行 openclaw channels add 添加了 Feishu 渠道
• 网关处于启动状态（可通过 openclaw gateway status 检查状态）
• 如果网关未启动或渠道未添加，长连接设置将保存失败：未检测到应用连接信息，请确保长连接建立成功后再保存配置
  

来到我们之前的飞书应用页面，点击事件与回调菜单，订阅【机器人长链接接收事件】的方式，添加事件：im.message.receive_v1（接收消息）。

2、添加完事件后记得点击顶部的【创建版本】，输入版本号和说明发布版本。
3、打开飞书网页端或者客户端，打开应用与它对话，它会给你发个配对码的回复，此时表示已经连接成功。

4、使用命令来完成机器的配对：openclaw pairing approve feishu <配对码> 。注意配对码有效期为 5 分钟，超时需重新触发。

9、打开UI仪表板
1、在本地电脑终端使用命令创建到远程 Gateway WS 的本地隧道：ssh -N -L 18789:127.0.0.1:18789 user@host
说明：

• -N：不执行远程命令,只保持端口转发
• -L：表示本地端口转发
• 前面的 18789：表示你自己电脑本地监听的端口，这个如果被占用了可以更改。
• 后面的 127.0.0.1:18789：表示服务器上的目标地址
• user@host：服务器的用户名与IP
• 命令相当于你的电脑先用 SSH 连到服务器，顺便把服务器上的 127.0.0.1:18789 映射到你自己电脑的 127.0.0.1:18789。
  

2、在浏览器里打开 http://127.0.0.1:18789访问openclaw页面。
如果浏览器打不开，检查：

• SSH 命令窗口是不是还开着
• 服务器 OpenClaw 是否真的在运行
• 服务器上 openclaw gateway status 是否正常
• 你本地端口是不是冲突了
  

3、如果是首次打开的话，在终端打开带 token 的链接，否则会显示：unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)

• Token 来源：gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）
• 如果之前没关注这个带token的链接的话也可以在终端运行 openclaw dashboard 获取带 token 的链接（http://127.0.0.1:18789/?token=...）
• UI 在首次加载后存储它，后面就不需要加token了
  

4、如果是使用termius连接服务器，可以直接在Port Forwarding（端口转发）菜单下添加一个Local Forward（本地端口转发），然后连接一下就行了：

• Label: 转发规则的名字/备注名
• Local Port number: 你本地电脑要开哪个端口
• Bind address : 你本地电脑上，这个转发端口监听在哪个地址
• Intermediate host: 通过哪台 SSH 主机作为中转
• Destination address: 到了远程服务器以后，最终要访问哪个地址
• Destination Port number: 远程服务器上目标服务的端口
  

5、页面如下：

配置文件可以在页面上进行更改：


常用命令

1. # 重启OpenClaw网关服务
   
2. openclaw gateway restart
   
3. 
   
4. # 检查服务状态
   
5. openclaw gateway status
   
6. 
   
7. # 快速检查
   
8. openclaw doctor
   
9. 
   
10. # 打开仪表板
    
11. openclaw dashboard
    
12. 
    
13. # 查看配置文件
    
14. cat ~/.openclaw/openclaw.json

复制代码

夏佬威武

不错

有没有企业微信部署教程？

云深不知处 发表于 2026-3-14 15:22
有没有企业微信部署教程？

可以去我主页看看

权限前两行代码错误不知道为什么

威武 大佬

JUhblW 发表于 2026-3-15 01:11
权限前两行代码错误不知道为什么

截个图看看

大佬

牛逼啊夏夏子