AI知识库

AutoClaw 使用

27分钟阅读

1. 产品概述与背景

1.1 什么是 AutoClaw

AutoClaw（中文名：澳龙）是智谱（Zhipu AI）于 2026 年 3 月 10 日发布的本地化 AI Agent 工具，它是 OpenClaw（小龙虾）的桌面客户端版本，定位为”人人可用的本地 AI 助手”。

AutoClaw 的核心理念是让 AI 技术走进千家万户，通过本地化部署的方式，用户可以在自己的电脑上拥有一套完整的 AI 自动化工作流，无需依赖云端服务，数据本地处理，隐私安全有保障。

1.2 AutoClaw 与 OpenClaw 的关系

特性OpenClaw（命令行版）AutoClaw（桌面客户端）
部署方式需要手动配置环境一键安装
界面命令行界面图形化界面
适合用户技术人员、开发者普通用户
安装难度较高简单
预置 Skills需手动安装50+ 开箱即用

1.3 核心产品定位

传统 AI 云服务     →     AutoClaw 本地部署
       ↓                       ↓
数据上传云端           数据本地处理
隐私风险高               隐私安全
依赖网络连接             离线可用（部分功能）

1.4 发展历程与版本沿革

时间版本更新内容
2026年3月10日v1.0 正式版AutoClaw 正式发布，macOS/Windows 双平台
2026年3月v1.1飞书集成功能上线
2026年4月v1.2支持更多模型接入
2026年v2.0（规划中）更多企业级功能

1.5 访问地址与资源

资源地址
官网下载https://autoglm.zhipuai.cn/autoclaw/
官方文档https://docs.autoclaw.ai/
社区论坛https://community.autoclaw.ai/
GitHubhttps://github.com/zhipuai/AutoClaw

2. 核心功能与特性

2.1 六大核心功能

功能说明适用场景
🤖 AI 对话自然语言对话，AI 执行任务日常问答、任务下达
📁 文件管理读取、编辑、创建本地文件文档处理、数据整理
🌐 网页自动化浏览器自动化操作信息采集、网页测试
💻 代码开发代码编写、调试、项目构建编程开发、技术学习
📊 数据分析Excel/CSV 数据处理报表生成、数据统计
📱 即时通讯飞书等平台集成消息处理、任务同步

2.2 产品特色

特色详情
🆓 免费额度智谱提供一定免费额度，可 0 成本体验
🔓 模型开放完全开放模型接入，支持任意模型的 Coding Plan 或 API
📦 50+ 预置 Skills开箱即用，覆盖内容创作、办公、代码、营销、金融投研
🏠 本地化部署数据本地处理，隐私安全
🇨🇳 国产优化深度适配中文环境，支持国产大模型
🔌 多平台集成支持飞书等即时通讯工具

2.3 支持的模型

AutoClaw 支持多种大模型接入：

模型提供商特点是否需要 API Key
Pony-Alpha-2智谱（优化版）专为 AutoClaw 优化内置额度（需登录）
GLM-4智谱国产旗舰模型需要
DeepSeek深度求索推理能力强需要
Kimi月之暗面长文本处理需要
GPT-4oOpenAI国际旗舰模型需要
Claude 3.5Anthropic代码能力强需要

2.4 支持的操作系统

操作系统版本要求安装方式
WindowsWindows 10 及以上.exe 安装包
macOSmacOS 10.15 及以上.dmg 安装包
LinuxUbuntu 20.04+AppImage / DEB

3. 安装与登录

3.1 系统要求

组件最低要求推荐配置
操作系统Windows 10 64位Windows 11
内存8 GB16 GB
存储空间5 GB 可用空间10 GB 以上
网络需联网（验证/下载模型）宽带

3.2 Windows 安装步骤

步骤 1：下载安装包

  1. 访问官网：https://autoglm.zhipuai.cn/autoclaw/
  2. 点击「立即下载」按钮
  3. 选择 Windows 版本
  4. 下载完成后，双击打开 .exe 安装包 步骤 2：运行安装程序
安装向导界面：
┌─────────────────────────────────────┐
│         AutoClaw 安装向导             │
│─────────────────────────────────────│
│  欢迎使用 AutoClaw 安装程序           │
│                                     │
│  [下一步(N) >]                        │
└─────────────────────────────────────┘

  1. 点击「下一步」

  2. 阅读并同意许可协议

  3. 选择安装路径（建议默认）

  4. 点击「安装」，等待完成 步骤 3：首次启动

  5. 安装完成后，点击「完成」

  6. AutoClaw 会自动启动

  7. 首次启动需要初始化环境，请耐心等待

3.3 macOS 安装步骤

