智能助手OS Copilot使用说明

自定义配置

用户可以通过以下方式自定义模型调用，MCP Server 接入。

# 使用说明:
# 1. 将此文件复制到默认路径: ~/.copilot_tool/config.toml
#    或者
# 2. 将此文件复制到任意位置，并设置环境变量 OS_COPILOT_CONFIG_PATH 指向该文件路径

# 用于一般的对话和任务
[default]
model_name = "qwen3-max"  
[default.generate_kwargs]
temperature = 0.2
max_tokens = 2000
top_p = 0.5

# 用于code型任务
[code]
model_name = "qwen3-coder-plus"
[code.generate_kwargs]
temperature = 0.1
max_tokens = 4000
top_p = 0.5


# MCP (Model Context Protocol) 配置
[[mcp]]
name = "mcp_tool_1"               # MCP 服务器名称
transport = "streamable_http"     # 传输协议 'streamable_http' 或 'sse'
url = ""                          # MCP 服务地址
# timeout = 30                    # 可选:连接超时时间 (秒)
# sse_read_timeout = 300          # 可选:SSE 读取超时时间 (秒)
# headers = { }                   # 可选:自定义请求头

# 示例：添加第二个 MCP 服务
[[mcp]]
name = "mcp_tool_2"
transport = "streamable_http"
url = ""

单命令模式

单命令模式是指copilot或者co命令后面直接跟问题描述，命令执行完成即退出，如下图所示。

单命令模式支持的参数

# co --help
usage: copilot [-h] [-v] [--mode MODE] [--task] [-f FILE] [prompt ...]

OS Copilot: An OS assistant using LLM technique

positional arguments:
  prompt                input the prompt (your query about Linux OS), or keep it empty to enter interactive mode

options:
  -h, --help            show this help message and exit
  -v, -V, --version     show version info and exit
  --mode MODE, -m MODE, -M MODE
                        specify the MODE to use (optional). available MODE: chat, task, aliyun, codesum, codegen
  --task, -t, -T        task mode(can use mcp tools),automatically identify and execute tasks
  -f FILE, --file FILE  get prompt from the FILE

• 重点参数说明

  参数	参数说明	示例
  -t	进入task模式，使得 OS Copilot 自动编排工作流，并调用子 agent 完成任务	co 当前系统健康度 -t
  -f	从文件中读取内容或定义复杂任务进行处理。	co -f task -t。详见视频操作使用文件定义复杂的任务。
  |	使用管道	cat /etc/sysctl.conf | co 解释下这些参数的含义

• 重点工具及功能说明

  OS Copilot已集成软件管理、命令检查与执行、文件读写以及阿里云CLI等插件工具，将通过以下示例进行说明。

  • 知识问答

    

  • 简单命令/脚本生成与执行

    

  • 软件管理

    • 

    • 

  • 多步骤任务执行

    • 

    • 

    • 

  • 文件读写

    说明

    分析的日志不要超过100行，容易超出最长token限制。

    

  • 阿里云CLI

    1. 安装aliyun-cli软件。

       说明

       本文以Alibaba Cloud Linux 3系统安装阿里云CLI为例，其他系统若需要安装阿里云CLI，具体操作，请参见安装CLI（Linux）。

       sudo dnf install aliyun-cli -y

    2. 使用AK/SK配置aliyun权限。

       aliyun configure

       如下图所示，配置相关信息。

       

    3. 使用Copilot调用aliyun cli示例如下。

       

问号指令

问号指令是指在用户遇到命令执行错误的情况下，可以通过输入?或why命令来唤醒OS Copilot，以对错误进行解释并尝试修复，从而提供正确的命令。

执行source /etc/os-copilot/fix_command_config.sh配置。

交互模式

• 执行copilot或co命令进入交互模式，默认进入Chat模式。可执行多轮交互。

• 执行exit、quit指令或ctrl + d、ctrl + c快捷键退出交互模式。

返回参数解释如下：

• CHAT：默认的聊天模式，可以使用chat命令切换到此模式，该模式下若 Copilot 输出了shell 命令，用户可以选择对应编号自动执行对应命令。

• TASK：任务编排模式，通过自然语言理解用户意图，拆解子任务分配给子 agent 执行。可以使用task命令切换到此模式。

• CODEGEN：按照指示自动生成代码，可以使用codegen命令切换到此模式。

• CODESUM：读取本地代码片段文件，自动分析代码摘要，可以使用codesum命令切换到此模式。

• ALIYUN：调用aliyun cli执行运维操作，可以使用aliyun命令切换到此模式。