PicoBot/resources/skills/about-picobot/references/config.md

PicoBot 配置说明

配置文件加载顺序：~/.picobot/config.json → 当前目录 ./config.json。 占位符 <VAR_NAME> 从环境变量替换，环境变量从 .env 文件或系统环境读取。

config.json 结构

{
  "providers": {},    // LLM 提供商配置
  "models": {},       // 模型配置
  "agents": {},       // agent 配置
  "gateway": {},      // 网关配置
  "client": {},       // 客户端配置
  "channels": {},     // 渠道配置
  "memory": {},       // 记忆系统配置
  "workspace_dir":    // 工作目录，默认 ~/.picobot/workspace
  "mcp": {}           // MCP 服务器配置
}

完整示例见 assets/config.example.json。

providers 字段

字段	说明
type	提供商类型: openai（兼容 OpenAI API）、anthropic
base_url	API 端点地址
api_key	API 密钥，支持 <ENV_VAR> 占位符
extra_headers	额外 HTTP 头

models 字段

字段	说明
model_id	模型标识名称
temperature	采样温度，可选
max_tokens	最大输出 token 数，可选
input_type	模型支持的输入类型，如 ["text"] 或 ["text", "image"]，默认 ["text"]. 纯内部使用，不会传递给 LLM API

agents 字段

字段	类型	默认	说明
provider	string	-	提供商名称（对应 providers key）
model	string	-	模型名称（对应 models key）
max_tool_iterations	int	99	最大工具调用轮数
token_limit	int	128000	上下文 token 限制

gateway 字段

字段	类型	默认	说明
host	string	127.0.0.1	监听地址
port	int	19876	监听端口
session_ttl_hours	int	-	会话过期小时数
session_db_path	string	-	SQLite 数据库路径，默认在 workspace 下
cleanup_interval_minutes	int	-	清理间隔
scheduler	object	-	调度器配置

memory 字段

字段	类型	默认	说明
consolidation_provider	string	-	记忆归并 LLM 提供商
consolidation_model	string	-	记忆归并 LLM 模型
recall_limit	int	5	每轮注入的知识记忆条数
idle_consolidation_minutes	int	10	空闲后触发归并的分钟数
timeline_retention_days	int	90	时间线记忆保留天数
max_failures_before_degrade	int	3	归并失败次数阈值

channels.feishu 字段

字段	类型	默认	说明
enabled	bool	false	是否启用
app_id	string	-	飞书应用 ID
app_secret	string	-	飞书应用密钥
allow_from	[]string	["*"]	允许交互的用户列表
agent	string	-	使用的 agent 名称
media_dir	string	~/.picobot/media/feishu	媒体存储目录
reaction_emoji	string	"Typing"	回复意向表达的表情

mcp 字段

字段	类型	默认	说明
servers	array	[]	MCP 服务器列表
tool_timeout_secs	int	180	工具调用超时秒数

MCP 服务器单条配置:

字段	说明
name	服务器名称
transport	传输方式: Stdio、Sse、streamable-http
command	启动命令（Stdio 模式）
args	命令参数
url	URL（Sse / streamable-http 模式）
tool_timeout_secs	单独的超时设置