Configuration Manual

Complete reference for every configuration key in config.yaml. Structure follows the file layout.

Top-Level Keys

bots (required)

Map of bot IDs to bot configurations. Each key under bots is a bot ID used as the runtime identifier.

bots:
  engineering_bot:
    # bot config...
  support_bot:
    # bot config...

log_level

Structured log level for the entire process.

log_file

Log file path with daily rotation. Empty uses the default.

log_max_size_mb

Maximum log file size in megabytes before rotation.

log_max_backups

Maximum number of rotated log files to retain.

log_max_age_days

Maximum days to keep rotated log files.

log_compress

Whether to gzip rotated log files.

bots.<id>

Each bot is identified by its key and configured with the following fields.

name

Display name used in prompts and status cards. Defaults to the bot ID.

feishu_app_id (required)

Feishu Open Platform App ID (cli_...).

feishu_app_secret (required)

Feishu Open Platform App Secret. Keep this value secure.

feishu_base_url

Feishu API base URL. Use "https://open.larksuite.com" for Lark (international edition).

Runtime Directories

alice_home

Bot-specific runtime root directory. All per-bot state lives under this path.

workspace_dir

Agent workspace directory. This is the working directory for LLM subprocesses.

prompt_dir

Directory for bot-specific prompt template overrides. Files here override embedded templates.

codex_home

Codex configuration and authentication directory. Shared across bots by default unless overridden here.

soul_path

Path to the SOUL.md persona document. Relative paths resolve against alice_home. If the file doesn't exist at startup, Alice writes the embedded template.

Message Trigger (Legacy)

trigger_mode

Legacy trigger mode. Only used when both group_scenes.chat.enabled and group_scenes.work.enabled are false.

trigger_prefix

Prefix string for trigger_mode: "prefix".

llm_profiles

Map of profile names to LLM profile configurations. Each profile selects a provider, model, and settings.

Profile Fields

provider (required)

LLM backend provider.

command

Path or name of the CLI binary. Use an absolute path for binaries outside $PATH.

timeout_secs

Per-run timeout in seconds.

model (required)

Model identifier. Examples: "deepseek/deepseek-v4-pro", "gpt-5.4-mini", "claude-sonnet-4-6".

variant (OpenCode only)

Model variant for DeepSeek models via OpenCode.

profile (Codex only)

Named sub-profile from Codex CLI configuration.

reasoning_effort (Codex only)

Thinking intensity level.

personality (Codex only)

Named personality preset from Codex CLI config.

prompt_prefix

Text prepended to every prompt before sending to the model.

permissions

Sandbox and approval settings.

permissions.sandbox

Filesystem access level for the LLM agent.

permissions.ask_for_approval

When the agent should ask for approval before executing tool calls.

permissions.add_dirs

Extra directories accessible to the agent beyond the workspace.

profile_overrides

Advanced: per-profile runner overrides. Keys are profile names. Each override can set:

• command — binary path override
• timeout — timeout override (seconds)
• provider_profile — provider-specific profile name
• exec_policy — per-override sandbox and approval settings

env

Environment variables passed to all LLM subprocesses. Useful for PATH, proxy settings (HTTPS_PROXY, ALL_PROXY), and API keys.

Reply Messages

failure_message

Message shown when the LLM backend fails.

thinking_message

Message shown in the progress card while the LLM is processing.

Immediate Feedback

immediate_feedback_mode

How Alice acknowledges a received message before the LLM responds.

immediate_feedback_reaction

Feishu emoji name for the reaction feedback (e.g., "OK", "WINK", "THUMBSUP").

group_scenes

group_scenes.chat

Chat scene configuration for group / topic-group chats.

enabled

session_scope

llm_profile

Name of the LLM profile under llm_profiles to use.

no_reply_token

If the model returns this exact string, Alice stays silent.

create_feishu_thread

Whether to create a Feishu thread for replies.

group_scenes.work

Work scene configuration for group / topic-group chats.

enabled

trigger_tag

Tag required in the message (after @bot mention) to trigger work mode.

session_scope

llm_profile

create_feishu_thread

no_reply_token

private_scenes

Same structure as group_scenes. Both chat and work sub-sections are disabled by default.

private_scenes.chat

Additional session scope: "per_user" — all DM messages from the same user share one session.

private_scenes.work

Additional session scope: "per_message" — each DM with #work creates a fresh session.

Runtime HTTP API

runtime_http_addr

Listen address for the runtime HTTP API. Multi-bot setups auto-increment the port (7332, 7333, ...).

runtime_http_token

Bearer token for API authentication. Auto-generated if empty. Set explicitly for cross-process calls.

permissions

runtime_message

Allow bundled skills to send messages via the runtime API.

runtime_automation

Allow bundled skills to manage automation tasks via the runtime API.

allowed_skills

Bundled skills enabled for this bot. Built-in skills: alice-message, alice-scheduler, alice-goal.

Worker Pool

queue_capacity

Maximum pending jobs. Beyond this, new messages are dropped.

worker_concurrency

Number of concurrent workers processing jobs.

Timeouts

All values in seconds.

automation_task_timeout_secs

Outer timeout for scheduled automation and workflow runs.

auth_status_timeout_secs

Timeout for provider auth status checks on startup.

runtime_api_shutdown_timeout_secs

Grace period when shutting down the runtime HTTP API server.

local_runtime_store_open_timeout_secs

Timeout for opening the local BoltDB runtime store on startup.

codex_idle_timeout_secs

Codex idle timeout for default/medium reasoning effort.

codex_high_idle_timeout_secs

Codex idle timeout for high reasoning effort.

codex_xhigh_idle_timeout_secs

Codex idle timeout for xhigh reasoning effort.

Display Options

show_shell_commands

Show recently executed shell commands in the heartbeat status card.

disable_identity_hints

When true, messages are sent to the LLM as raw text without identity context (Name说：, @mention rules). When false (default), identity hints are included.