> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> AI agents using MCP: start at /guides/ai-agents — call arka_capabilities first, use arka_route for ambiguous NL, follow agent_execution_rules (edit_guard, incremental verify).
> Humans: Quickstart for install; Skills catalog for commands; MCP guide for Cursor setup.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# 配置

> 安全、感知硬件的 Arka 默认设置与首次运行配置。

在不写入任何内容的前提下预览推荐配置：

```bash theme={null}
arka setup --configure --json
```

显式应用它：

```bash theme={null}
arka setup --configure --apply
```

该配置文件是本地优先且感知硬件的。它偏好可运行的本地后端，保持符号路由
优先，启用回退和本地内存，并对高风险写入要求预览。缺失的云凭据被视为
正常的回退条件；设置过程绝不会创建或复制密钥。

只查看或重置 Arka 所管理的配置：

```bash theme={null}
arka config show --json
arka config reset
```

环境变量和项目 `.env` 中的值优先于托管默认值。应用配置文件时会保留已有
的值。

## 分享配置

导出一份可移植、可安全分享的包：

```bash theme={null}
arka config share export --out arka-config-share.json
```

该包包含托管默认值、模型/服务提供商偏好，以及选定的非敏感环境值。API
密钥、token、密码、Cookie、Webhook 密钥和其他凭据绝不会被导出；它们会
在 `required_env` 下列出，接收方就知道需要在本地填写哪些值。

除非传入 `--apply`，否则导入仅为预览：

```bash theme={null}
arka config share import arka-config-share.json --json
arka config share import arka-config-share.json --apply
```

自然语言也可以："share my Arka config" 会路由到分享导出。


## Related topics

- [使用 Supermemory 同步的长期记忆](/cn/guides/memory.md)
- [通过 OAuth 连接 Gmail 和 Google 日历](/cn/guides/google-workspace.md)
- [生成音乐](/cn/guides/generate-music.md)
- [自动 MCP 配置](/cn/guides/mcp-auto.md)
- [配置、环境变量与 API 密钥设置](/cn/reference/configuration.md)