从购买服务器到飞书机器人上线，全程实测，适合零基础用户。
本指南使用飞书个人账户创建机器人，无需企业审批，开箱即用。
推荐使用 腾讯云轻量应用服务器，性价比高，适合个人项目。
购买地址：腾讯云轻量应用服务器
| 配置项 | 推荐选择 |
|---|---|
| 地域 | 选离你最近的（如广州、上海、北京） |
| 镜像 | 操作系统镜像 → CentOS / OpenCloudOS / Ubuntu 均可 |
| 套餐 | 2核 2GB 内存起步（最低 1核 1GB 也能跑） |
| 系统盘 | 40GB SSD 够用 |
| 带宽 | 按套餐自带即可 |
| 登录方式 | 推荐 SSH 密钥（更安全），也可选密码登录 |
💡 新用户通常有优惠活动，2核2G 轻量服务器低至几十元/月。
在 轻量应用服务器控制台 找到你的实例：
在实例详情页 → 防火墙 中，确保以下端口已开放：
| 端口 | 协议 | 说明 |
|---|---|---|
| 22 | TCP | SSH 远程登录 |
| 80 | TCP | HTTP（可选，如需部署网站） |
| 443 | TCP | HTTPS（可选） |
OpenClaw 使用 WebSocket 长连接与飞书通信，不需要额外开放入站端口。
在实例详情页点击 登录，选择 OrcaTerm 免密登录（默认 TAT 方式），即可直接进入终端。后续所有命令都在这个终端中执行。
OpenClaw 需要 Node.js 22 或更高版本。推荐使用 nvm 管理：
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 加载 nvm（重要！安装后必须执行这一步）
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
# 安装 Node.js 22
nvm install 22
# 验证安装
node -v # 应显示 v22.x.x
npm -v # 应显示 10.x.x
如果
nvm install下载慢，可以设置镜像：export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node nvm install 22
curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本会自动：
如果一键安装有问题，可以手动：
# 全局安装
npm install -g openclaw@latest
# 验证
openclaw --version
如果 npm 下载慢，可以先设置镜像：
npm config set registry https://registry.npmmirror.com npm install -g openclaw@latest
# 检查 npm 全局路径
npm prefix -g
# 确认路径在 PATH 中
echo $PATH
# 如果不在，添加到 PATH
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
openclaw onboard --install-daemon
向导会引导你完成：
如果你使用第三方 API 中转服务，编辑配置文件：
nano ~/.openclaw/openclaw.json
在 models.providers 中添加你的提供商：
{
"models": {
"mode": "merge",
"providers": {
"my-provider": {
"baseUrl": "https://your-api-endpoint.com",
"apiKey": "sk-your-api-key",
"api": "anthropic-messages",
"models": [
{
"id": "your-model-id",
"name": "Your Model Name",
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}
设置默认模型：
{
"agents": {
"defaults": {
"model": {
"primary": "my-provider/your-model-id"
}
}
}
}
# 健康检查
openclaw doctor
# 查看状态
openclaw status
# 启动 Gateway（如果没有自动启动）
openclaw gateway start
看到 Gateway 状态为 running 就说明安装成功了 ✅
⚠️ 重要：请使用飞书个人账户！
企业账户创建的应用需要管理员审批，通常会被拒绝。个人账户创建的应用可以直接在测试环境使用，作为个人 AI 助理完全够用。
详细图文教程可参考：飞书个人账户创建机器人教程
进入应用后，在 凭证与基础信息 页面：
cli_xxx）❗ App Secret 请妥善保管，不要泄露给他人。
进入 权限管理 → 点击 批量开通，粘贴以下 JSON：
{
"scopes": {
"tenant": [
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access"
],
"user": [
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
这些权限让机器人能够接收消息、发送消息、发送图片等。
进入 事件与回调：
im.message.receive_v1⚠️ 如果保存失败，确保 OpenClaw Gateway 已启动（第 7 步），启动后再回来配置。
openclaw plugins install @openclaw/feishu
方式一：向导配置（推荐）
openclaw channels add
选择 Feishu，输入 App ID 和 App Secret。
方式二：手动编辑配置
nano ~/.openclaw/openclaw.json
在 channels 中添加飞书配置：
{
"channels": {
"feishu": {
"enabled": true,
"connectionMode": "websocket",
"dmPolicy": "open",
"groupPolicy": "open",
"requireMention": true,
"allowFrom": ["*"],
"domain": "feishu",
"accounts": {
"main": {
"appId": "cli_你的AppID",
"appSecret": "你的AppSecret"
}
}
}
}
}
⚠️ 踩坑提醒：
allowFrom必须是数组["*"]，写成字符串"[*]"会导致崩溃！
openclaw gateway restart
# 查看日志
openclaw logs --follow
看到以下日志说明连接成功：
Feishu WebSocket connection established
[ws] ws client ready
在飞书中找到你的机器人，发送一条消息。收到回复就说明一切正常 🎉
OpenClaw 自带 Web 管理界面，默认只监听本地。
在你的电脑终端执行：
ssh -L 18789:127.0.0.1:18789 root@你的服务器IP
保持连接，浏览器打开 http://127.0.0.1:18789
在服务器上编辑配置：
nano ~/.openclaw/openclaw.json
修改 gateway 部分：
{
"gateway": {
"bind": "lan",
"controlUi": {
"allowInsecureAuth": true
}
}
}
重启 Gateway：
openclaw gateway restart
在腾讯云防火墙中开放 18789 端口，然后浏览器访问：
http://你的服务器IP:18789
⚠️ Gateway 有 Token 认证保护，但公网暴露仍有风险，建议仅在需要时开放。
# 状态查看
openclaw status # 整体状态
openclaw gateway status # Gateway 状态
openclaw doctor # 健康检查
# Gateway 管理
openclaw gateway start # 启动
openclaw gateway stop # 停止
openclaw gateway restart # 重启
openclaw logs --follow # 实时日志
# 通道管理
openclaw channels add # 添加通道
openclaw pairing list # 查看配对请求
openclaw pairing approve feishu <code> # 批准配对
# 插件管理
openclaw plugins list # 已安装插件
openclaw plugins install <name> # 安装插件
# 更新
openclaw update # 更新 OpenClaw
| 命令 | 说明 |
|---|---|
/status |
查看 Bot 状态 |
/reset |
重置当前会话 |
/model |
查看/切换模型 |
.map is not a function原因： allowFrom 写成了字符串而非数组
修复： 将 "[*]" 改为 ["*"]，重启 Gateway
原因： Dashboard 默认要求 HTTPS 或 localhost
修复： 设置 gateway.controlUi.allowInsecureAuth: true
openclaw gateway statusopenclaw logs --followim.message.receive_v1解决： 使用飞书个人账户创建应用，无需审批
# 设置国内镜像
npm config set registry https://registry.npmmirror.com
建议开启 Swap：
fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab
~/.openclaw/
├── openclaw.json # 主配置文件
├── workspace/ # Agent 工作目录
│ ├── SOUL.md # Agent 人格设定
│ ├── USER.md # 用户信息
│ └── memory/ # 记忆文件
└── extensions/ # 已安装的插件
| 资源 | 链接 |
|---|---|
| OpenClaw 官方文档 | https://docs.openclaw.ai |
| OpenClaw GitHub | https://github.com/openclaw/openclaw |
| OpenClaw 社区 | https://discord.com/invite/clawd |
| 飞书开放平台 | https://open.feishu.cn/app |
| 飞书个人机器人教程 | https://zhuanlan.zhihu.com/p/1999915524180690138 |
| 腾讯云轻量服务器 | https://cloud.tencent.com/product/lighthouse |
📝 本指南基于 OpenClaw 2026.2.x 版本实测。如有问题欢迎反馈！