核心功能全览

OpenClacky 是一个功能完整的本地 AI Agent 平台。本文带你快速了解所有核心能力。

会话管理

会话是你与 Agent 的持久对话上下文，保存完整的消息历史和任务记录。

启动服务器后访问 http://127.0.0.1:7070，在侧边栏可以新建、切换、重命名和删除会话。每个会话完全独立，服务器重启后自动恢复。

📖 会话管理

长期记忆系统

复杂会话结束后，Agent 会自动将重要知识（决策、架构选择、你的偏好等）保存到 ~/.clacky/memories/，供未来会话复用。无需手动触发，完全自动。

当 Agent 遇到有历史上下文的话题时会自动检索；你也可以显式要求：

回忆一下我们之前对认证系统做的决策

📖 长期记忆系统

智能压缩与历史回顾

对话历史过长时，Agent 会自动压缩早期消息、保留近期完整上下文，让你可以长时间多任务工作而不必担心费用。

随时可以要求 Agent 回顾：

刚才我们讨论了什么？

Skill 系统

Skill 是可复用的 AI 能力包，让 Agent 具备特定领域的专业能力。

直接描述需求，Agent 自动选择合适的 Skill；也可以用 / 前缀直接调用，例如 /browser-setup、/deploy。

OpenClacky 内置了常用 Skill：浏览器配置、IM 连接、定时任务、代码探索、项目部署等，也支持安装第三方 Skill 或创建自定义 Skill。

📖 如何使用 Skill · 内置 Skill 一览

定时任务

创建自动化任务，按计划执行，无需人工干预。

直接描述需求即可：

创建一个每天早上 9 点抓取 AI 新闻的任务

所有任务可在 WebUI「任务面板」中管理：查看执行计划、启用/禁用、手动触发、查看历史日志。

注意：需要保持 openclacky server 运行，定时任务才能自动触发。

📖 定时任务

Channel 连接（IM 集成）

将 OpenClacky 接入飞书、企业微信或微信，在 IM 中直接与 Agent 对话。

/channel-setup

配置完成后，在 IM 中 @机器人或私聊即可使用。每个 IM 对话自动关联独立 Session。

📖 Channel 配置

浏览器自动化

内置浏览器自动化能力，可以控制 Chrome/Edge 执行登录、抓取、表单填写、UI 操作等复杂任务。

首次使用前运行 /browser-setup 完成配置，之后直接描述需求即可：

打开 GitHub，截图保存到桌面

📖 浏览器自动化工具

项目规则文件（.clackyrules）

在项目根目录创建 .clackyrules，定义技术栈、代码规范、常用命令等约定，让 Agent 充分理解你的项目背景。

每次在该目录启动时自动加载，无需重复说明。

📖 项目规则文件

品牌方 Skill（授权 Skill）

企业或创作者可以将专业能力打包成授权 Skill，分发给购买方使用。

激活授权：点击 WebUI 右上角「设置（⚙）」→「授权激活」→ 输入密钥激活。激活后自动跳转到「品牌技能」标签页，点击「安装」下载到本地即可使用。

除授权 Skill 外，「技能商店」标签页还提供无需授权的公开 Skill。

创建自定义 Skill

将你的特定工作流程封装成 Skill，复用或分享给他人。

/skill-creator

Agent 会引导你描述需求、编写指令、测试和优化。创建完成后也可以发布到 OpenClacky 市场。

📖 Skill 基础概念 · 发布到市场

CLI 终端模式

如果你更习惯在终端工作，直接运行 openclacky 即可进入对话模式，无需启动服务器。

openclacky

几个常用操作：

  • /config — 配置模型和 API Key
  • /xxx — 调用指定 Skill
  • Shift+Tab — 切换 L3（半自动）/ L4（全自动）模式
  • exit 或 Ctrl+C — 退出

CLI 模式支持所有工具和 Skill，与 Web UI 共享同一套配置和记忆系统，是喜欢键盘流的深度用户的首选方式，也是 Claude Code 的开源平替。

📖 CLI 命令参考

快速使用建议

新手路径：安装启动 → 配置 API Key（/config）→ 尝试对话 → 探索 Skill → 配置浏览器 → 创建定时任务

进阶用法：定义 .clackyrules → 连接 IM → 创建自定义 Skill → 发布 Skill 到市场

深度用户：直接用 CLI 模式，融入日常终端工作流

常见问题

Q: 会话保存在哪里？

A: ~/.clacky/sessions/，服务器重启后自动恢复。

Q: 如何节省 Token 费用？

A: 内置智能压缩和 Prompt Caching，长对话场景下自动优化。

Q: 定时任务在电脑休眠时会执行吗？

A: 不会，需要保持 openclacky server 运行且电脑处于唤醒状态。

Q: 支持哪些 LLM 提供商？

A: OpenAI、Anthropic、DeepSeek、MiniMax、OpenRouter 等。详见 模型与 API 配置。

📖 更多问题：常见问题 FAQ

下一步

为什么选 OpenClacky？
Mac / Windows / Linux 安装