步骤 1：下载安装包

  1. 访问官网下载 macOS 版本

  2. 打开下载的 .dmg 文件 步骤 2：安装应用

  3. 将 AutoClaw 拖入「应用程序」文件夹

  4. 首次打开时，如果提示「无法验证开发者」： 步骤 3：启动应用

  5. 在 Launchpad 中找到 AutoClaw

  6. 双击启动

3.4 账号登录

登录流程：

  1. 打开 AutoClaw 应用
  2. 界面显示登录页面
  3. 输入手机号，点击「获取验证码」
  4. 输入收到的短信验证码
  5. 点击「登录」

注意：首次启动会自动初始化环境，请保持网络连接，耐心等待。

4. 首次配置向导

登录后，系统会引导你完成「快速配置」，这是优化使用体验的关键步骤。

4.1 设置 AI 称呼与角色

配置项说明示例
你的名称AI 如何称呼你张三
AI 角色AI 扮演的角色产品经理 / 开发者 / 运营

4.2 选择使用场景

勾选你的主要使用场景，AI 会据此优化响应：

场景说明
💻 编程开发代码编写、调试、技术问题
✍️ 内容创作文章、文案、创意写作
📊 数据分析Excel 处理、报表生成
📈 营销推广社交媒体运营、广告投放
📚 学习研究知识问答、资料整理
💼 办公自动化文档处理、流程自动化

4.3 指定工作目录

工作目录是 AI 默认读写文件的文件夹，建议选择常用项目目录。

选项说明
指定目录选择一个固定的文件夹作为工作区
每次询问每次操作时询问目录位置

安全建议：开启「限制文件访问」，将 AI 操作范围严格限制在工作区内。

4.4 快速配置完成

完成配置后，界面会显示：

🎉 配置完成！
 
你可以在下方输入框中向 AI 下达指令了。
 
示例指令：
• "帮我整理一下桌面文件"
• "写一个 Python 爬虫"
• "分析这份销售数据"

5. 模型配置与切换

5.1 模型选择策略

模型最佳场景特点
Pony-Alpha-2日常对话、任务执行智谱优化，响应快，免费额度
GLM-4复杂推理、长文本国产旗舰，综合能力强
DeepSeek R1代码生成、逻辑推理性价比高，推理能力强
Kimi长文档分析超长上下文
GPT-4o国际编程任务代码质量高
Claude 3.5代码审查、重构理解力强

5.2 配置默认模型

方法一：通过设置界面

  1. 点击左上角「设置」图标
  2. 进入「模型与 API」选项
  3. 选择「默认模型」
  4. 保存设置 方法二：对话切换
在对话中输入：
/model deepseek-r1
 
AI 回复：
已切换到 DeepSeek R1 模型，现在可以进行更复杂的推理任务。

5.3 接入第三方模型 API

如果需要使用 DeepSeek、Kimi、GLM 等模型，需要自行配置 API Key：

配置步骤：

  1. 打开「设置 → 模型与 API」
  2. 点击「添加模型」
  3. 填写配置信息： | 配置项 | 说明 | 示例 | | --- | --- | --- | | 模型名称 | 给模型起个名字 | DeepSeek R1 | | API 地址 | 模型提供商的 API 端点 | https://api.deepseek.com | | API Key | 你的密钥 | sk-xxxxxxxx | | 模型 ID | 具体使用的模型 | deepseek-reasoner |

配置示例：

{
  "model": "deepseek-r1",
  "apiBase": "https://api.deepseek.com/v1",
  "apiKey": "sk-xxxxxxxxxxxxxxxx",
  "modelId": "deepseek-reasoner"
}

5.4 获取 API Key 的常用平台

模型API 获取地址特点
DeepSeekhttps://platform.deepseek.com免费额度多
Kimihttps://platform.moonshot.ai长文本能力强
GLMhttps://open.bigmodel.cn国产首选
OpenAIhttps://platform.openai.com国际模型
Anthropichttps://console.anthropic.comClaude 系列

6. 工作区与权限管理

6.1 工作区概念

工作区是 AutoClaw 操作文件的根目录，AI 只能在此范围内读写文件，确保系统安全。

工作区结构：
C:\Users\admin\AutoClaw_Workspace\
├── projects\          # 项目文件
├── documents\         # 文档资料
├── downloads\         # 下载文件
└── temp\             # 临时文件

6.2 工作区设置

  1. 打开「设置 → 工作区」
  2. 点击「更改工作目录」
  3. 选择目标文件夹
  4. 确认保存

6.3 权限控制

