OpenClaw 配置教程：在 macOS 上搭建 AI 助手并与飞书集成

优质文章学习记录

09 Apr 2026 — 3 min read

摘要

本文记录了在 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

摘要

目录