乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 智能助手安装教程 ��

OpenClaw 智能助手安装教程 ��

当前时间： 2026-08-14 15:05:41 分类：办公文件 评论(0)
OpenClaw 智能助手安装教程 ��
 让一只聪明的龙虾住进您的飞书

📋 目录

  1. 前置准备

  2. 安装步骤

  3. 配置指南

  4. 飞书集成

  5. 常见问题

  6. 进阶玩法

🎯 前置准备

系统要求

  • 操作系统: Linux / macOS / Windows (WSL2)

  • Node.js: v18.0+ (推荐 v20+)

  • 内存: 至少 2GB 可用内存

  • 存储: 至少 500MB 磁盘空间

必需账号

  1. 飞书开发者账号 - 用于创建飞书应用

  2. GitHub 账号 - 用于获取源码（可选）

检查环境

# 检查 Node.js 版本
node -v

# 检查 npm 版本
npm -v

🚀 安装步骤

方式一：使用 npm 全局安装（推荐）

# 安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

方式二：从源码安装

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
npm install

# 全局链接
npm link

初始化工作区

# 创建工作目录
mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace

# 初始化 OpenClaw
openclaw init

⚙️ 配置指南

1. 创建配置文件

在工作目录下创建 openclaw.json：

{
  "channel": "feishu",
  "provider": "feishu",
  "model": "miaoda/miaoda-model-auto",
  "skills": {
    "entries": {
      "feishu-im-read": { "enabled": true },
      "feishu-calendar": { "enabled": true },
      "feishu-bitable": { "enabled": true },
      "feishu-create-doc": { "enabled": true }
    }
  },
  "agents": {
    "defaults": {
      "model": "miaoda/miaoda-model-auto",
      "thinking": "off"
    }
  }
}

2. 配置飞书应用

2.1 创建飞书应用

  1. 访问 飞书开发者后台

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

  3. 填写应用名称（如：OpenClaw 智能助手）

  4. 选择应用类型：机器人

2.2 配置应用能力

在「应用能力」页面添加以下权限：

权限名称

用途

发送消息

机器人回复消息

读取消息

接收用户消息

创建云文档

文档管理功能

日历管理

日程查询与创建

多维表格

数据表操作

通讯录

获取用户信息

2.3 配置机器人

  1. 进入「机器人」菜单

  2. 启用机器人

  3. 设置机器人头像和名称

  4. 复制 App ID 和 App Secret

2.4 配置事件订阅

  1. 进入「事件订阅」菜单

  2. 启用事件订阅

  3. 配置请求网址（需要公网可访问的地址）

  4. 订阅以下事件：

    1. im.message.receive_v1 - 接收消息

    2. im.message.read_v1 - 消息已读（可选）

2.5 发布应用

  1. 进入「版本管理与发布」

  2. 创建新版本

  3. 提交审核（企业自用通常自动通过）

  4. 启用版本

🔗 飞书集成

启动 Gateway 服务

# 启动服务
openclaw gateway start

# 查看状态
openclaw gateway status

# 查看日志
openclaw gateway logs

在飞书中添加机器人

  1. 打开飞书，进入任意群聊或私聊

  2. 点击右上角「...」→「添加机器人」

  3. 选择您创建的 OpenClaw 机器人

  4. 完成添加

测试连接

在飞书中向机器人发送消息：

你好

如果收到回复，说明配置成功！🎉

❓ 常见问题

Q1: 服务启动失败

症状: openclaw gateway start 报错

解决方案:

# 检查端口占用
lsof -i :3000

# 查看错误日志
openclaw gateway logs --tail 100

# 重新安装
npm uninstall -g openclaw
npm install -g openclaw

Q2: 飞书收不到消息

可能原因:

  • 事件订阅 URL 不可达

  • 权限未正确配置

  • 应用未发布

排查步骤:

  1. 检查事件订阅中的请求网址是否可公网访问

  2. 确认已订阅 im.message.receive_v1 事件

  3. 确认应用已发布并启用

Q3: 机器人回复乱码

原因: 编码问题或模型配置错误

解决方案:

// openclaw.json 中明确指定模型
{
  "model": "miaoda/miaoda-model-auto"
}

Q4: 如何更新 OpenClaw

# 使用 npm 更新
npm update -g openclaw

# 重启服务
openclaw gateway restart

🎨 进阶玩法

自定义技能

在工作目录创建 skills/ 文件夹，添加自定义技能：

workspace/
├── openclaw.json
├── skills/
│   └── my-custom-skill/
│       └── SKILL.md
└── memory/
    └── YYYY-MM-DD.md

配置记忆系统

创建 MEMORY.md 文件存储长期记忆：

# 长期记忆

## 用户偏好
- 喜欢简洁的回复风格
- 工作时间：9:00-18:00
- 常用功能：日程管理、文档创建

## 重要事项
- 项目 A 截止日期：2024-12-31
- 每周例会：周一 10:00

设置定时任务

使用 cron 功能设置定期检查：

# 编辑配置添加定时任务
openclaw config edit

多模型切换

在配置文件中设置多个模型：

{
  "models": {
    "default": "miaoda/miaoda-model-auto",
    "creative": "miaoda/miaoda-auto-multimodal",
    "fast": "轻量级模型"
  }
}

📚 参考资源

  • OpenClaw 官方文档

  • GitHub 仓库

  • Discord 社区

  • 飞书开放平台

🆘 获取帮助

遇到问题？试试以下方式：

  1. 查看日志：openclaw gateway logs

  2. 运行诊断：openclaw status

  3. 查阅文档：/usr/lib/node_modules/openclaw/docs

  4. 社区求助：Discord 或 GitHub Issues

🦞 龙虾提示: 安装完成后，记得说一声「OpenClaw 已就绪！」