# OpenClaw 安装与配置完全指南
> 本文档详细介绍如何在 macOS 上安装 OpenClaw，并配置 Telegram 和飞书（Feishu）两大消息平台，打造属于你的个人 AI 助手。
—
## 目录
1. [OpenClaw 简介](#openclaw-简介)
2. [系统要求](#系统要求)
3. [安装 OpenClaw](#安装-openclaw)
4. [基础配置](#基础配置)
5. [配置 Telegram](#配置-telegram)
6. [配置飞书（Feishu）](#配置飞书feishu)
7. [日常使用](#日常使用)
8. [常见问题](#常见问题)
—
## OpenClaw 简介
**OpenClaw** 是一个开源的 AI 助手框架，允许你将各种大语言模型（LLM）接入到日常使用的通讯工具中（如 Telegram、飞书、Discord 等）。通过 OpenClaw，你可以：
– 🤖 在熟悉的聊天界面中与 AI 对话
– 🛠️ 调用各种工具（搜索、文件操作、代码执行等）
– 📱 跨平台同步，随时随地访问
– 🔌 扩展技能（Skills），自定义功能
—
## 系统要求
– **操作系统**: macOS 12+ (Monterey 或更高版本)
– **Node.js**: v18+ （推荐 v20+）
– **内存**: 至少 4GB 可用内存
– **网络**: 稳定的互联网连接
—
## 安装 OpenClaw
### 方式一：通过 npm 安装（推荐）
“`bash
# 使用 npm 全局安装
npm install -g openclaw
# 或使用 pnpm
pnpm add -g openclaw
“`
### 方式二：通过 Homebrew 安装
“`bash
# 添加 tap（如果需要）
brew tap openclaw/openclaw
# 安装
brew install openclaw
“`
### 验证安装
“`bash
openclaw –version
“`
成功安装后应显示版本号，例如：`2026.3.1`
### 初始化配置
“`bash
# 运行初始化向导
openclaw init
“`
按照提示完成基础配置：
– 选择默认 AI 模型
– 配置 API 密钥
– 设置工作目录（默认：`~/.openclaw`）
—
## 基础配置
### 配置文件位置
OpenClaw 的主要配置文件位于：
“`
~/.openclaw/openclaw.json
“`
### 配置模型 API
编辑配置文件添加你的 API 密钥：
“`json
{
“models”: {
“moonshot”: {
“apiKey”: “your-moonshot-api-key”,
“baseURL”: “https://api.moonshot.cn/v1”
},
“deepseek”: {
“apiKey”: “your-deepseek-api-key”
},
“anthropic”: {
“apiKey”: “your-claude-api-key”
}
},
“defaultModel”: “moonshot/kimi-k2.5”
}
“`
### 启动 Gateway 服务
“`bash
# 启动服务
openclaw gateway start
# 查看状态
openclaw gateway status
# 设置开机自启
openclaw gateway install-service
“`
—
## 配置 Telegram
Telegram 是最常用的 OpenClaw 接入方式之一，配置简单且免费。
### 步骤 1：创建 Telegram Bot
1. 在 Telegram 中搜索 `@BotFather`
2. 发送 `/newbot` 命令
3. 输入 Bot 名称（如：”My AI Assistant”）
4. 输入 Bot 用户名（必须以 `bot` 结尾，如：`myai_bot`）
5. 保存生成的 **Bot Token**（格式：`123456789:ABCdefGHIjklMNOpqrsTUVwxyz`）
### 步骤 2：配置 OpenClaw
“`bash
# 设置 Telegram Token
openclaw config set channels.telegram.token “your-bot-token”
# 启用 Telegram 频道
openclaw config set channels.telegram.enabled true
“`
或手动编辑 `~/.openclaw/openclaw.json`：
“`json
{
“channels”: {
“telegram”: {
“enabled”: true,
“token”: “123456789:ABCdefGHIjklMNOpqrsTUVwxyz”,
“accounts”: [“default”]
}
}
}
“`
### 步骤 3：重启服务
“`bash
openclaw gateway restart
“`
### 步骤 4：测试连接
1. 在 Telegram 中找到你的 Bot
2. 发送 `/start` 或直接发消息
3. AI 助手应该立即回复
### 安全设置（可选）
限制只有特定用户可以使用：
“`json
{
“channels”: {
“telegram”: {
“allowedUsers”: [“your-telegram-user-id”]
}
}
}
“`
获取 User ID：向 Bot 发送消息，然后访问：
“`
https://api.telegram.org/bot<你的Token>/getUpdates
“`
—
## 配置飞书（Feishu）
飞书是国内常用的企业协作平台，OpenClaw 提供完整的飞书支持。
### 步骤 1：创建飞书应用
1. 访问 [飞书开放平台](https://open.feishu.cn/app/)
2. 点击「创建企业自建应用」
3. 填写应用名称和描述
4. 记录 **App ID** 和 **App Secret**
### 步骤 2：配置权限
在应用后台的「权限管理」中，添加以下权限：
– `im:chat:readonly` – 读取群组信息
– `im:message:send_as_bot` – 以机器人身份发送消息
– `im:message.group_msg` – 发送群组消息
– `im:message.p2p_msg` – 发送单聊消息
### 步骤 3：配置事件订阅
1. 进入「事件订阅」页面
2. 开启「接收消息」事件
3. 设置请求 URL（如果使用内网穿透）：
“`
https://your-domain.com/webhook/feishu
“`
4. 记录 **Verification Token** 和 **Encrypt Key**
### 步骤 4：配置 OpenClaw
“`bash
# 设置飞书配置
openclaw config set channels.feishu.appId “cli_xxxxxxxxxx”
openclaw config set channels.feishu.appSecret “xxxxxxxxxx”
openclaw config set channels.feishu.verificationToken “xxxxxxxxxx”
openclaw config set channels.feishu.encryptKey “xxxxxxxxxx”
“`
或手动编辑配置：
“`json
{
“channels”: {
“feishu”: {
“enabled”: true,
“appId”: “cli_xxxxxxxxxx”,
“appSecret”: “xxxxxxxxxxxxxxxxxxxxxx”,
“verificationToken”: “xxxxxxxxxx”,
“encryptKey”: “xxxxxxxxxx”
}
}
}
“`
### 步骤 5：发布应用
1. 在飞书后台点击「版本管理与发布」
2. 创建版本并填写发布说明
3. 点击「申请发布」
4. 等待管理员审批（个人测试可立即通过）
### 步骤 6：添加机器人到聊天
1. 在飞书中搜索你的应用名称
2. 添加为联系人，或添加到群组
3. @机器人并发送消息测试
—
## 日常使用
### 常用命令
“`bash
# 查看状态
openclaw status
# 查看日志
openclaw logs –follow
# 重启服务
openclaw gateway restart
# 更新到最新版本
openclaw update
# 安全检查
openclaw security audit
“`
### 与 AI 助手对话
配置完成后，你可以：
1. **直接对话** – 像和朋友聊天一样与 AI 交流
2. **使用技能** – 让 AI 执行特定任务（如搜索天气、管理文件等）
3. **上传图片** – 支持视觉的模型可以分析图片内容
4. **语音消息** – 部分平台支持语音交互
### 管理技能（Skills）
“`bash
# 列出已安装技能
openclaw skills list
# 安装新技能
openclaw skills install
# 更新技能
openclaw skills update
“`
—
## 常见问题
### Q: 安装后无法启动 gateway？
**A**: 检查 Node.js 版本（需 v18+），并查看日志：
“`bash
openclaw logs –follow
“`
### Q: Telegram Bot 没有响应？
**A**:
1. 确认 Token 正确
2. 检查 gateway 是否运行：`openclaw gateway status`
3. 查看日志排查错误
### Q: 飞书收不到消息？
**A**:
1. 确认应用已发布
2. 检查权限是否全部添加
3. 确认 Bot 已被添加到聊天中
4. 查看事件订阅配置
### Q: 如何切换 AI 模型？
**A**: 在对话中使用模型切换命令：
“`
/model moonshot/kimi-k2.5
“`
或在配置文件中设置 `defaultModel`。
### Q: 如何备份配置？
**A**: 备份整个 `~/.openclaw` 目录：
“`bash
tar -czf openclaw-backup.tar.gz ~/.openclaw
“`
—
## 进阶配置
### 使用 Tailscale 内网穿透
如果你想从外部访问本地 Dashboard：
“`bash
# 安装并登录 Tailscale
openclaw tailscale up
# 查看分配的内网 IP
openclaw tailscale status
“`
### 配置多个模型
“`json
{
“models”: {
“moonshot/kimi-k2.5”: {
“alias”: “Kimi”
},
“deepseek/deepseek-chat”: {
“alias”: “DeepSeek”
},
“anthropic/claude-3-7-sonnet”: {
“alias”: “Claude”
}
}
}
“`
### 自定义工作区
“`bash
# 设置自定义工作目录
export OPENCLAW_HOME=/path/to/workspace
“`
—
## 参考链接
– [OpenClaw 官方文档](https://docs.openclaw.ai)
– [GitHub 仓库](https://github.com/openclaw/openclaw)
– [技能市场](https://clawhub.com)
– [Telegram Bot API](https://core.telegram.org/bots/api)
– [飞书开放平台](https://open.feishu.cn/)
—
*文档生成时间：2026-03-03*
*作者：麻辣小龙虾 🦞*
评论(0)