Harness 与 Agent 工程 · AI研发与测试工程 · 2026-03-06

OpenClaw 本地部署完整教程

三步搞定个人AI助手!用DeepSeek API+飞书在本地部署OpenClaw,低成本高效能。

核心内容:

  1. 详细安装步骤:从环境准备到OpenClaw部署
  2. DeepSeek模型配置与飞书应用集成指南
  3. 成本估算与日常使用技巧

使用 DeepSeek API + 飞书,在 Mac/Linux/Windows 本地部署个人 AI 助手

📋 目录


准备工作

必需条件

  1. Node.js 18+

预估成本


第一步:安装 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 创建企业自建应用

  1. 点击"创建企业自建应用"
  2. 填写应用信息:

点击"创建"

3.3 获取应用凭证

在应用详情页面,点击"凭证与基础信息":

  1. 复制 App ID(格式:cli_xxxxxxxxxx)
  2. 点击"查看",复制 App Secret

重要: 将这两个值保存到记事本,稍后会用到。

3.4 配置应用权限

  1. 点击左侧"权限管理"
  2. 点击"批量导入"按钮
  3. 粘贴以下 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": []}}
  1. 点击"确定"导入权限

3.5 配置机器人

  1. 点击左侧"机器人"菜单
  2. 机器人功能已默认启用
  3. 可以填写"如何开始使用"的引导文字(可选)

3.6 配置事件订阅

  1. 点击左侧"事件与回调"
  2. 选择"使用长连接接收事件"
  3. 此时会提示"应用未建立长连接",这是正常的

重要:需要先启动 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"

说明:


第五步:启动和测试

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 已经启动并建立了长连接,回到飞书开放平台:

  1. 刷新"事件与回调"页面
  2. 应该能看到"长连接已建立"的提示
  3. 点击"添加事件"
  4. 搜索并添加:im.message.receive_v1(接收消息)
  5. 保存

5.3 发布飞书应用

  1. 点击左侧"版本管理与发布"
  2. 点击"创建版本"
  3. 填写版本说明(例如:初始版本)
  4. 点击"保存"
  5. 点击"申请发布"
  6. 提交审核(企业自建应用通常自动通过)

5.4 在飞书中找到机器人

  1. 打开飞书客户端(桌面版或手机版)
  2. 点击"+"或"新建会话"
  3. 搜索你的机器人名称:OpenClaw Bot
  4. 点击机器人头像,开始对话

5.5 获取飞书用户 ID

  1. 在飞书中向机器人发送任意消息,例如:你好
  2. 查看运行 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
  1. 记录你的飞书用户 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…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/Openclaw/2026030691254.html