macOS配置openclaw+deepseek大模型+飞书小助手

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

openclaw到底是什么？

 OpenClaw 是一个开源的个人 AI Agent（智能体）框架。

普通 AI（如 ChatGPT）：你问它答，它住在浏览器里。
OpenClaw：它住在你的电脑或服务器里，通过微信、钉钉、Telegram
等聊天软件和你沟通。最核心的区别是它能执行操作：
- 前端开发：你可以让它“帮我改一下这个页面的 CSS 布局”，它能直接读取本地代码并修改。
- 后端运维：通过聊天窗口发个指令，它就能登录服务器查看日志、重启服务或部署 Docker。
- 股票分析：它能定时抓取行情数据，结合你给的策略（Skills）生成分析报告发给你。

大脑的“思考费”（API Token）：你需要给它接入大模型（如 Anthropic 的 Claude 3.5、阿里云的通义千问 Qwen
或 OpenAI）。你需要向这些大模型厂商支付 API 调用费（按量计费）。
身体的“住宿费”（服务器）：如果你选择租云服务器，会有月租费。

了解了两个方面，对小龙虾有了一个大概的了解，就可以决定好是要在本地配置还是云端租服务器，以及对应的大模型选择。

这里介绍的是macbook本地配置openclaw，选取ds模型deepseek/deepseek-chat，是国内性价比比较高的，但是配置起来会有点复杂，当前直接下载的openclaw的provider里暂时还没有直接的ds，但是已经有了千问，感兴趣的也可以选择千问去配置。

1.安装环境：确保电脑有 Node.js (v22+) 和 Git。

a@MacBookAir ~ % node -v v25.2.1 a@MacBookAir ~ % git --version git version 2.50.1 (Apple Git-155)

2.一键安装：检查好配置后，打开终端，运行官方提供的脚本。

curl -fsSL https://openclaw.bot/install.sh | bash

3.配置deepseek进openclaw：
安装完成后，终端通常会自动启动 Onboarding Wizard。按照以下提示选择：

Onboarding mode：选择 Quickstart（快速开始）。有其余的选项一路上按默认勾选就可以了。
Model provider：选择 Custom Provider（自定义提供商）。
这一步有ds可以选就直接选ds，没有的话就选openai
openai这里会有选项，不要选择第一个，选择第二个，按照后续步骤填写从ds处得到的API KEY。

◆ OpenAI auth method │ ● OpenAI Codex (ChatGPT OAuth) │ ○ OpenAI API key │ ○ Back └

API Base URL：输入 https://api.deepseek.com/v1。（加不加/v1都可以，官方文档是不加，但由于兼容性等问题有些电脑需要加/v1才能连上）
千万记得填这个，如果不填，它默认会去连 OpenAI 的官方服务器，那你的 DeepSeek Key 就失效了。
API Key：粘贴你第一步获取的 sk-xxxx 密钥。（具体获取步骤后续讲解）

 How do you want to provide this API key? │ ● Paste API key now (Stores the key directly in OpenClaw config) │ ○ Use external secret provider └

这里选择第一个。然后把得到的key粘贴进去，回车。

default Model：不要选openai的相关模型，选手动输入（如mannual input）。这些错了也没关系，等会会再改配置文件的。
输入deepseek-chat（如果你想让它逻辑更强但稍微贵一点点，可以填 deepseek-reasoner，即 R1 模型）。新手的话用先用chat应该够了。
Model alias：随便起个名，比如 ds。
（但是这样配置ds后续openclaw tui肯定是会报识别不出来deepseek这个provider的错的，所以后续还要手动配置）

访问deepseek开放平台。
注册账号并充值（建议先充 10 元人民币，应该足够至少一个月使用）
点击左侧的 “API Keys”，创建一个 Key 并复制保存好（它只会出现一次）。

1.选择模型：按下方向键找到飞书。
◆ Select channel (QuickStart)
│ ● Telegram (Bot API) (recommended · newcomer-friendly)
│ ○ WhatsApp (QR link)
│ ○ Discord (Bot API)
│ ○ IRC (Server + Nick)
│ ○ Google Chat (Chat API)
│ ○ Slack (Socket Mode)
│ ○ Signal (signal-cli)
│ ○ iMessage (imsg)
│ ○ LINE (Messaging API)
│ ○ Feishu/Lark (飞书)
│ ○ Nostr (NIP-04 DMs)
│ ○ Microsoft Teams (Bot Framework)
│ ○ Mattermost (plugin)
│ ○ Nextcloud Talk (self-hosted)
│ ○ Matrix (plugin)
│ ○ BlueBubbles (macOS app)
│ ○ Zalo (Bot API)
│ ○ Zalo (Personal Account)
│ ○ Synology Chat (Webhook)
│ ○ Tlon (Urbit)
│ ○ Skip for now

2.飞书具体配置：这里的配置只需要先做到拿到appid和secret id这一步就可以继续去终端配置小龙虾了。当然为了后续使用方便最后也是要配齐的。
主要分为两大块，首先是简约配置，目的是为了拿到app id和secret id。其次是权限配置，需要给飞书开放对应的权限和事件回调，才能在客户端和小龙虾进行聊天。

简约配置

1.登录飞书开放平台。

权限配置

在弹窗中确认权限无误后，单击“申请开通”按钮，完成操作。

5.单击页面右上角的“确认发布”按钮，完成应用发布。

◆ Install Feishu plugin? │ ○ Download from npm (@openclaw/feishu) │ ● Use local plugin path (/opt/homebrew/lib/node_modules/openclaw/extensions/feishu) │ ○ Skip for now