权限项说明建议
限制文件访问将 AI 操作限制在工作区内✅ 开启
允许执行命令允许 AI 执行终端命令⚠️ 谨慎开启
允许网络访问允许 AI 访问互联网按需开启
执行前确认AI 执行操作前需人工确认✅ 开启

6.4 沙箱路径配置

沙箱是更细粒度的文件访问控制：

{
  "sandbox": {
    "enabled": true,
    "allowedPaths": [
      "C:/Users/admin/workspace",
      "D:/projects"
    ],
    "blockedPaths": [
      "C:/Windows",
      "C:/Program Files"
    ]
  }
}

安全建议：生产环境务必配置沙箱路径，防止 AI 误操作系统文件。

7. 对话式指令操作

7.1 基本对话流程

AutoClaw 的核心操作方式是自然语言对话：

用户输入：
帮我整理一下桌面文件，按类型分类
 
AutoClaw 执行：
🔄 正在分析桌面文件...
🔄 正在按类型分类...
✅ 完成！已整理 127 个文件：
   - 文档资料: 35 个
   - 图片文件: 28 个
   - 代码文件: 22 个
   - 其他文件: 42 个

7.2 常用指令示例

指令类型示例说明
文件整理”帮我整理下载文件夹”按类型/日期整理
代码开发”写一个 Python 爬虫”生成完整代码
数据分析”分析这份 Excel 报表”数据统计可视化
文档处理”把这份 PDF 转成文字”格式转换
网页操作”帮我查下这个网页内容”信息采集
写作创作”写一篇产品介绍文案”内容生成

7.3 对话技巧

原则：越具体越好

❌ 差："帮我写点东西"
 
✅ 好："帮我写一篇 800 字的产品介绍文案，
     面向年轻用户，语言活泼有趣，
     主要介绍我们新推出的智能手环"

7.4 执行确认机制

为保障安全，AI 在执行敏感操作前会请求确认：

⚠️ 执行确认
 
AI 计划执行以下操作：
• 删除文件: temp_old.zip
• 修改文件: config.json
 
[确认执行] [取消操作]

8. 预置 Skills（技能）详解

8.1 Skills 概述

AutoClaw 预置了 50+ 主流 Skills，覆盖高频应用场景，开箱即用。

8.2 Skills 分类

分类数量代表技能
📝 内容创作10+文章写作、文案生成、标题优化
💼 办公效率10+Excel 处理、PPT 制作、邮件处理
💻 编程开发10+代码生成、代码调试、技术文档
📈 营销推广10+社交媒体运营、广告文案、SEO
💰 金融投研5+股票分析、财报解读、投资研究
🔧 工具效率5+文件整理、网页抓取、OCR 识别

8.3 常用 Skills 介绍

内容创作类

Skill功能
文章写作根据主题生成完整文章
文案生成广告文案、推广文案
标题优化生成吸引人的标题
小红书笔记生成小红书风格内容

办公效率类

Skill功能
Excel 处理数据分析、公式生成
PPT 制作生成演示文稿大纲
PDF 解析提取 PDF 内容
邮件处理邮件撰写、回复

编程开发类

Skill功能
代码生成多语言代码生成
代码调试Bug 定位与修复
技术文档API 文档生成
数据库设计SQL 建表语句

营销推广类

Skill功能
社交媒体运营微博、朋友圈内容
SEO 优化关键词布局
广告文案投放广告创意
竞品分析市场分析报告

8.4 Skills 使用方法

方法一：直接对话触发

用户：帮我写一篇产品发布文案
 
AI（自动调用文案技能）：
好的，我来帮你生成产品发布文案...

方法二：指定技能

用户：@代码生成 写一个用户登录功能
 
AI（使用代码生成技能）：
好的，我来为你生成登录功能代码...

8.5 查看已安装 Skills

  1. 打开「设置 → 技能管理」
  2. 查看已安装的 Skills 列表
  3. 点击技能名称查看详情

9. 飞书集成配置

9.1 飞书集成概述

AutoClaw 支持一键接入飞书，在飞书中直接调用 AI 能力，实现消息处理、文档管理、任务自动化。

9.2 飞书集成前提

前提说明
AutoClaw 账号已完成登录
飞书企业账号需要管理员权限
API Key如使用自定义模型

9.3 飞书集成步骤

步骤 1：创建飞书应用

  1. 访问飞书开放平台：https://open.feishu.cn/

  2. 进入「开发者后台」

  3. 点击「创建企业自建应用」

  4. 填写信息并创建 步骤 2：添加机器人

  5. 在应用详情页点击「添加机器人」 步骤 3：配置权限

权限名称说明
im:message消息相关权限
im:chat群聊相关权限
im:message.group_at_msg群 @消息
contact:user.base联系人基础信息
drive:file云盘文件管理

