GenericAgent OnePage指南
输入“/”快速插入内容
GenericAgent OnePage指南
GenericAgent OnePage指南
用户9750用户9750
用户219用户219用户567用户567用户995用户995用户6975用户69754月7日修改
🌷
欢迎大家体验GenericAgent 🎉🎉 本文档以图文的形式快速介绍 GenericAgent 的基本使用方式，你可以了解 GenericAgent 以及最小使用方法，帮助你快速上手并开始使用 GenericAgent 构建自己的 Agent。主要包括以下内容，大家可以按照右边的目录直接跳转到自己感兴趣的部分：
•
什么是 GenericAgent？
•
5 分钟快速开始
•
基础使用：GA的常见用法示例
•
进阶使用：借助强大的 Skill
•
将GA接入聊天平台（可选）
😇 如果在操作过程中，有遇到任何问题，欢迎评论提问题；同样，如果您还需要我们补充其他更多的使用方法，也可以评论，我们会持续完善这个文档～
🧐 什么是 GenericAgent？
GenericAgent （GA） 是一个极简（约3300行核心代码）、自进化的自主智能体框架。它通过7个原子工具和92行主循环，赋予大模型对本地计算机的系统级控制能力（包括浏览器、终端、文件、键鼠、屏幕视觉、安卓设备等）。其核心特点是：每次完成新任务后，会自动将执行路径“结晶”为可复用的技能，长期使用会形成用户专属的技能树。
🚀 5 分钟快速开始
第一步：安装部署
总的来说只需两步：安装python、安装GA
1.
安装 Python 3.10+
◦
windows用户：GA项目中存在自动化安装 python 脚本，双击即可自动安装（windows 用户）
◦
Mac用户： 打开 终端(启动台搜索 终端 或者 Terminal )
复制这句命令到终端
brew install python
▪
如果提示 brew: command not found, 需要先安装Homebrew：
复制粘贴下面的命令来执行安装命令：
代码块
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，它通常会提示你执行一行命令（非常关键！），类似：
代码块
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
代码块
安装完python运行 pip install requests/ pip3 install requests
只需要python（3.10-3.13版本）+ requests库即可运行命令行模式（agentmain.py）
2.
下载并安装 GenericAgent 项目
🎊 方法一：在 GitHub 上复制 web URL，命令行 git clone
代码块
# 1. Clone the repo
git clone https://github.com/lsdefine/GenericAgent.git
cd GenericAgent
🥁 方法二：直接下载 .zip 压缩文件
第二步：配置 API Key
你需要有当前主流大模型的api key，具体购买方式以及渠道大家自行选择即可
配置 API Key
1.
重命名项目文件夹中的 mykey.py
复制一份 mykey.py
把 项目文件中的 mykey_template.py 重命名为 mykey.py
# Edit mykey.py and fill in your LLM API Key
2.
进入 mykey.py 配置 API Key
在 mykey.py 里配置 API Key, base url, model
oai_config = {
'apikey':'Your-API-Key', # 此处填写API Key
'apibase':'http://api.example.com:3001', # 此处填写 base url，openai的base url后自动接"/v1/completion"
'model':"openai/gpt-5.1" # 此处填写模型名称，注意名称要与供应商提供的名称完全一致（大小写等）
}
claude_config = {
'apikey':'Your-API-Key',
'apibase':'http://api.example.com:3001',
'model':"claude-opus-4-6-20260206"
}
# or
sider_cookie = 'token=Bearer%20eyJhbGciOiJIUz...'
# feel free to add more ~
oai_config2 = {
'apikey':'Your-API-Key',
'apibase':'http://api.example.com:3001',
'model':"openai/gpt-5.2"
}
claude_config2 = {
'apikey': 'Your-API-Key',
'apibase': 'http://api.example.com:3001',
'model': 'claude-sonnet-4-5-20250929'
}
# If you need them
# tg_bot_token = '84102K2gYZ...'
# tg_allowed_users = [6806...]
# proxy = "http://127.0.0.1:2082"