这个 Plugin（插件）是给 OpenClaw 用的“通讯模块”，既然这里已经检测到本地路径下有这个插件，那直接进去用就可以了。

选完这一步，OpenClaw 就会正式加载飞书模块，接着它会找你要刚才在“飞书开放平台”申请的App ID和App Secret，复制粘贴过来就可以了。

2.飞书连接模式选择：

◆ Feishu connection mode │ ● WebSocket (default) │ ○ Webhook └

选择第一个websocket，为什么选 WebSocket 而不是 Webhook？
Webhook (麻烦)：需要公网 IP 或复杂的内网穿透（比如 cpolar）。飞书服务器主动“推”消息给你，如果你家里的 Mac 防火墙没关或者 IP 变了，它就找不到了。
WebSocket (推荐)：这是专门为本地部署设计的。你的 Mac 会主动和飞书建立一个长连接。只要你的 Mac 能上网，飞书的消息就能传进来。不需要内网穿透，不需要公网 IP。

3.区域选择：

◆ Which Feishu domain? │ ● Feishu (feishu.cn) - China │ ○ Lark (larksuite.com) - International └

中国飞书用户直接选择第一个就好了，这个和有没有梯子没关系，只要是用中国手机号注册的那数据就在feishu.cn里面。

4.权限选择：

◆ Group chat policy │ ● Allowlist - only respond in specific groups │ ○ Open - respond in all groups (requires mention) │ ○ Disabled - don't respond in groups └

5.联网设置

 Search provider │ ● Brave Search (Structured results · country/language/time filters) │ ○ Gemini (Google Search) │ ○ Grok (xAI) │ ○ Kimi (Moonshot) │ ○ Perplexity Search │ ○ Skip for now └

这个直接选最后一个跳过，联网搜索还是要付费，有需求的话可以配一下第一个，没有强需求的话ds深度思考也够用了。

6.安装技能

 Configure skills now? (recommended) │ ● Yes / ○ No

7.接下来一连串询问直接按默认来就行，基本上都是多余的付费选项，包括要不要开通位置服务这些，刚开始全部拒绝就行。

8.允许的钩子

Enable hooks? │ ◻ Skip for now │ ◻ 🚀 boot-md │ ◻ 📎 bootstrap-extra-files │ ◻ 📝 command-logger │ ◻ 💾 session-memory └

9.交流的界面

 How do you want to hatch your bot? │ ● Hatch in TUI (recommended) │ ○ Open the Web UI │ ○ Do this later

直接选 ● Hatch in TUI (recommended)。

为什么选这个？

实时监控：TUI（终端用户界面）会直接在你的 Mac 终端里显示运行日志。你可以亲眼看到 DeepSeek 是如何通过 WebSocket
连接飞书的。如果中间报错了（比如网络断了或 Key 填错了），在这里能立刻看到原因。
一键运行：选这个会立即激活你的机器人。
调试方便：对于做后端运维的你来说，看终端日志是最自然、最直观的方式。

理论上来说应该可以和ai聊天了，但刚刚ds的配置还是有问题的，现在还需要手动调整一下。

│ ◇ How do you want to hatch your bot? │ Hatch in TUI (recommended) openclaw tui - ws://127.0.0.1:18789 - agent main - session main session agent:main:main Wake up, my friend! ⚠️ Agent failed before reply: Unknown model: anthropic/deepseek-chat. Logs: openclaw logs --follow gateway connected | idle agent main | session main (openclaw-tui) | anthropic/deepseek-chat | tokens ?/200k

由于我们手动输入模型的时候只输入了deepseek-chat，系统没有识别出对应的ds这个provider所以连接失败了。

nano ~/.openclaw/agents/main/agent/auth-profiles.json

刚开始可能是这样的

{ “version”: 1, “profiles”: {

"openai:default": { "type": "api_key", "provider": "openai", "key": "sk-xx" }

} }

修改：

{ “version”: 1, “profiles”: {

"deepseek:default": { "type": "api_key", "provider": "deepseek", "key": "sk-你的DeepSeek_API_KEY這裡貼上" }

} }

3.修改openclaw.json文件（最好找到原有的文件并在上面添加，一般来说都能找到，没有的话就只能新建一个）

nano ~/.openclaw/openclaw.json

{ “models”: {

"mode": "merge", "providers": { "deepseek": { "baseUrl": "https://api.deepseek.com", "apiKey": "${DEEPSEEK_API_KEY:-}", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat (V3.2)", "reasoning": false, "input": ["text"], "cost": { "input": 0.00000028, "output": 0.00000042, "cacheRead": 0.000000028, "cacheWrite": 0.00000028 }, "contextWindow": , "maxTokens": 8192 }, { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner (V3.2)", "reasoning": true, "input": ["text"], "cost": { "input": 0.00000028, "output": 0.00000042, "cacheRead": 0.000000028, "cacheWrite": 0.00000028 }, "contextWindow": , "maxTokens": 65536 } ] } }

}, “agents”: {

"defaults": { "models": { "deepseek/deepseek-chat": {}, "deepseek/deepseek-reasoner": {} } }

} }

4.设置环境变量：保险起见再设置一次环境变量放API KEY

export DEEPSEEK_API_KEY=“your-api-key-here”

openclaw models list | grep deepseek

若为以下情况，则为正确

deepseek/deepseek-chat text 125k no yes default,configured deepseek/deepseek-reasoner text 125k no yes configured

（2）重新设置默认模型（可选）

openclaw models set deepseek/deepseek-reasoner

gateway connected | idle
 agent main | session main (openclaw-tui) | deepseek/deepseek-chat | tokens 36k/128k (28%)

macOS配置openclaw+deepseek大模型+飞书小助手

简约配置

权限配置

相关推荐