步骤 4：在 AutoClaw 中配置飞书

  1. 打开 AutoClaw「设置 → IM频道」

  2. 选择「飞书」

  3. 填写飞书应用的 App ID 和 App Secret

  4. 配置接收消息的群聊 步骤 5：发布应用

  5. 回到飞书开放平台

  6. 点击「发布应用」

  7. 创建版本并提交审核

9.4 飞书使用示例

在飞书群聊中：
@AutoClaw 帮我整理一下上周的销售数据
 
AutoClaw 回复：
🔄 正在分析销售数据...
✅ 完成！上周销售数据摘要：
   - 总销售额: 128 万元
   - 环比增长: 15%
   - 热销产品: 产品 A、产品 B

9.5 飞书 Skill 功能

功能说明
📝 文档管理自动创建和编辑飞书云文档
📊 多维表格操作 Bitable 数据
📁 文件管理管理云空间文件
📚 知识库维护 Wiki 内容
👥 权限管理管理协作权限
🔔 消息通知发送定制化消息

10. 进阶管理：Skills 安装与卸载

10.1 SkillHub 技能市场

SkillHub 是 AutoClaw 的技能市场，提供更多自定义 Skills。

  1. 打开 AutoClaw
  2. 进入「技能市场」
  3. 浏览和搜索 Skills

10.2 安装新 Skill

通过命令行安装：

# 查看所有可用 Skills
openclaw skills list
 
# 查看技能详情
openclaw skills info <skill-name>
 
# 安装技能
openclaw skills install <skill-name>
 
# 卸载技能
openclaw skills uninstall <skill-name>

通过界面安装：

  1. 打开「技能管理」
  2. 点击「浏览市场」
  3. 找到目标技能
  4. 点击「安装」

10.3 推荐安装的 Skills

Skill功能安装命令
wechat微信自动化openclaw skills install wechat
githubGitHub 操作openclaw skills install github
browser浏览器自动化openclaw skills install browser
pdfPDF 处理openclaw skills install pdf
xlsxExcel 处理openclaw skills install xlsx

10.4 更新与维护

操作命令
更新所有 Skillsopenclaw skills update
检查更新openclaw skills check
查看已安装openclaw skills installed

11. 安全配置与风险控制

11.1 安全架构概览

┌─────────────────────────────────────┐
│          安全防护层级                  │
├─────────────────────────────────────┤
│  1. 认证层：JWT Token 验证            │
│  2. 访问层：消息来源白名单             │
│  3. 执行层：操作前确认机制             │
│  4. 沙箱层：文件路径限制               │
└─────────────────────────────────────┘

11.2 JWT 认证配置

配置步骤：

  1. 打开「设置 → 安全」
  2. 开启「JWT 认证」
  3. 设置 Token 密钥
  4. 保存配置 配置示例：
{
  "security": {
    "jwt": {
      "enabled": true,
      "token": "your-secret-token-here"
    }
  }
}

建议：在非局域网环境下务必开启 JWT 认证，防止未授权访问。

11.3 消息来源控制

dmPolicy 策略控制可向 AutoClaw 发送指令的主体：

模式说明适用场景
whitelist（白名单）仅白名单来源可发送指令高安全要求
open（开放）任何来源均可发送指令测试环境

配置示例：

{
  "security": {
    "dmPolicy": "whitelist",
    "allowFrom": [
      "wechat:your-id",
      "feishu:群聊ID"
    ]
  }
}

警告：切勿在生产环境将 dmPolicy 设置为 open，否则任何人都可以控制你的电脑！

11.4 执行确认机制

配置项说明建议
执行确认AI 执行操作前需人工确认✅ 开启
敏感操作确认删除、执行命令等需确认✅ 开启
超时时间等待确认的超时时间60 秒

11.5 沙箱路径限制

{
  "sandbox": {
    "enabled": true,
    "allowedPaths": [
      "C:/Users/admin/AutoClaw_Workspace",
      "D:/Projects"
    ],
    "blockedPaths": [
      "C:/Windows",
      "C:/Program Files",
      "C:/Users/admin/Desktop/重要文件"
    ]
  }
}

11.6 安全检查清单

检查项状态
✅ JWT 认证已开启（非局域网环境）☐
✅ dmPolicy 设为白名单模式☐
✅ 执行确认已开启☐
✅ 沙箱已配置☐
✅ 敏感目录已加入黑名单☐
✅ 定期查看操作日志☐

12. 常用命令速查表

12.1 核心命令

