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

摘要

本文记录了在 macOS 系统上安装和配置 OpenClaw 的完整过程，包括：

• OpenClaw 的安装与初始化
• Moonshot Kimi API 的配置
• 飞书（Feishu）机器人的接入
• 常见问题与解决方案

---

目录

1. [什么是 OpenClaw？](#什么是 OpenClaw？)
2. 环境准备
3. [安装 OpenClaw](#安装 OpenClaw)
4. [配置 Moonshot Kimi API](#配置 Moonshot Kimi API)
5. 接入飞书机器人
6. 配置详解
7. 使用技巧
8. 总结

---

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 安装

npm install -g openclaw

3.2 初始化配置

安装完成后，运行配置向导：

openclaw configure

向导会引导你完成以下配置：

• 选择运行模式（local/remote）
• 配置 AI 模型提供商
• 设置通讯渠道（飞书/钉钉等）

---

4. 配置 Moonshot Kimi API

4.1 获取 API Key

1. 访问 Moonshot 开放平台：https://platform.moonshot.cn
2. 注册/登录账号
3. 创建 API Key
4. 复制 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 创建飞书应用

1. 访问飞书开放平台：https://open.feishu.cn
2. 创建企业自建应用
3. 记录 App ID 和 App Secret
4. 开通权限：
   • 获取用户基本信息
   • 读取文档
   • 发送消息

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 安全建议

生产环境建议修改以下配置：

1. 将 groupPolicy 从 "open" 改为 "allowlist"
2. 设置 tools.profile 为 "messaging" 限制工具权限
3. 启用 sandbox 模式运行外部命令
4. 定期更换 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