配置

为你的环境配置 AgenticX。

配置

AgenticX 使用 ~/.agenticx/config.yaml 作为全局配置文件。

全局配置

yaml

1# ~/.agenticx/config.yaml
2
3# Default LLM provider
4default_provider: openai
5default_model: gpt-4o
6
7# Runtime settings
8AGX_MAX_TOOL_ROUNDS: 20
9
10# Studio server
11studio:
12  host: 0.0.0.0
13  port: 8000
14
15# Memory settings
16memory:
17  backend: sqlite   # sqlite | redis | postgresql
18  path: ~/.agenticx/workspace

供应商配置

可在配置文件中或通过环境变量配置 LLM 供应商：

OpenAI

yaml

1providers:
2  openai:
3    api_key: ${OPENAI_API_KEY}
4    default_model: gpt-4o

Anthropic

yaml

1providers:
2  anthropic:
3    api_key: ${ANTHROPIC_API_KEY}
4    default_model: claude-3-5-sonnet-20241022

Ollama（本地）

yaml

1providers:
2  ollama:
3    base_url: http://localhost:11434
4    default_model: llama3.2

MiniMax

yaml

1providers:
2  minimax:
3    api_key: ${MINIMAX_API_KEY}
4    default_model: minimax-m1

环境变量

变量	说明	默认值
`OPENAI_API_KEY`	OpenAI API 密钥	—
`ANTHROPIC_API_KEY`	Anthropic API 密钥	—
`AGX_MAX_TOOL_ROUNDS`	每轮智能体最大工具调用次数	`20`
`AGX_CHROMIUM_QUIET`	Desktop 中抑制 Chromium 日志	`false`

工作区与身份

智能体身份与记忆存储在 ~/.agenticx/workspace/。每个分身拥有独立子目录，存放会话历史、记忆与上下文文件。

扩展与技能市场

为技能市场配置扩展注册源与本地扫描目录：

yaml

1extensions:
2  registries:
3    - name: official
4      url: https://registry.agxbuilder.com
5      type: agx                          # AgenticX native registry
6    - name: clawhub
7      url: https://clawhub.ai/api
8      type: clawhub                      # ClawHub skills market
9  scan_dirs:
10    - ~/.agenticx/bundles
11    - ~/.agenticx/skills/registry

AGX Bundles 与市场使用的完整说明请参阅扩展与技能生态。

项目级配置

如需按项目单独配置，在项目根目录创建 agenticx.yaml：

yaml

1organization_id: my-org
2default_llm:
3  provider: openai
4  model: gpt-4o-mini
5tools:
6  mcp_servers:
7    - name: filesystem
8      command: npx
9      args: ["-y", "@modelcontextprotocol/server-filesystem", "."]