命令作用
openclaw gateway启动网关服务（核心，必须运行）
openclaw gateway start后台启动网关
openclaw gateway stop停止网关
openclaw gateway restart重启网关
openclaw status查看服务状态

12.2 配置命令

命令作用
openclaw onboard首次全局配置
openclaw setup首次配置（初始化配置文件）
openclaw configure交互式配置
openclaw config get查看当前配置
openclaw config set设置配置项

12.3 技能管理命令

命令作用
openclaw skills list查看所有可用技能
openclaw skills install 安装技能
openclaw skills uninstall 卸载技能
openclaw skills update更新所有技能
openclaw skills info 查看技能详情

12.4 插件管理命令

命令作用
openclaw plugins list查看已安装插件
openclaw plugins install 安装插件
openclaw plugins uninstall 卸载插件

12.5 日志与调试

命令作用
openclaw logs查看运行日志
openclaw logs —error只看错误日志
openclaw debug调试模式
openclaw doctor系统诊断

13. 常见问题与故障排查

13.1 安装问题

Q1：Windows 安装失败，提示”无法验证开发者”

  1. 右键点击安装文件 → 选择「属性」→ 勾选「解除锁定」→ 重新运行安装程序 Q2：macOS 无法打开，提示”无法验证开发者”

前往「系统设置 → 隐私与安全性」→ 点击「仍要打开」→ 输入密码确认

Q3：首次启动卡住不动

首次启动需要下载模型，请确保网络连接。等待 3-5 分钟。如果长时间无响应，尝试重启应用。

13.2 登录问题

Q4：收不到验证码

检查手机网络信号，确认手机未拦截短信，稍等片刻后重新获取

Q5：登录提示”账号异常”

确认使用的是官方版本，清除缓存后重试，联系官方客服

13.3 模型问题

Q6：提示”API Key 无效”

检查 API Key 是否正确复制，确认 API Key 有余额，检查 API 地址是否正确

Q7：模型响应很慢

检查网络连接，切换到响应更快的模型（如 Pony-Alpha-2），减少对话上下文长度

13.4 功能问题

Q8：飞书连接不上

确认飞书应用已发布，检查 App ID 和 Secret 是否正确，确认已配置正确的事件权限

Q9：文件操作失败

检查文件路径是否正确，确认工作区目录有写入权限，检查文件是否被其他程序占用

Q10：Skills 无法使用

检查 Skills 是否已安装，重启网关服务：openclaw gateway restart，查看 Skills 是否有更新

13.5 性能问题

Q11：内存占用过高

关闭不需要的项目，清理对话历史，重启 AutoClaw

Q12：响应速度变慢

检查网络状态，清理缓存：「设置 → 高级 → 清理缓存」，重启应用

14. 企业级应用场景

14.1 典型应用场景

场景应用描述效果
📊 财务自动化自动处理报销、生成报表效率提升 70%
📝 文档处理合同审核、报告生成时间节省 50%
💬 客服集成飞书客服消息处理响应速度提升
📈 数据分析销售数据自动分析洞察更快
🔄 工作流自动化定时任务、流程触发人工干预减少

14.2 团队协作配置

┌─────────────────────────────────────┐
│           企业部署架构                │
├─────────────────────────────────────┤
│   员工终端                           │
│   ↓                                 │
│   AutoClaw（本地部署）               │
│   ↓                                 │
│   企业 API（GLM/DeepSeek）           │
│   ↓                                 │
│   飞书/钉钉（消息渠道）               │
└─────────────────────────────────────┘

14.3 企业部署检查清单

项目说明
☐ 统一模型配置团队使用相同模型
☐ 权限集中管理统一配置权限策略
☐ 日志审计开启操作日志
☐ 安全加固JWT + 白名单 + 沙箱
☐ 培训支持提供使用培训

15. 附录

15.1 官方资源链接

资源地址
官网下载https://autoglm.zhipuai.cn/autoclaw/
官方文档https://docs.autoclaw.ai/
社区论坛https://community.autoclaw.ai/
GitHubhttps://github.com/zhipuai/AutoClaw

15.2 快捷键速查

快捷键功能
Ctrl + Enter发送消息
Ctrl + L清除对话
Ctrl + S保存对话
Ctrl + ,打开设置
Esc取消操作

15.3 版本信息

版本发布日期主要更新
v1.02026-03-10正式版发布
v1.12026-03-20飞书集成
v1.22026-04-05模型扩展

15.4 术语表

术语说明
AgentAI 智能体，能执行任务的 AI
Skill技能，特定场景的功能包
Gateway网关，AutoClaw 的核心服务
Channel渠道，消息输入来源
沙箱安全的文件操作隔离环境

关系图谱