GoClaw：基于GO语言开发的开源AI智能体框架

一、GoClaw是什么

GoClaw（昵称狗爪）是一款基于Go语言开发的开源AI智能体（AI Agent）执行框架，核心定位为OpenClaw的Go语言重构实现，主打本地私有化部署、单二进制免依赖、高性能稳定运行，是连接大语言模型（LLM）与现实世界工具、消息渠道的轻量化执行网关。

它摒弃了Python生态的依赖繁琐问题，编译后为单一可执行文件，可在Linux、macOS、Windows全平台直接运行，通过WebSocket/HTTP暴露服务接口，支持Telegram、WhatsApp、飞书、QQ、钉钉、Slack等主流即时通讯渠道接入，让AI智能体具备文件读写、命令执行、网页请求、浏览器自动化、定时任务等真实世界交互能力，同时兼容OpenClaw技能生态，可直接复用现有技能扩展能力。

GoClaw面向个人开发者、运维人员、中小企业技术团队，既可以作为个人AI数字助手完成日常自动化任务，也可作为企业级AI执行网关部署私有化智能体，实现数据不出本地、任务可观测、执行可审计的安全AI应用。

二、功能特色

1. 极致部署与跨平台能力

• 单二进制文件：编译后仅一个可执行文件，无npm、pip等依赖，拷贝即可运行

• 全平台适配：支持Linux、macOS、Windows，无环境配置门槛

• 轻量化运行：内存占用低，启动速度快，适合服务器、本地电脑、边缘设备部署

2. 完整工具调用系统

内置30+常用工具，覆盖AI智能体核心执行场景：

• 文件系统工具：文件创建、读取、写入、删除、遍历、搜索

• 命令行工具：Shell命令执行、脚本运行，支持Docker沙箱隔离

• 网络工具：HTTP/HTTPS请求、网页抓取、API调用

• 浏览器工具：基于Chrome DevTools Protocol实现页面自动化、截图、数据提取

• 系统工具：进程监控、资源查询、定时任务调度

3. 兼容OpenClaw技能生态

• 支持Markdown格式编写SKILL.md技能文件，零代码扩展能力

• 技能按优先级加载：当前目录 > 工作区目录 > 全局目录，同名技能自动覆盖

• 支持环境准入校验，仅系统满足依赖（如安装curl、python）时加载对应技能

• 内置技能管理CLI，可快速列出、校验、加载技能

4. 多渠道消息接入

支持10+主流通讯平台，无需二次开发即可对接：

• 海外渠道：Telegram、WhatsApp、Discord、Slack、Microsoft Teams

• 国内渠道：飞书、钉钉、企业微信、QQ、微信公众号

• 自定义渠道：通过WebSocket/HTTP接口接入私有IM系统

5. 可靠会话与记忆能力

• 基于JSONL实现会话持久化，完整记录工具调用链，支持断点恢复

• 支持向量数据库与全文检索（FTS）记忆存储，智能关联历史上下文

• 会话隔离机制，不同用户/渠道数据独立，避免上下文污染

6. 多LLM兼容与故障转移

• 支持OpenAI、Anthropic、百度千帆、OpenRouter等20+LLM提供商

• 内置故障转移、熔断器、重试机制，LLM服务异常时自动切换备用节点

• 支持流式输出、Token预算控制，优化推理成本与响应速度

7. 企业级安全与可观测性

• 沙箱隔离：命令执行支持Docker容器隔离，防止恶意操作

• 细粒度权限：可限制工具调用范围、文件访问路径、网络请求域名

• 执行审计：完整记录工具调用日志、命令参数、执行结果，可追溯

• 配置热加载：修改配置文件无需重启服务，自动生效

8. 定时任务与多Agent调度

• 支持cron、at、every三种定时语法，实现周期性自动化任务

• 支持多Agent协作、任务委托、接力执行，复杂任务拆分处理

• 内置WebSocket网关，支持实时通信与远程控制

三、技术细节

1. 架构设计

GoClaw采用模块化解耦架构，核心分为8大模块：

goclaw/
├── agent/   # 智能体核心逻辑：思考-执行-观察循环
├── tools/   # 工具注册与执行引擎
├── channels/  # 多消息渠道适配层
├── cli/    # 命令行交互工具
├── config/   # 配置解析与热加载
├── session/  # 会话持久化管理
├── gateway/  # WebSocket/HTTP服务网关
└── providers/ # LLM提供商适配层

2. 核心技术栈

• 开发语言：Go 1.21+，利用协程实现高并发，内存安全无GC卡顿

• 配置文件：支持YAML/JSON，环境变量（GOSKILLS_*）优先级覆盖

• 存储方案：本地JSONL会话存储，可选对接PostgreSQL、向量数据库

• 浏览器自动化：Chrome DevTools Protocol（CDP），无额外浏览器依赖

• 沙箱技术：Docker容器隔离，支持Linux Namespace权限限制

3. 技能加载机制

加载优先级（从低到高）：

1. ~/.goclaw/skills/（全局技能）

2. ${WORKSPACE}/skills/（工作区技能）

3. ./skills/（当前目录技能，最高优先级）

技能文件格式示例：

---
name: file-backup
description: 自动备份指定目录文件
metadata:
  openclaw:
    requires:
      bins: ["tar", "gzip"]
---
# 文件备份技能
当用户触发备份指令时，调用filesystem工具遍历目录，使用tar命令打包压缩，保存至备份文件夹。

4. 配置加载规则

