配置文件位于 .omniagent/config.yaml，社区版用户可在此配置 API Key、代理及工作目录等高级选项

谁需要看这份文档？

专业版用户通常无需手动编辑此文件，API 由平台自动配置。社区版用户需自行填写 API Key，除在客户端「系统设置」中填写外，也可直接编辑本配置文件。高级用户可通过本文件调整工作目录、代理、安全策略等。

配置文件位置

操作系统	配置路径
Windows	`C:\Users\用户名\.omniagent\config.yaml`
macOS	`~/.omniagent/config.yaml`
Linux	`~/.omniagent/config.yaml`

完整配置示例


# 通用设置
general:
  language: zh-CN           # 界面语言
  theme: auto              # 主题: light, dark, auto
  startWithSystem: true    # 开机自启动
  minimizeToTray: true     # 最小化到托盘

# AI 模型配置
ai:
  provider: openai         # 默认提供商
  
  openai:
    apiKey: sk-xxx
    baseUrl: https://api.openai.com/v1
    model: gpt-4-turbo-preview
    temperature: 0.7
    maxTokens: 4096
  
  ollama:
    host: http://localhost:11434
    model: llama3.3
  
  deepseek:
    apiKey: sk-xxx
    model: deepseek-chat

# 工作目录
paths:
  workspace: ~/OmniAgent/Workspace
  logs: ~/OmniAgent/Logs
  plugins: ~/OmniAgent/Plugins
  temp: ~/OmniAgent/Temp

# 日志配置
logging:
  level: info              # debug, info, warn, error
  maxFiles: 7              # 保留天数
  maxSize: 10MB            # 单文件大小限制

# 安全设置
security:
  confirmBeforeExecute: true     # 执行前确认
  allowedPaths:                   # 允许访问的路径
    - ~/Documents
    - ~/Downloads
    - ~/Desktop
  blockedPaths:                   # 禁止访问的路径
    - /System
    - C:\Windows

# 快捷键
hotkeys:
  activate: Ctrl+Shift+O         # 激活窗口
  quickCommand: Ctrl+Shift+Space # 快速命令
  screenshot: Ctrl+Shift+S       # 截图

# 网络设置
network:
  proxy:
    enabled: false
    type: http               # http, socks5
    host: 127.0.0.1
    port: 7890
  timeout: 30000             # 请求超时 (毫秒)

# 插件设置
plugins:
  autoUpdate: true           # 自动更新插件
  marketplace: https://market.omniagent.cc

常用配置项

AI 模型配置

ai:
  provider: openai
  openai:
    apiKey: sk-your-api-key
    baseUrl: https://api.openai.com/v1
    model: gpt-4-turbo-preview
    temperature: 0.7

请妥善保管您的 API Key，不要分享给他人或提交到代码仓库。

ai:
  provider: ollama
  ollama:
    host: http://localhost:11434
    model: llama3.3

使用本地模型时，请确保 Ollama 服务已启动：

ollama serve

ai:
  provider: deepseek
  deepseek:
    apiKey: sk-your-deepseek-key
    model: deepseek-chat

DeepSeek 提供高性价比的中文模型，推荐国内用户使用。

代理配置

如果您需要通过代理访问 API：

network:
  proxy:
    enabled: true
    type: http
    host: 127.0.0.1
    port: 7890
    # 如果需要认证
    username: user
    password: pass

安全配置

重要

强烈建议保持 confirmBeforeExecute: true，避免意外执行危险操作。

security:
  confirmBeforeExecute: true
  allowedPaths:
    - ~/Documents
    - ~/Downloads
  blockedPaths:
    - /System
    - C:\Windows
    - ~/.*           # 隐藏文件夹

环境变量

除了配置文件，您还可以通过环境变量覆盖某些设置：

环境变量	说明
`OMNIAGENT_CONFIG`	自定义配置文件路径
`OMNIAGENT_LOG_LEVEL`	日志级别
`OPENAI_API_KEY`	OpenAI API Key
`DEEPSEEK_API_KEY`	DeepSeek API Key
`HTTP_PROXY`	HTTP 代理地址

重置配置

如需恢复默认配置：

# 备份当前配置
mv ~/.omniagent/config.yaml ~/.omniagent/config.yaml.bak

# 重新启动 OmniAgent 会自动生成默认配置

配置指南