OpenClaw 配置教程：在 macOS 上搭建 AI 助手并与飞书集成
摘要
本文记录了在 macOS 系统上安装和配置 OpenClaw 的完整过程，包括：
- OpenClaw 的安装与初始化
- Moonshot Kimi API 的配置
- 飞书（Feishu）机器人的接入
- 常见问题与解决方案
目录
1. 什么是 OpenClaw？
OpenClaw 是一个开源的 AI 助手框架，可以将大语言模型（如 Kimi、GPT、Claude 等）接入到各种即时通讯平台（飞书、钉钉、Slack、Discord 等），让 AI 成为你的个人助手。
通过 OpenClaw，你可以直接在飞书里与 AI 对话，让它帮你：整理文件、写代码、查询资料、管理日程，甚至控制你的电脑。
2. 环境准备
2.1 系统要求
- macOS 10.15+ 或 Linux
- Node.js 18+
- 网络连接（用于下载模型和插件）
2.2 所需账号
- Moonshot 账号（获取 Kimi API Key）
- 飞书开发者账号（创建企业自建应用）
3. 安装 OpenClaw
3.1 使用 npm 安装
npminstall-g openclaw 3.2 初始化配置
安装完成后，运行配置向导：
openclaw configure 向导会引导你完成以下配置：
- 选择运行模式（local/remote）
- 配置 AI 模型提供商
- 设置通讯渠道（飞书/钉钉等）
4. 配置 Moonshot Kimi API
4.1 获取 API Key
- 访问 Moonshot 开放平台：https://platform.moonshot.cn
- 注册/登录账号
- 创建 API Key
- 复制 Key 备用（格式：sk-xxxxxxxx）
4.2 配置到 OpenClaw
在配置向导中选择 Moonshot 作为模型提供商，输入 API Key。
配置完成后，OpenClaw 会自动创建以下配置：
{"models":{"providers":{"moonshot":{"baseUrl":"https://api.moonshot.cn/v1","models":[{"id":"kimi-k2.5","contextWindow":256000,"maxTokens":8192}]}}},"agents":{"defaults":{"model":{"primary":"moonshot/kimi-k2.5"}}}}5. 接入飞书机器人
5.1 创建飞书应用
- 访问飞书开放平台：https://open.feishu.cn
- 创建企业自建应用
- 记录 App ID 和 App Secret
- 开通权限：
- 获取用户基本信息
- 读取文档
- 发送消息
5.2 配置 OpenClaw 连接飞书
在 OpenClaw 配置中添加飞书渠道：
{"channels":{"feishu":{"enabled":true,"appId":"cli_xxxxxxxxxx","appSecret":"xxxxxxxxxx","connectionMode":"websocket","groupPolicy":"open","dmPolicy":"open"}}}5.3 启动服务
配置完成后，启动 OpenClaw 服务：
openclaw gateway start 然后在飞书里搜索你的应用，开始对话！
6. 配置详解
6.1 核心配置文件
OpenClaw 的配置存储在 ~/.openclaw/openclaw.json，主要包含：
- auth: API 认证配置
- models: 模型提供商和参数
- agents: 助手默认设置
- channels: 通讯渠道配置
- gateway: 网关服务配置
- plugins: 插件加载配置
6.2 安全建议
生产环境建议修改以下配置：
- 将
groupPolicy从"open"改为"allowlist" - 设置
tools.profile为"messaging"限制工具权限 - 启用 sandbox 模式运行外部命令
- 定期更换
gateway.auth.token
7. 使用技巧
7.1 常用命令
| 命令 | 说明 |
|---|---|
openclaw status | 查看服务状态 |
openclaw gateway start | 启动网关服务 |
openclaw gateway stop | 停止网关服务 |
openclaw logs --follow | 实时查看日志 |
openclaw security audit | 安全审计 |
7.2 会话管理
- 每个聊天窗口有独立的会话上下文
- 上下文窗口 256k，满了会自动遗忘最早的内容
- 重要信息会被优先保留
8. 总结
通过本文的配置，我们成功在 macOS 上搭建了 OpenClaw 服务，接入了 Moonshot Kimi 模型，并与飞书机器人打通。
现在你可以随时随地通过飞书与 AI 助手对话，让它帮你处理各种任务。OpenClaw 的强大之处在于其插件系统，可以扩展更多功能，比如文件管理、代码执行、智能家居控制等。
Happy coding with AI! 🤖
附录：参考链接
- OpenClaw 官方文档：https://docs.openclaw.ai
- Moonshot 开放平台：https://platform.moonshot.cn
- 飞书开放平台：https://open.feishu.cn
