使用 DeepSeek API + 飞书,在 Mac/Linux/Windows 本地部署个人 AI 助手
📋 目录
- 准备工作
- 第一步:安装 OpenClaw
- 第二步:配置 DeepSeek 模型
- 第三步:创建飞书应用
- 第四步:连接飞书与 OpenClaw
- 第五步:启动和测试
- 日常使用
- 进阶配置
- 常见问题
准备工作
必需条件
- Node.js 18+
- Mac:
brew install node - Windows: 下载安装 https://nodejs.org
-
Linux:
sudo apt install nodejs npm或sudo yum install nodejs -
DeepSeek API 密钥
- 访问 https://platform.deepseek.com
- 注册并创建 API Key
- 充值少量余额(建议 ¥20 起)
- 飞书企业账号(免费)
- 访问 https://www.feishu.cn 注册企业版
- 个人也可以创建企业账号
预估成本
- OpenClaw 软件: 免费开源
- DeepSeek API: 约 ¥0.001/千 tokens(超低价)
- 飞书企业版: 免费
- 电费: 约 ¥5-10/月(如果 24/7 运行) 月度预估: 轻度使用约 ¥10-30
第一步:安装 OpenClaw
1.1 全局安装
打开终端,执行:
npm install -g openclaw@latest
安装时间:约 1-2 分钟
1.2 验证安装
openclaw --version
应该显示版本号,例如:2026.2.26
1.3 安装飞书插件
openclaw plugins install @openclaw/feishu
第二步:配置 DeepSeek 模型
2.1 创建配置目录
mkdir -p ~/.openclaw
2.2 创建配置文件
方法一:使用命令创建(推荐)
cat > ~/.openclaw/openclaw.json << 'EOF'{"models": { "mode": "merge", "providers": { "deepseek": { "baseUrl": "https://api.deepseek.com/v1", "apiKey": "你的DeepSeek密钥", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat (v3)", "reasoning": false, "input": ["text"], "cost": { "input": 2.8e-7, "output": 4.2e-7, "cacheRead": 2.8e-8, "cacheWrite": 2.8e-7 }, "contextWindow": 128000, "maxTokens": 8192 } ] } } },"Agents": { "defaults": { "model": { "primary": "deepseek/deepseek-chat" }, "models": { "deepseek/deepseek-chat": {} } } }}EOF
重要: 把 你的DeepSeek密钥 替换成你的实际 API 密钥(以 sk- 开头)
方法二:手动编辑
nano ~/.openclaw/openclaw.json
复制上面的 JSON 内容,修改 API 密钥后保存(Ctrl + O,回车,Ctrl + X)
2.3 验证配置
openclaw models list
应该能看到:deepseek/deepseek-chat
第三步:创建飞书应用
3.1 访问飞书开放平台
打开浏览器:https://open.feishu.cn/app
使用飞书账号登录,点击"开发者后台"
3.2 创建企业自建应用
- 点击"创建企业自建应用"
- 填写应用信息:
- 应用名称:
OpenClaw Bot(或你喜欢的名字) - 应用描述:
我的个人 AI 助手 - 应用图标: 上传一个图标(可选)
点击"创建"
3.3 获取应用凭证
在应用详情页面,点击"凭证与基础信息":
- 复制 App ID(格式:
cli_xxxxxxxxxx) - 点击"查看",复制 App Secret
重要: 将这两个值保存到记事本,稍后会用到。
3.4 配置应用权限
- 点击左侧"权限管理"
- 点击"批量导入"按钮
- 粘贴以下 JSON 配置:
{ "scopes": { "tenant": [ "contact:user.base:readonly", "contact:contact.base:readonly", "im:chat", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:send_as_bot" ], "user": []}}
- 点击"确定"导入权限
3.5 配置机器人
- 点击左侧"机器人"菜单
- 机器人功能已默认启用
- 可以填写"如何开始使用"的引导文字(可选)
3.6 配置事件订阅
- 点击左侧"事件与回调"
- 选择"使用长连接接收事件"
- 此时会提示"应用未建立长连接",这是正常的
重要:需要先启动 OpenClaw 建立连接,才能添加事件。
暂时跳过这一步,在第四步配置完 OpenClaw 并启动后再回来完成。
3.7 暂时不发布应用
注意:先不要发布应用,等配置完 OpenClaw 并添加事件订阅后再发布。
第四步:连接飞书与 OpenClaw
4.1 配置飞书频道
使用命令行配置(替换为你的实际 App ID 和 Secret):
openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.accounts.main.appId "cli_你的AppID"openclaw config set channels.feishu.accounts.main.appSecret "你的AppSecret"openclaw config set channels.feishu.accounts.main.botName "OpenClaw Bot"openclaw config set plugins.entries.feishu.enabled true
4.2 设置访问策略(暂时跳过)
注意: 这一步暂时跳过,等获取到你的飞书用户 ID 后再配置。
默认配置会阻止未授权用户,我们需要先获取用户 ID,然后添加到白名单。
4.3 设置 Gateway 模式
openclaw config set gateway.mode local
4.4 配置工作目录(重要)
OpenClaw 默认只能在工作目录内操作文件。设置工作目录:
选项一:使用桌面作为工作目录(推荐)
openclaw config set agents.defaults.workspace "~/Desktop"
或者使用完整路径:
openclaw config set agents.defaults.workspace "/Users/你的用户名/Desktop"
选项二:使用默认工作目录
openclaw config set agents.defaults.workspace "~/.openclaw/workspace"
文件会创建在 ~/.openclaw/workspace 目录下。
选项三:使用其他目录
openclaw config set agents.defaults.workspace "/path/to/your/folder"
说明:
- 机器人只能在工作目录内创建、编辑、删除文件
- 如果尝试访问工作目录外的文件,会报错:
Path escapes workspace root - 建议使用桌面或专门的项目文件夹
第五步:启动和测试
5.1 启动 Gateway
openclaw gateway --port 18789 --verbose
成功标志:看到以下日志
Gateway listening on 127.0.0.1:18789feishu[main]: WebSocket client startedws client ready
5.2 回到飞书开放平台添加事件
现在 OpenClaw 已经启动并建立了长连接,回到飞书开放平台:
- 刷新"事件与回调"页面
- 应该能看到"长连接已建立"的提示
- 点击"添加事件"
- 搜索并添加:
im.message.receive_v1(接收消息) - 保存
5.3 发布飞书应用
- 点击左侧"版本管理与发布"
- 点击"创建版本"
- 填写版本说明(例如:
初始版本) - 点击"保存"
- 点击"申请发布"
- 提交审核(企业自建应用通常自动通过)
5.4 在飞书中找到机器人
- 打开飞书客户端(桌面版或手机版)
- 点击"+"或"新建会话"
- 搜索你的机器人名称:
OpenClaw Bot - 点击机器人头像,开始对话
5.5 获取飞书用户 ID
- 在飞书中向机器人发送任意消息,例如:
你好 - 查看运行 Gateway 的终端日志,会看到类似:
feishu[main]: received message from ou_e34e1249c5d5b8af8ec7767a792231dbfeishu[main]: blocked unauthorized sender ou_e34e1249c5d5b8af8ec7723a792661db
或者机器人会返回:
OpenClaw: access not configured.Your Feishu user id: ou_e34e1249c5d5b8af8ec7237a792661dbPairing code: P42TJJ78
- 记录你的飞书用户 ID(
ou_开头的那串字符)
5.6 配置白名单
打开新终端(保持 Gateway 运行),执行:
openclaw config set channels.feishu.dmPolicy allowlistopenclaw config set channels.feishu.allowFrom '["ou_你的用户ID"]'
例如:
openclaw config set channels.feishu.dmPolicy allowlistopenclaw config set channels.feishu.allowFrom '["ou_e34e1249c5d5b8af8ec77623792661db"]'
如果有多个用户需要使用:
openclaw config set channels.feishu.allowFrom '["ou_用户1", "ou_用户2", "ou_用户3"]'
5.7 重启 Gateway
在运行 Gateway 的终端按 Ctrl + C 停止,然后重新启动:
openclaw gateway --port 18789 --verbose
5.8 测试对话
重启 Gateway 后,在飞书中再次发送消息:
你好,请介绍一下自己
这次机器人应该会正常回复了!
在飞书中发送消息:
你好,请介绍一下自己
如果一切正常,机器人会用 DeepSeek 模型回复你!
日常使用
启动 Gateway
前台运行(查看日志)
openclaw gateway --port 18789 --verbose
按 Ctrl + C 停止
后台运行(推荐)
nohup openclaw gateway --port 18789 --verbose > ~/openclaw.log 2>&1 &
查看日志:
tail -f ~/openclaw.log
停止后台进程:
pkill -f "openclaw gateway"
设置开机自启(可选)
Mac/Linux
openclaw daemon installopenclaw daemon start
查看状态:
openc…