1. 全局配置：~/.goclaw/config.json
2. 本地配置：./config.json
3. 环境变量：GOSKILLS_* 前缀配置，覆盖文件配置
4. 命令行参数：--config 指定配置文件，优先级最高

5. 执行流程

1. 消息接收：渠道模块接收用户指令

2. 意图解析：LLM分析指令，匹配对应技能

3. 任务规划：智能体拆解任务，选择工具调用序列

4. 工具执行：调用对应工具，沙箱隔离执行

5. 结果反馈：整合执行结果，通过渠道返回用户

6. 会话记录：保存执行链路，支持后续恢复

四、应用场景

1. 个人AI数字助手

• 自动整理文件、备份数据、重命名批量文件

• 定时发送消息、提醒日程、爬取新闻资讯

• 自动化办公：生成报表、发送邮件、处理表格数据

2. 运维自动化Agent

• 服务器监控：定时检查CPU/内存/磁盘，异常告警

• 日志分析：自动抓取日志，关键词检索，生成报告

• 部署自动化：执行编译、上传、重启等运维命令

• 备份恢复：定时备份数据库，故障时自动恢复

3. 企业私有化客服机器人

• 对接企业微信/钉钉/飞书，自动回复常见问题

• 调用内部API查询订单、物流、员工信息

• 多轮对话引导，完成工单提交、问题上报

• 数据本地存储，符合企业隐私合规要求

4. 内容创作与数据采集

• 自动爬取网页数据，清洗整理生成文档

• 浏览器自动化截图、提取商品信息、舆情监测

• 批量生成文案、摘要、翻译内容

• 社交媒体自动发布、评论回复

5. 教育与科研辅助

• 自动收集文献资料，整理参考文献

• 运行实验脚本，记录实验数据，生成图表

• 编程教学：自动执行代码，反馈运行结果

• 语言学习：对话交互、语法检查、翻译辅导

6. 智能家居控制

• 对接Home Assistant，控制灯光、空调、传感器

• 定时执行家居场景，如起床模式、睡眠模式

• 语音指令转化为设备控制命令

五、使用方法

1. 安装部署

# 下载安装脚本
curl -sSL https://goclaw.org/install.sh | bash

# 或手动编译
git clone https://github.com/smallnest/goclaw.git
cd goclaw
go build -o goclaw main.go

2. 基础配置

创建config.json配置文件，填写LLM密钥与渠道信息：

{
 "provider": "openai",
 "model": "gpt-3.5-turbo",
 "api_key": "sk-xxx",
 "channels": {
  "feishu": {
   "app_id": "xxx",
   "app_secret": "xxx"
  }
 }
}

3. 常用CLI命令

# 启动网关服务
./goclaw gateway

# 列出所有可用技能
./goclaw skills list

# 校验技能语法
./goclaw skills check

# 添加智能体
./goclaw agent add

# 查看会话记录
./goclaw session list

4. 技能扩展

1. 在./skills/目录创建技能文件夹

2. 编写SKILL.md技能描述文件

3. 执行./goclaw skills reload加载技能

4. 直接在对话中触发技能执行

5. 渠道接入

以飞书为例：

1. 注册飞书开放平台应用，获取AppID与AppSecret

2. 在config.json配置飞书渠道参数

3. 启动服务，添加飞书机器人好友

4. 直接发送指令即可调用AI智能体

六、竞品对比

七、常见问题解答

GoClaw与OpenClaw的核心区别是什么？

GoClaw是OpenClaw的Go语言重构版本，解决了原项目Python依赖复杂、运行性能一般、部署繁琐的问题，同时保留完整技能兼容性，单二进制文件可直接运行，稳定性与并发能力更强。

GoClaw是否需要联网才能运行？

基础文件操作、本地命令执行可离线运行；LLM对话、网页抓取、渠道消息收发需要联网，支持本地部署LLM实现完全离线。

如何解决命令执行的安全风险？

GoClaw内置Docker沙箱隔离，可限制文件访问路径、网络请求范围，关闭高危工具调用，同时完整记录执行日志，降低安全风险。

技能文件编写失败如何排查？

使用./goclaw skills check命令校验语法，检查metadata字段格式、依赖命令是否安装，确认技能目录权限是否正常。

支持哪些大语言模型？

原生支持OpenAI、Anthropic、百度千帆、OpenRouter等20+提供商，所有兼容OpenAI API格式的LLM均可接入。

Windows系统如何部署运行？

下载Windows版本可执行文件，创建config.json配置文件，双击运行或在PowerShell执行./goclaw gateway启动服务。

会话数据存储在哪里，如何备份？

默认存储在~/.goclaw/sessions/目录的JSONL文件中，直接复制该目录即可完成备份，恢复时放回原路径即可。

是否支持多用户同时使用？

支持多渠道、多用户会话隔离，不同用户的对话上下文、技能调用、执行记录相互独立，不会干扰。

八、相关链接

• GitHub仓库：https://github.com/smallnest/goclaw

• 官方文档：https://goclaw.org/docs

九、总结

GoClaw作为smallnest基于Go语言重构的开源AI智能体执行框架，以单二进制免依赖、高性能跨平台、全渠道接入、完整工具链、兼容OpenClaw生态为核心优势，填补了轻量化本地AI Agent部署的市场空白，既降低了普通用户搭建个人AI助手的门槛，又满足了中小企业私有化部署、安全可控的需求，通过简洁的配置、丰富的内置能力、可靠的执行机制，让AI智能体真正具备落地执行现实任务的能力，是个人自动化、运维效率提升、企业客服私有化的优质开源选择。